get_events

10 creditsMulti-tablePOST /v1/get_events

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: ESPN 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.

Notes

Over MCP, ask for it in plain English and the client calls get_events itself. Point any MCP client at https://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": "Goal! Manchester City 1, Arsenal 0. Rayan Cherki (Manchester City) right footed shot from the centre of the box to the bottom left corner. Assisted by 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": "Goal! Manchester City 1, Arsenal 1. Kai Havertz (Arsenal) right footed shot from the left side of the six yard box to the centre of the goal."
    },
    {
      "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": "Goal! Manchester City 2, Arsenal 1. Erling Haaland (Manchester City) left footed shot from the centre of the box to the bottom left corner."
    }
  ],
  "count": 3,
  "next_offset": null
}