Football Important Events

Interface Overview:
Get important event data for football matches - Custom parameter query (different paths for different projects)
This interface returns the complete important event data for the requested parameters (Request limit: schedule of 30 days before and after)

Recommended request
Update data:
Option 1: Request important event data for specified matches when needed:
Option 2: Receive push notifications for changing real-time data (long link push / enhanced version of real-time data / event data push)
Frequency limit: 30 times/min

Request

Query Params

match_id

string

optional

support multiple IDs, IDs separated by English commas

Example:

3091184

page

integer

optional

Number of pages

per_page

integer

optional

Number of data items per page, default is 20 if not specified

language

string

optional

Multilingual name, see API guide for detailed parameters (global multilingual), if this parameter is not passed, English is returned by default.

recent_update

string

optional

Update Time: Filter data updated in the recent time period, supporting 30m, 1h, 12h, 48h

Responses

🟢200success

application/json

Body

code

integer

Status Code

required

0-Request succeeded

data

object

Event Update Data

required

list

array [object {4}]

required

total

integer

Total Records

required

msg

string

API Response Message

required

Example

{
    "code": 0,
    "data": {
        "list": [
            {
                "sport_id": 202,
                "match_id": 3091184,
                "event_data": [
                    {
                        "type": 9,
                        "position": 1,
                        "state": 12,
                        "time": 2700,
                        "event_time": 1720641876,
                        "home_score": 1,
                        "away_score": 0,
                        "reason": 1,
                        "result": 1,
                        "player_info": {
                            "player_id": 59719,
                            "name": "Cole Palmer"
                        },
                        "in_player_info": {
                            "player_id": 16295,
                            "name": "Wout Weghorst"
                        },
                        "out_player_info": {
                            "player_id": 7167,
                            "name": "Donyell Malen"
                        },
                        "assist_player1_info": {
                            "player_id": 59719,
                            "name": "Cole Palmer"
                        },
                        "assist_player2_info": null
                    }
                ],
                "update_time": 1734333653
            }
        ],
        "total": 1
    },
    "msg": "success"
}

Football Important Events

Request

Request samples

Responses