livescore.index
Resource information
URL | https://api.statscore.com/v2/livescore |
---|---|
Method | GET |
Description | Returns LIVE events related to competitions, seasons, stages and groups |
Cache | 30 seconds |
Authorization required | Yes |
Method parameters
Name | Type | Description |
---|---|---|
There are no method parameters in this resource |
Query parameters
Name | Type | Description |
---|---|---|
token | xsd:string | REQUIRED. There is more information concerning authorization in the API introduction section |
lang | xsd:string | Determines the language for the output data. The complete list of possible languages can be retrieved using the API resource: languages.index |
page | xsd:int | Determines offset of paginated data. Default value is 1 which means first page |
limit | xsd:int | Determines maximum number of returned records on page. Used in paginated data. Default value is 50. Possible values: 5, 10, 25, 50, 100 |
date_from | xsd:string | Selection datetime, format 'yyyy-mm-dd hh:mm:ss'. Date from which events should be returned. If you use a single date_from parameter you will receive all events that start in the 24 hours from requested date |
date_to | xsd:string | Selection datetime, format 'yyyy-mm-dd hh:mm:ss'. End date of returned events. The maximum period beetwen date_from and date_to parameter is 30 days. This rule is not valid when you use the following query parameter in your request: season_id, stage_id, group_id, participant_id |
sport_id | xsd:int | Determines the sport identifier in which the events are played. Possibility to input multiple identifiers, separated by comma. The complete list of possible sports can be retrieved using the API resource: sports.index |
area_id | xsd:int | Determines the area identifier in which the events are played. Possibility to input multiple identifiers, separated by comma. The complete list of possible areas can be retrieved using the API resource: areas.index |
competition_id | xsd:int | Determines the competition identifier in which the events are played. Possibility to input multiple identifiers, separated by comma. The complete list of possible competitions can be retrieved using the API resource: competitions.index |
season_id | xsd:int | Determines the season identifier in which the events are played. The complete list of possible seasons can be retrieved using the API resource: seasons.index |
stage_id | xsd:int | Determines the stage identifier in which the events are played. Possibility to input multiple identifiers, separated by comma. The complete list of possible stages can be retrieved using the API resource: stages.index |
group_id | xsd:int | Determines the group identifier in which the events are played. Possibility to input multiple identifiers, separated by comma. The complete list of possible groups can be retrieved using the API resource: groups.index |
participant_id | xsd:int | Determines the identifier of the participant. The complete list of possible participants can be retrieved using the API resource: participants.index |
multi_ids | xsd:string | List of events identifiers separated by a comma (e.g. 123,234,321) for which you want to get the events details. (Up to 100 ids) |
venue_type | xsd:string | Additional parameter for participant filter. Works only when participant_id query is used. Determines if the provided participant plays as the home or away team.
|
sort_type | xsd:string | Determines sort order of data. Possible values:
|
sort_order | xsd:string | Additional parameter for sort_type which determines the direction of sorting (ascending, descending)
|
status_id | xsd:string | Determines the identifier of the event status. The complete list of possible statuses can be retrieved using the API resource: statuses.index |
status_type | xsd:string | Determines the identifier of the status type. Can be comma separated string. Possible values: Possible values:
|
coverage_type | xsd:string | Determines coverage type. Possible values:
|
scoutsfeed | xsd:string | Possible values:
|
latency | xsd:string | Information about the expected latency. Possible values:
|
event_stats_lvl | xsd:string | Information about the statistics level. Possible values:
|
event_stats_lvl_live | xsd:string | Information about expected statistics level when the match is LIVE. Possible values:
|
event_stats_lvl_after | xsd:string | Information about expected statistics level after the end of the match. Possible values:
|
events_details | xsd:string | Determines if subnodes of events will be visible. Possible values:
|
competitions_details | xsd:string | Determines if parent nodes of events will be visible. Possible values:
|
item_status | xsd:string | Describes the status for the item (record). Possible values:
|
verified_result | xsd:string | Possible value:
|
product | xsd:string | Possible values:
Required with booked. |
booked | xsd:string | Possible value:
Required with product. |
tz | xsd:string | Determines timezone for the output data. The complete list of possible time zones is included in the API introduction section |
timestamp | xsd:unix_timestamp | Selection date, format UNIX_TIMESTAMP. Only changes in events that occurred or were updated after this timestamp will be returned. |
Method calling examples
Link | Description |
---|---|
https://api.statscore.com/v2/livescore?token={{YOUR_TOKEN}} | Returns a list of all in progress (live) events in JSON format |