get_events
10 creditsMulti-tablePOST /v1/get_events
Data refreshed · changelog
Match events: goals, cards, substitutions, shots with location and xG, fouls, corners
Use it when you want a match's events in order: goals, shots with location and xG, cards, substitutions, fouls and corners.
Parameters
game_idstringrequired- Match id.
kindenum: goals | shots | cards | substitutions | set_pieces | fouls | alloptional- goals, shots, cards, substitutions, set_pieces, fouls or all (default).
limitintegeroptional- Max events (default 300).
offsetintegeroptional- Page offset; use next_offset.
leagueenum: soccer | mls | laliga | seriea | bundesliga | ligue1 | ucl | championship | nwsl | ligamx | uel | uecl | eredivisie | primeira | scotland | brazil | argentinaoptional- League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
Notes
- Over MCP, ask for it in plain English and the client calls
get_eventsitself. Point any MCP client athttps://mcp.strikerapi.com/mcp?key=YOUR_API_KEY. - Each call costs 10 credits, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.strikerapi.com/v1/get_events \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"game_id": "740916",
"kind": "goals"
}'Response
json
{
"events": [
{
"seq": 13,
"minute": 16,
"added_minute": null,
"period": 1,
"type": "goal",
"team_id": "382",
"team": "MNC",
"player_id": "298008",
"player": "Rayan Cherki",
"player2_id": "303785",
"player2": "Matheus Nunes",
"shot": {
"outcome": "goal",
"body_part": "right_foot",
"penalty": false,
"xg": 0.187,
"zone": "penalty_area",
"x": 0.19,
"y": 0.579,
"end_x": 0,
"end_y": 0.458,
"metres": "{...}",
"distance_m": 10.6
},
"is_goal": true,
"own_goal": false,
"shootout": false,
"text": "16' Goal: Rayan Cherki (MNC), right foot, inside the box, assist Matheus Nunes"
},
{
"seq": 14,
"minute": 18,
"added_minute": null,
"period": 1,
"type": "goal",
"team_id": "359",
"team": "ARS",
"player_id": "231182",
"player": "Kai Havertz",
"player2_id": null,
"player2": null,
"shot": {
"outcome": "goal",
"body_part": "right_foot",
"penalty": false,
"xg": 0.168,
"zone": "six_yard_box",
"x": 0.042,
"y": 0.401,
"end_x": 0,
"end_y": 0.484,
"metres": "{...}",
"distance_m": 7
},
"is_goal": true,
"own_goal": false,
"shootout": false,
"text": "18' Goal: Kai Havertz (ARS), right foot, inside the six-yard box"
},
{
"seq": 58,
"minute": 65,
"added_minute": null,
"period": 2,
"type": "goal",
"team_id": "382",
"team": "MNC",
"player_id": "253989",
"player": "Erling Haaland",
"player2_id": null,
"player2": null,
"shot": {
"outcome": "goal",
"body_part": "left_foot",
"penalty": false,
"xg": 0.274,
"zone": "penalty_area",
"x": 0.186,
"y": 0.538,
"end_x": 0,
"end_y": 0.481,
"metres": "{...}",
"distance_m": 9.3
},
"is_goal": true,
"own_goal": false,
"shootout": false,
"text": "65' Goal: Erling Haaland (MNC), left foot, inside the box"
}
],
"count": 3,
"next_offset": null
}Response fields
events[]array- List of objects
events[].seqnumberevents[].minutenumberevents[].added_minutenullevents[].periodnumberevents[].typestringevents[].team_idstringevents[].teamstringevents[].player_idstringevents[].playerstringevents[].player2_idstringevents[].player2stringevents[].shotobjectevents[].shot.outcomestringevents[].shot.body_partstringevents[].shot.penaltybooleanevents[].shot.xgnumberevents[].shot.zonestringevents[].shot.xnumberevents[].shot.ynumberevents[].shot.end_xnumberevents[].shot.end_ynumberevents[].shot.metresstringevents[].shot.distance_mnumberevents[].is_goalbooleanevents[].own_goalbooleanevents[].shootoutbooleanevents[].textstringcountnumbernext_offsetnull
Used in
- Premier League match event data: Every Premier League goal and substitution since 2001-02, cards from 2011-12, and from 2012-13 every shot, foul, corner and offside. REST or MCP.
- Premier League shot location and xG data: The location, end point, outcome and body part of every Premier League shot charted since 2012-13, with our expected goals. REST or MCP.
Related endpoints
list_games2 cr
Returns the game_id this one takes.
Fixtures and results by season, stage, date, range or club
get_schedule2 cr
Returns the game_id this one takes.
Upcoming fixtures with the median three-way line across sportsbooks
get_player5 cr
Takes the player_id this one returns.
Profile, per-season totals and per-90 rates, last 10 matches
get_player_games5 cr
Takes the player_id this one returns.
A player's full match log
Try it
500 free credits every month: 50 calls to get_events, and no card.