Livescores for Today

Update Time: 2022-03-31 09:42

Introduction

This API endpoint returns livescore of football matches for the current day ( GMT +0 00:00-23:59 ). You can use it with the Livescore Changes endpoint.

Related Plans

You can use this api by subscribing plans:  Live Data.

Request

  • Path: /football_th/livescores.aspx
  • Method: GET
  • Calls: This interface is limited to 10 second/call.
  • Recommend Calls: 1 minute/call

Response

Parameter Value Description
matchId int
leagueType int 1: League
2: Cup
leagueId int
leagueName string Full name, e.g. Brazil Serie A
leagueShortName string Short name, e.g. BRA D1
leagueColor string
subLeagueId string
subLeagueName string The on-going sub league of the league, e.g. Western Paly Off
matchTime date Match scheduled time, GMT +7 (Bangkok Time)
halfStartTime date The opening time of the first half or the second half, GMT +7 (Bangkok Time).
Match time = current time-opening time (second half + 45 minutes)
state=1:Return to the opening time of the first half;
state=3:Return to the opening time of the second half.
There is no opening time for other states.
status int 0: Not started
1: First half
2: Half-time break
3: Second half
4: Extra time
5: Penalty
-1: Finished
-10: Cancelled
-11: TBD
-12: Terminated
-13: Interrupted
-14: Postponed
homeId int
homeName string
awayId int
awayName string
homeScore int Regular time
awayScore int Regular time
homeHalfScore int First half score, home team
awayHalfScore int First half score, away team
homeRed int home team red card
awayRed int away team red card
homeYellow int home team yellow card
awayYellow int away team yellow card
homeCorner int home team corner
awayCorner int away team corner
homeRank string The ranking of the team in the league, home team
awayRank string The ranking of the team in the league, away team
season string e.g. 2019-2020
stageId string Matches with [Interface Cup Stage Profile] stageId;
To distinguish the different stages of the cup, the league does not return this data.
round string League round or cup stage, e.g. 10
group string Cup group, e.g. A
location string e.g. Camp Nou
weather string e.g. Clear
temperature string e.g. 14℃~15℃
explain string Special case description of the match, e.g. Match end up with [0-3], due to (Torpedo-MAZ Minsk) withdraw from the match
extraExplain object Return to Extra time, Penalty kicks, etc.
kickOff int 1: Home kickoff
2: Away kickoff
minute int How many minutes does the match have in regular time?
homeScore int Regular time score, home team
awayScore int Regular time score, away team
extraTimeStatus int 1: Normal matches extratime ends, "extraHomeScore/extraAwayScore" includes the regular time score
2: Special matches (e.g. beach football, indoor football) extratime ends, "extraHomeScore/extraAwayScore" does not include the regular time score
3: The match in extra time
extraHomeScore int Extra time score, home team
extraAwayScore int Extra time score, away team
penHomeScore int Penalty score, home team
penAwayScore int Penalty score, away team
twoRoundsHomeScore int
twoRoundsAwayScore int
winner int Winner of the match
1: Home
2: Away
hasLineup boolean Is there Lineup data?
neutral boolean Is it a neutral venue?
var string VAR events
injuryTime int Length of injury time in the first and second half.How many minutes the injury time lasts needs to be calculated by the user.
More than 45 minutes in the first half and more than 90 minutes in the second half will be counted as injury time.
    This API endpoint returns livescore of football matches for the current day ( GMT +0 00:00-23:59 ). You can use it with the Livescore Changes endpoint.

    Livescores for Today iSportsAPI