Resource information
URL | https://api.softnetsportstatscore.com/v2/seasons | XSD | https://api.softnetsport.com/assets/API/docs/xsd/seasons.index.xsd |
---|---|---|---|
Method | GET | ||
Description | Returns the a list of all available seasons played in the competitions | Package||
This resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packages | Cache | 60 seconds | |
Authorization required | Yes |
...
Name | Type | Description |
---|---|---|
token | xsd:string | REQUIRED. More information concerning authorization in API introduction section |
lang | xsd:string | Determines language for the output data. softnetSPORT API provides the following languages 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 500. Possible values: 5, 10, 25, 50, 100, 250, 500 |
sport_id | xsd:int | Determines the sport to which the season belongs. softnetSPORT API provides the following sportsThe complete list of possible sports can be retrieved using the API resource: sports.index |
competition_id | xsd:int | Determines the competition to which the season belongs. softnetSPORT API provides the following competitions. Possibility to input multiple identifiers, separated by comma. The complete list of possible competitions can be retrieved using the API resource: competitions.index |
participant_id | xsd:int | Determines the participant that is included in the seasons. The complete list of possible participants can be retrieved using the API resource: participants.index |
multi_ids | xsd:string | List of season identifiers separated by a comma (e.g. 123,234,321) for the season details you want to get.(Up to 100 ids) |
year | xsd:string | Determines the season year e.g.
|
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 sort (ascending, descending)
|
area_id | xsd:int | Determines the area represented by the participant. softnetSPORT API provides the following areas: The complete list of possible areas can be retrieved using the API resource: areas.index |
timestamp | xsd:unix_timestamp | Selection date, format UNIX_TIMESTAMP. Only changes in the seasons that occurred or were updated after this timestamp will be returned. |
Method calling examples
Link | Description | ||||
---|---|---|---|---|---|
https://api. | softnetsportstatscore.com/v2/seasons | .xml?token={{YOUR_TOKEN}} | Returns a list of season names in | XML formathttps://api.softnetsport.com/v2/seasons?token={{YOUR_TOKEN}} | Returns a list of season names in JSON format |
https://api.softnetsportstatscore.com/v2/seasons.xml?token={{YOUR_TOKEN}}&competition_id=1507 | Returns the seasons played in the competition - Primera Division | ||||
https://api.softnetsportstatscore.com/v2/seasons.xml?token={{YOUR_TOKEN}}&sport_id=5 | Returns all competition seasons played in soccer | ||||
https://api.softnetsportstatscore.com/v2/seasons.xml?token={{YOUR_TOKEN}}&year=2014/15 | Returns all competition seasons played in the season year 2014/15. |
Output elements
competitions | .|||||
---|---|---|---|---|---|
competitions | .. | > competition | |||
id | Unique identifier for the competition | ||||
name | Name of the the competition e.g. U19 World Champ | ||||
short_name | Abbreviated name of the competition e.g. U19 WCH, Max 20 characters | ||||
mini_name | Mini name of the competition. Max 3 characters in length e.g. U19 | ||||
gender | Competition gender. Possible values:
| ||||
type | Competitions type. Possible values:
| ||||
area_id | Unique identifier for area in which the competitions are played. softnetSPORT API provides the following areas: areas.index | ||||
area_name | Name of the area in which the competitions are played | ||||
area_type | Type of area in which competitions are played. Possible values:
| ||||
area_sort | The parameter used to sort competitions in a the country e.g. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascending | ||||
area_code | Max 3 characters in length for the area in which competitions are played | ||||
overall_sort | The parameter used to sort competitions. Sorting direction is ascending | ||||
sport_id | Unique identifier for the sport in which a competition is played. softnetSPORT API provides the following sports: sports.index | ||||
sport_name | Name of the sport in which a competition is played | ||||
tour_id | Unique identifier for the tour in which a competition is played. softnetSPORT API provides the following tours: tours.index | ||||
tour_name | Name of the tour in which a competition is played | ||||
ut | Information about the date and time of when the competition record was last updated. Format UNIX_TIMESTAMP | ||||
old_competition_id | deprecated. The attribute will be removed in the next API version | ||||
slug | friendly url for competition | ||||
...seasons | |||||
....season | |||||
id | Unique identifier for the season | ||||
name | Name of the season e.g. Premiership 2014/15 | ||||
year | Determines the season year e.g.
| ||||
ut | Information about the date and time of 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 standings. Possible values:
| ||||
groups_nr | The number 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 the date and time of when the stage record was last updated. Format UNIX_TIMESTAMP | ||||
old_stage_id | deprecated. The attribute will be removed in the next API version |
...
| |||||||
competitions > competition > seasons | |||||||
---|---|---|---|---|---|---|---|
competitions > competition > seasons > season | |||||||
|