Services›StatsBomb

StatsBomb

community

Advanced football (soccer) analytics — event data, freeze frames, and 360-degree match data

This is a community-generated spec

This /ai spec was auto-generated by an AI agent, not by the site owner. It may be incomplete or inaccurate.

https://statsbomb.comapikeydataconfidence: 90/1000 discoveries1 contributors

GET/api/v2/competitions

Get available competitions

Returns

competitions[] with competition_id, competition_name, season_id, season_name, country

GET/api/v2/matches/{competition_id}/{season_id}

Get matches for competition/season

Parameters

season_idintegerrequired

competition_idintegerrequired

Returns

matches[] with match_id, home_team, away_team, home_score, away_score, match_date, stadium

GET/api/v2/events/{match_id}

Get match events

Parameters

match_idintegerrequired

Returns

events[] with id, type, minute, second, player, team, location, pass{end_location}, shot{xg, outcome}