basic-livescore.index

Resource information

URLhttps://api.statscore.com/v2/basic-livescore
MethodGET

Description

Returns LIVE events' results related to sport
Cache30 seconds
Authorization requiredYes

Method parameters

NameTypeDescription
There are no method parameters in this resource 

Query parameters

Name

Type

Description

tokenxsd:stringREQUIRED. There is more information concerning authorization in the API introduction section
timestampxsd:unix_timestampREQUIRED. Selection date, format UNIX_TIMESTAMP. Only changes in events that occurred or were updated after this timestamp will be returned. The timestamp used in query can be at most 5 hours from the past.
sport_idxsd:intDetermines 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

Method calling examples

LinkDescription
https://api.statscore.com/v2/basic-livescore?token={{YOUR_TOKEN}}Returns a list of all in progress (live) events in JSON format

Method calling examples

Output elements

competitions
competitions > competition
idUnique identifier for the competition
nameName of the the competition e.g. U19 World Champ. Possible translation of the attribute
short_nameAbbreviated name of the competition e.g. U19 WCH, Max 20 characters. Possible translation of the attribute
area_idUnique identifier for area in which competitions are played. The complete list of possible areas can be retrieved using the API resource: areas.index
area_nameName of area in which competitions are played. Possible translation of the attribute
competitions > competition > seasons
competitions > competition > seasons > season
idUnique identifier for the season.
nameName of the season e.g. Premiership 2014/15
year

Determines the season year e.g.

  • 1970
  • 1970/71
  • 1971
  • 1971/72
  • 2000
  • 2000/01
  • 2014
  • 2014/15
competitions > competition > seasons > season > stages
competitions > competition > seasons > season > stages > stage
idUnique identifier for the stage
stage_name_idUnique identifier for the stage's name.
nameName of the stage. Possible translation of the attribute
competitions > competition > seasons > season > stages > stage > events
competitions > competition > seasons > season > stages > stage > events > event
idUnique identifier for the event
nameName of the event e.g. Spain - Italy
start_dateDate when the event starts in the format DATE_TIME (2015-03-01 11:02)
ft_only

Determines when the result/score of the event is updated. Possible values:

  • yes - result/score is updated only when the event is finished 
  • no - result/score is updated during the event
status_idUnique identifier of the event status
status_name

Name of the event status

status_type

Type of status. Possible values:

  • live
  • scheduled
  • finished
  • cancelled
  • interrupted
  • deleted
  • other
sport_idUnique identifier for the sport in which event is played. The complete list of possible sports can be retrieved using the API resource: sports.index
sport_nameName of the sport in which event is played
clock_timeHow many seconds have passed in the current event period. Possible empty value
clock_status

Clock status. Possible value:

  • running
  • stopped
utInformation about when the date and time of the event record was last updated. Format UNIX_TIMESTAMP
competitions > competition > seasons > season > stages > stage > events > event > participants
competitions > competition > seasons > season > stages > stage > events > event > participants > participant
counterThe number of participant in the event. The participant with counter="1" is the home team.
idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
  • double
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
competitions > competition > seasons > season > stages > stage > events > event > participants > participant > results
competitions > competition > seasons > season > stages > stage > events > event > participants > participant > results > result

idUnique identifier for the result
short_nameAbbreviated name of the result.
nameName of the result. Possible values are different depending on the sport
valueValue related to the result
data_type

Defines type of field generated on front (internal purpose only)

  • integer
  • decimal
  • binary_text
  • binary
  • text
  • signed_integer