get_events
Read-only
Use for a match's events in order: goals (with assister, own goals, penalties), shots with location, outcome, body part and our xG, cards, substitutions, fouls, corners, offsides and VAR decisions. Filter with kind. Older matches carry goals, cards and substitutions only. Costs 10 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | goals, shots, cards, substitutions, set_pieces, fouls or all (default). | |
| limit | No | Max events (default 300). | |
| league | No | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. | |
| offset | No | Page offset; use next_offset. | |
| game_id | Yes | ESPN match id. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| count | Yes | ||
| events | Yes | ||
| next_offset | No |