Football Stats API – Live Scores, xG, Odds & Player Data
## Football Stats API – Live Scores, xG, Player Data & Odds TheStatsAPI is a fast, reliable football data API built for developers. Get instant access to live match scores, detailed match statistics, player stats, xG (expected goals), pre-match odds, live in-play odds, fixtures, and historical match data — all from a single, well-documented REST API. ### What's included on every plan - **Live…
Football Stats API – Live Scores, xG, Odds & Player Data endpoints
| Method | Endpoint | Description |
|---|---|---|
| Competitions | ||
| GET |
/competitions /competitions |
Retrieve a paginated list of football competitions |
| GET |
/competitions/{competition_id} /competitions/{competition_id} |
|
| GET |
/competitions/{competition_id}/seasons /competitions/{competition_id}/seasons |
Returns all seasons for the competition, newest first. The season with `is_current` true matches `current_season_id` on the competition detail response. |
| Teams | ||
| GET |
/teams/{team_id} /teams/{team_id} |
|
| GET |
/teams/{team_id}/stats /teams/{team_id}/stats |
|
| GET |
/teams /teams |
Retrieve a paginated list of teams with optional filters |
| GET |
/teams/{team_id}/players /teams/{team_id}/players |
Returns all players assigned to the club (players.teamid), up to 100, with extended profile fields. Omits deceased and usercount. |
| Matches | ||
| GET |
/matches/{match_id}/stats /matches/{match_id}/stats |
|
| GET |
/matches /matches |
Retrieve a paginated list of matches with optional filters. Use date/status filters to query past (e.g. finished) or upcoming fixtures. |
| GET |
/matches/{match_id}/referee /matches/{match_id}/referee |
Returns the referee assigned to the match with career summary stats. `referee` is null when no referee is assigned. |
| GET |
/matches/{match_id} /matches/{match_id} |
|
| GET |
/matches/{match_id}/shotmap /matches/{match_id}/shotmap |
Retrieve every shot taken in a match, along with per-shot metadata (xG, body part, situation, coordinates, derived flags) and an aggregated non-penalty xG summary for both teams. |
| GET |
/matches/{match_id}/player-stats /matches/{match_id}/player-stats |
Retrieve per-player statistics for a specific match, grouped by passing, shooting, defending, and general stats |
| GET |
/matches/{match_id}/live-stats /matches/{match_id}/live-stats |
|
| Players | ||
| GET |
/players/{player_id} /players/{player_id} |
|
| GET |
/players/{player_id}/stats /players/{player_id}/stats |
Retrieve statistics for a player in a specific season |
| GET |
/players /players |
Retrieve a paginated list of players with optional filters |
| Odds | ||
| GET |
/matches/{match_id}/odds/live /matches/{match_id}/odds/live |
Retrieve in-play odds for a match across all key markets (Match Result, BTTS, Total Goals, Corners, Asian Handicap) with last-seen values |
| GET |
/matches/{match_id}/odds /matches/{match_id}/odds |
Retrieve odds for a match across all key markets (Match Result, BTTS, Total Goals, Corners, Asian Handicap) with opening and last-seen values. Available for upcoming and finished… |
Football Stats API – Live Scores, xG, Odds & Player Data pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / minute |
|
| PRO | $15 / month | 60 / minute |
|
| ULTRA Recommended | $60 / month | 120 / minute |
|
| MEGA | $150 / month | 300 / minute |
|