iSports API – Sports API Documentation & Example Responses for Developers

Livescores Changes

Update Time: 2026-05-28 16:21

Introduction

• This API endpoint returns only the matches that have had livescore updates in the last 20 seconds.

• Use it alongside the Livescores for Today endpoint — call Livescores for Today once to get the full match list, then poll this endpoint every 2–10 seconds to receive incremental updates.

Related Plans

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

Request

Path: /sport/football/livescores/changes
Method: GET
Calls: This interface is limited to 1 second/call;
Recommend Calls: 2~10 second/call

Response

Parameter		Value	Description
matchId		string
startTime		int	Actual kick-off time of the first or second half (Unix timestamp, GMT+0) state=1: Returns first half kick-off time state=3: Returns second half kick-off time All other states return 0 To calculate minutes elapsed: current time − halfStartTime (for second half, add 45 minutes to the result)
matchTime		int	Scheduled match kick-off time (Unix timestamp, GMT+0)
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
homeScore		int	Home team full-time goals (default 0)
awayScore		int	Away team full-time goals (default 0)
homeHalfScore		int	Home team first-half goals (default 0)
awayHalfScore		int	Away team first-half goals (default 0)
homeRed		int	Home team red cards (default 0)
awayRed		int	Away team red cards (default 0)
homeYellow		int	Home team yellow cards (default 0)
awayYellow		int	Away team yellow cards (default 0)
homeCorner		int	Home team corners (default 0)
awayCorner		int	Away team corners (default 0)
hasLineup		boolean	Indicates whether lineup data is available true: Available false: Not available
explain		string	Match special remarks (English). Empty string if none
extraExplain		object	Nested object containing extra-time and penalty shootout data. All fields return 0 when not applicable
	kickOff	int	Team that took kick-off 0: Not started 1: Home 2: Away
	minute	int	Minutes played in regular time
	homeScore	int	Home team regular time score
	awayScore	int	Away team regular time score
	extraTimeStatus	int	Extra time status 0: No extra time 1: Extra time ended (regular match; includes regular time score) 2: Extra time ended (special match e.g. beach/indoor football; excludes regular time score) 3: Match currently in extra time
	extraHomeScore	int	Home team extra-time score
	extraAwayScore	int	Away team extra-time score
	penHomeScore	int	Home team penalty shootout score
	penAwayScore	int	Away team penalty shootout score
	twoRoundsHomeScore	int	Home team two-legged aggregate score
	twoRoundsAwayScore	int	Away team two-legged aggregate score
	winner	int	Match winner (knockout/two-legged ties) 0: None / not applicable 1: Home 2: Away
var		string	VAR review event description. Empty string if none
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.

Example Request

Example Response

• This API endpoint returns only the matches that have had livescore updates in the last 20 seconds. \n\n • Use it alongside the Livescores for Today endpoint — call Livescores for Today once to get the full match list, then poll this endpoint every 2–10 seconds to receive incremental updates.

Contact