Events

Update Time: 2025-11-25 08:19

Introduction

• This API endpoint returns instant event of football matches, such as goals, yellow and red cards, substitution, etc.

• By default, the data of the match of the current day is returned, ranging from GMT +0 0:00-23:59.

• The event will be added, modified or deleted. Each eventId stands for an event, which will only be added or deleted. You need to synchronize the data with eventId.

Related Plans

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

Request

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

Parameter	Value	Required	Description
date	string	false	yyyy-mm-dd, e.g. 2019-08-01, only for the matches in the past one month.
cmd=new	string	false	Return data updated in the last three minutes.

Response

Parameter		Value	Description
matchId		int
events		list
	eventId	int
	minute	string	e.g : 25 When the match is the injury time for the first half, minutes=45 When the match is the injury time for the second half, minutes=90
	type	int	1: Goal 2: Red card 3: Yellow card 7: Penalty scored 8: Own goal 9: Second yellow card 11: Substitution 13: Penalty missed 14:Video Referee (VR Referee)
	homeEvent	boolean	Is it home team event?
	playerId	int	Returns playerId of the scorer, substitution on or Yellow/Red card. Return null when the event has no player data.
	playerName	string	Return null when the event has no player data. Returns 2 player when the event includes a goal assist or a substitution. e.g. Diego Tardelli Martins(Assists:Everton Sousa Soares) or Bruno Alves de Souza↑Cicero Dos Santos Bezerra,Didira↓
	assistPlayerId	string	Returns playerId of the assister or substitution off. Return null when the event has no player data.
	overtime	string	Injury time
	oprTime	string	GMT +7 (Bangkok Time)

Request

Path: /football_th/events.aspx?cmd=shot
Method: GET
Calls: This interface is limited to 10 second/call.
Recommend Calls: 1 minute/call
Parameters:

Parameter	Value	Required	Description
date	string	false	yyyy-mm-dd, e.g. 2019-08-01, only for the matches in the past one month.

Response

Parameter		Value	Description
matchId		int
events		list
	eventId	int
	minute	string	e.g : 25 When the match is the injury time for the first half, minutes=45 When the match is the injury time for the second half, minutes=90
	overtime	string	Injury time
	playerId	int
	playerName	string
	homeEvent	boolean	Is it home team event?
	outcome	string	Saved Post Blocked Goal Missed Own goal
	situation	string	Corner Free kick Set piece Throw-in set piece Penalty Shootout Open play Fast break Assisted
	shotType	string	Left foot Right foot Header Other body part
	goalZone	string	High Left Right Low centre Low right Low left High centre High right High left Close high Close right Close left Close left and high Close right and high
	isBlocked	boolean
	oprTime	string	GMT +7 (Bangkok Time)

• This API endpoint returns instant event of football matches, such as goals, yellow and red cards, substitution, etc.\n\n • By default, the data of the match of the current day is returned, ranging from GMT +0 0:00-23:59.\n\n • The event will be added, modified or deleted. Each eventId stands for an event, which will only be added or deleted. You need to synchronize the data with eventId.