Events
Update Time: 2022-05-30 10:01
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. |
Response
| 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? | |
Example Request
Example Response
{}
