Events

Update Time: 2025-12-09 17:51

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: /sport/football/events
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=shot	string	false	Shooting events. If date is not specified, returns events from 00:00 to 23:59 (GMT+0) of the current day. If date is specified, returns events from 00:00 to 23:59 (GMT+0) of the specified date.
cmd=new	string	false	Return data updated in the last three minutes.

Response

To retrieve shot events separately, add the parameter: cmd=shot

Parameter			Value	Description
matchId			string
events			list
	eventId		string
	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)
	playerId		string	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
	homeEvent		boolean	Is it home team event?
penalty			list
	eventId		string
	homeEvent		boolean	Is it home team event?
	playerId		string
	playerName		string
	homeScore		int
	awayScore		int
	missed		boolean	Is it missed?
	oprTime		int	Update time. unix timestamp
Shooting events				Data after using the "cmd=shot" parameter
	matchId		string
	events
		eventId	string
		minute	int	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	int	How many minutes of overtime.
		playerId	string
		playerName	string
		homeEvent	boolean	Is it the home team?
		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	Right footed Left footed Head 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	int	Update time. unix timestamp

Example Request

Example Response

• 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.

Events

Contact