Events

Update Time: 2022-04-29 17:02

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; 200 calls per day for free trial.
  • Recommend Calls: 1 minute/call
  • Parameters:
ParameterValueRequiredDescription
datestringfalseyyyy-mm-dd, e.g. 2019-08-01, only for the matches in the past one month.

Response

ParameterValueDescription
matchId string
events list
eventId string
minute stringe.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 int1: 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 stringReturns playerId of the scorer, substitution on or Yellow/Red card.
Return null when the event has no player data.
playerName stringReturn 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 stringReturns playerId of the assister or substitution off.
Return null when the event has no player data.
overtime stringInjury time
homeEvent booleanIs it home team event?
penalty list
eventId string
homeEvent booleanIs it home team event?
playerId string
playerName string
homeScore int
awayScore int
missed booleanIs it missed?

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.

    EventsiSportsAPI

    Contact