Resource information
| URL | https://api.softnetsport.com/v2/livescore |
|---|---|
| XSD | https://api.softnetsport.com/assets/API/docs/xsd/livescore.index.xsd |
| Method | GET |
Description | Returns the LIVE events related with competitions, seasons, stages and groups |
| Package | This resource is included in the LIVESCORE package |
| Cache | |
| Authorization required | Yes |
Method parameters
| Name | Type | Description |
|---|---|---|
| There are not method parameters in this resource | ||
Query parameters
| Name | Type | Description |
|---|---|---|
| token | xsd:string | REQUIRED. More information concerning oAuth token: oAuth 2.0 authorization |
| lang | xsd:string | Determines language for the output data. softnetSPORT API provides the following languages: 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 100. Possible values: 5, 10, 25, 50, 100, 250, 500 |
| sport_id | xsd:int | Determines the sport identifier in which the events are played. softnetSPORT API provides the following sports: sports.index |
| area_id | xsd:int | Determines the area identifier in which the events are played. softnetSPORT API provides the following sports: areas.index |
| competition_id | xsd:int | Determines the competition identifier in which the events are played. softnetSPORT API provides the following sports: competitions.index |
| season_id | xsd:int | Determines the season identifier in which the events are played. softnetSPORT API provides the following sports: seasons.index |
| stage_id | xsd:int | Determines the stage identifier in which the events are played. softnetSPORT API provides the following sports: stages.index |
| group_id | xsd:int | Determines the group identifier in which the events are played. softnetSPORT API provides the following sports: groups.index |
| participant_id | xsd:int | Determines the identifier of the participant. softnetSPORT API provides the following statuses: participants.index |
| 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:
|
| tz | xsd:string | Determines timezone for the output data. softnetSPORT API provides the following timezones: timezones |
Method calling examples
| Link | Description |
|---|---|
| https://api.softnetsport.com/v2/livescore.xml?token={{YOUR_TOKEN}} | Returns list of all in progress (live) events in XML format |
| https://api.softnetsport.com/v2/livescore?token={{YOUR_TOKEN}} | Returns list of all in progress (live) events in JSON format |
Output elements
| .competitions | |
|---|---|
| ..competition | |
| id | Unique identifier for the competition |
| name | Name of the the competition i.e.: U19 World Champ |
| short_name | Shorter name of the competition i.e.: U19 WCH, Max 20 characters |
| mini_name | Mini name of the competition. Max 3 characters length i.e.: U19 |
| gender | Competition gender. Possible values:
|
| type | Competitions type. Possible values:
|
| area_id | Unique identifier of area in which competitions are played. softnetSPORT API provides the following areas: areas.index |
| area_name | Name of area in which competitions are played |
| area_type | Type of area in which competitions are played. Possible values:
|
| area_sort | The parameter used to sort competitions in the country, i.e. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascending |
| area_code | Max 3 characters length of area in which competitions are played |
| overall_sort | The parameter used to sort competitions. Sorting direction is ascending |
| sport_id | Unique identifier of the sport in which competition is played. softnetSPORT API provides the following sports: sports.index |
| sport_name | Name of the sport in which competition is played |
| tour_id | Unique identifier of the tour in which competition is played. softnetSPORT API provides the following tours: tours.index |
| tour_name | Name of the tour in which competition is played |
| ut | Information about date and time when the competition record was last updated. Format UNIX_TIMESTAMP |
| old_competition_id | deprecated. The attribute will be removed in the next API version |
...seasons | |
....season | |
| id | Unique identifier for the season |
| name | Name of the season f.e: Premiership 2014/15 |
| year | Determines the season year f.e:
|
| ut | Information about date and time when the season record was last updated. Format UNIX_TIMESTAMP |
| old_season_id | deprecated. The attribute will be removed in the next API version |
.....stages | |
.....stage | |
| id | Unique identifier for the stage |
| name | Name of the stage |
| start_date | Date when stage begins. Format YYYY-MM-DD |
| end_date | Date when stage ends. Format YYYY-MM-DD |
| show_standings | Determines if the stage contains a standings. Possible values:
|
| groups_nr | The amount of groups that are part of the stage |
| sort | The sort order for the stage. Sorting direction is ascending |
| is_current | Possible values:
|
| ut | Information about date and time when the stage record was last updated. Format UNIX_TIMESTAMP |
| old_stage_id | deprecated. The attribute will be removed in the next API version |
......groups | |
......group | |
| id | Unique identifier for the group |
| name | Name of the group |
| ut | Information about date and time when the group record was last updated. Format UNIX_TIMESTAMP |
........events | |
.........event | |
| id | Unique identifier for the event |
| name | Name of the event i.e. Spain - Italy |
| start_date | Date when the event starts in format DATE_TIME (2015-03-01 11:02) |
| ft_only | Determines when the result of the event is updated. Possible values:
|
| coverage_type | Type of event coverage. Possible values:
|
| scoutsfeed | Information concerning scouts coverage. Possible values:
|
| status_id | Unique identifier of the event status. softnetSPORT API provides the following statuses: statuses.index |
| status_name | Name of the event status |
| status_type | Type of the status. Possible values:
|
| sport_id | Unique identifier of the sport in which event is played. softnetSPORT API provides the following sports: sports.index |
| sport_name | Name of the sport in which event is played |
| day | Day in the season |
| neutral_venue | Determines if event is played on neutral venue. Possible values:
|
| ut | Information about date and time when the event record was last updated. Format UNIX_TIMESTAMP |
| old_event_id | deprecated. The attribute will be removed in the next API version |
.........details | additional information related to event |
..........detail | |
| id | Unique identifier for the detail |
| name | Name of the detail. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.show |
| value | Value related to the detail |
.........participants | |
..........participant | |
| counter | Number of participant in the event. Participant with counter="1" is home team. |
| id | Unique identifier of the participant |
| type | Participant type. Possible values:
|
| name | Participant name |
| short_name | Participant short name, max length: 20 characters |
| acronym | Max 3 characters length mini name, f.e: BAR, REA |
| gender | Participant gender. Possible value:
|
| area_id | Unique identifier of the area represented by the participant. softnetSPORT API provides the following areas: areas.index |
| area_name | Area name represented by the participant |
| area_code | Max 3 characters length of the short area name f.e: GER, POL, FRA |
| sport_id | Unique identifier of the sport in which participant occures. softnetSPORT API provides the following sports: sports.index |
| sport_name | Name of the sport in which participant occures |
| national | Determines if participant is national team. Possible values:
|
| website | Participant official website |
| ut | Information about date and time when the record was last updated. Format UNIX_TIMESTAMP |
| old_participant_id | deprecated. The attribute will be deprecated in next API version |
...........results | |
............result | |
| id | Unique identifier for the result |
| name | Name of the result. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.show |
| value | Value related to the result |
...........stats | |
............stat | |
| id | Unique identifier for the statistic |
| name | Name of the statistic. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.show |
| value | Value related to the statistic |