Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Resource information

URLhttps://api.softnetsportstatscore.com/v2/competitions
XSDhttps://api.softnetsport.com/assets/API/docs/xsd/competitions.index.xsd
MethodGET

Description

Returns competitions supported in the softnetSPORT API servicePackageThis resource is included in the SCOUTSFEED, LIVESCORE and STATISTICS packagesa list of all available competitions
Cache60 seconds
Authorization requiredYes

...

Query parameters

Returns a list of all competitions in JSON format
NameTypeDescription

token

xsd:string

REQUIRED. More information concerning

oAuth token: oAuth 2.0 authorization

authorization in API introduction section

lang

xsd:string

Determines the language for the output data. API provides the following languages: https://api.softnetsport.com/v2/languages.xml The complete list of possible languages can be retrieved using the API resource: languages.index

date_from

xsd:string

REQUIRED. If not used, the date will be automatically set for the current day. Selection datetime, format 'yyyy-mm-dd hh:mm:ss'. UTC Format. Returns only competitions with event start date greater than or equal to date_from.

date_to

xsd:string

REQUIRED. If not used, the date will be automatically set for the current day. Selection datetime, format 'yyyy-mm-dd hh:mm:ss'. UTC Format. Returns only competitions with an event start date less than or equal date_to (the date range cannot be greater than 1 month)

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

area_type

xsd:string

Determines type of area in which competitions are played. Possible values:

  • country

  • international

type

xsd:string

Determines type competition. Possible values:

  • country_league - e.g. Premier Division

  • country_cups - e.g. FA Cup

  • international - e.g. World Cup

  • international_clubs - e.g. Champions League 

  • friendly - friendly matches

  • individual - for speedway individual competitions such as Speedway GP

  • team - for speedway national competitions

  • single - for tennis competitions

  • double - for tennis competitions

  • mixed - for tennis competitions

  • undefined - for other competitions

     

For more than one area type you should provide values separated by a comma ","

area_id

xsd:int

Determines the area in which competition are played. softnetSPORT API provides the following areas: areas.index

For more than one area you should provide values separated by a comma ",". The complete list of possible areas can be retrieved using the API resource: areas.index

sport_id

xsd:int

Determines the sport identificator in which the competitions are played.

softnetSPORT API provides the following sports

The complete list of possible sports can be retrieved using the API resource: sports.index

tour_id

xsd:int

Determines the tour identificator in which the competitions are played.

softnetSPORT API provides the following tours

The complete list of possible tours can be retrieved using the API resource: tours.index

multi_ids

xsd:string

List of competition identifiers should be separated by a comma (e.g. 123,234,321) for the selected competitions details. (Up to 100 ids)

gender

xsd:string

Determines competition gender. Allows selection of e.g. only WTA Womens Competitions in Tennis. Possible values:

  • male

  • female

  • mixed

timestamp

xsd:unix_timestamp

LinkDescription
https://api.softnetsport.com/v2/competitions.xml?token={{YOUR_TOKEN}}Returns a list of all competitions in XML format
https://api.softnetsport.com/v2/competitions?token={{YOUR_TOKEN}}

Selection date, format UNIX_TIMESTAMP. Only changes in competitions that occurred or were updated after this timestamp will be returned

Method calling examples

short_name

xsd:string

Determines competition short_name. The attribute must have minimum 3 characters.

sort_type

xsd:string

Determines sort type for competitions (internal usage only). Possible values: 

  • tour 

participant_idxsd:intDetermines the identifier of the participant. To use this parameter, date_from and date_to parameters must be given.

status_type

xsd:string

Return only competition with event status live,finished,scheduled,other,cancelled,interrupted,deleted.

tz

xsd:string

Custome timezone for data_from and date_to.

Method calling examples

LinkDescription
https://api.softnetsportstatscore.com/v2/competitions?token= {{YOUR_TOKEN}}&type=country_league&gender=maleReturns a list of all mens competitions which are country leagues

https://api.softnetsportstatscore.com/v2/competitions?token= {{YOUR_TOKEN}}&type=international_cup&sport_id=5&area_id=203&gender=male

Returns a list of all international cups, mens competitions for soccer which are played in Europe

Output elements


 
...
competitions
competitions  > competition 
idUnique identifier for the competition
nameName of the the competition e.g. U19 World Champ
short_nameAbbreviated 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:

  • male
  • female
  • mixed
type

Competitions type. Possible values:

  • country_league - e.g Premier Division
  • country_cups - e.g. FA Cup
  • international - e.g. World Cup
  • international_clubs - e.g. Champions League 
  • friendly - friendly matches
  • individual - for speedway individual competitions such as Speedway GP
  • team - for speedway national competitions
  • single - for tennis competitions
  • double - for tennis competitions
  • mixed - for tennis competitions
  • undefined - other
area_idUnique identifier for area in which competitions are played. softnetSPORT API provides the following areas: areas.index
area_nameName of area in which competitions are played
area_type

 Type of area in which competitions are played. Possible values:

  • country
  • international
area_sortThe parameter used to sort competitions in a country e.g. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascending
area_codeMax 3 characters, area in which competitions are played
overall_sortThe parameter used to sort competitions. Sorting direction is ascending
sport_idUnique identifier for the sport in which the competition is played. softnetSPORT API provides the following sports: sports.index
sport_nameName of the sport in which the competition is played
tour_idUnique identifier for the tour in which thecompetition is played. softnetSPORT API provides the following tours: tours.index
tour_nameName of the tour in which the competition is played
utInformation about when the date and time of the competition record was last updated. Format UNIX_TIMESTAMP
old_competition_iddeprecated. The attribute will be removed in the next API version
slugfriendly url for competition

 

...

Include Page
Competition node
Competition node