TotalFootball API
TotalFootball API provides comprehensive, real-time football data across the globe. Access detailed information on countries, leagues, seasons, fixtures, standings, teams, players, venues, and match stages. Key features include: Live match scores & updates Fixtures & results by league or date Lineups, player stats, and team info Head-to-head history & match trends League standings and stage…
TotalFootball API endpoints
| Method | Endpoint | Description |
|---|---|---|
| country | ||
| GET |
Get Country List /api/country/list |
Returns a list of all countries |
| competitions | ||
| GET |
Get Competition List /api/comp/list/{page} |
Returns paginated list of competitions (e.g., /api/comp/list/1) |
| GET |
Get Best Lineups /api/comp/best_lineups/{comp_id} |
Returns best lineups for a competition |
| GET |
Get Competition Player Stats /api/comp/player_stats/{comp_id}/{season_id} |
Returns player statistics for a competition in a specific season |
| GET |
Get Competition Overview /api/comp/overview/{comp_id} |
Returns overview information for a specific competition |
| match | ||
| GET |
Get Live Matches /api/match/living |
Returns currently ongoing matches |
| GET |
Get Match Trend /api/match/trend/{match_id} |
Returns trend data for a match |
| GET |
Get Recent Matches (24h Diary) /api/match/diary |
Returns matches from the last 24 hours |
| GET |
Get Recent Match List /api/match/recent/list/{page} |
Returns paginated list of recent matches (last 30 days) |
| GET |
Get Match Incident /api/match/incident/{match_id} |
Get Match Incident |
| GET |
Get Match Detail Live /api/match/detail_live/{match_id} |
Returns comprehensive live match details |
| GET |
Get Head-to-Head (H2H) Data /api/match/h2h/{match_id} |
Returns head-to-head comparison data |
| GET |
Get Match Stats /api/match/stats/{match_id} |
Returns match statistics |
| GET |
Get Match Team Stats /api/match/team_stats/{match_id} |
Returns team statistics for a match |
| GET |
Get Match Info /api/match/info/{match_id} |
Returns basic information about a match |
| GET |
Get Match Lineup /api/match/lineup/{match_id} |
Returns lineup information for a specific match |
| GET |
Get live matches with video streams /api/match/living/stream |
Get live matches with video streams |
| odds | ||
| GET |
Get Match Odds Detail /api/match/odds_detail/{match_id} |
Returns detailed odds information |
| GET |
Get Match Odds /api/match/odds/{match_id} |
Returns odds information for a match |
| team | ||
| GET |
Get Team List /api/team/list/{page} |
Returns paginated list of teams |
| GET |
Get Team Squad /api/team/squad/{team_id} |
Returns current squad for a team |
| GET |
Get Team Transfers /api/team/transfer/{team_id} |
Returns transfer history for a team |
| GET |
Get Team Seasons /api/team/seasons/{team_id} |
Returns seasons participated in by a team |
| GET |
Get Team Honors /api/team/honors/{team_id} |
Returns honors/awards for a team |
| GET |
Get Team Info /api/team/info/{team_id} |
Returns information about a specific team |
| player | ||
| GET |
Get Manager Info /api/manager/info/{manager_id} |
Returns information about a specific manager |
| GET |
Get Player List /api/player/list/{page} |
Returns paginated list of players |
| GET |
Get Player Honors /api/player/honors/{player_id} |
Returns honors/awards for a player |
| GET |
Get Player Totals /api/player/totals/{player_id}/{season_id} |
Returns statistics totals for a player (optionally filtered by season) |
| GET |
Get Player Transfers /api/player/transfer/{player_id} |
Returns transfer history for a player |
| GET |
Get Player Info /api/player/info/{player_id} |
Returns information about a specific player |
| venue | ||
| GET |
Get Venue List /api/venue/list/{page} |
Returns paginated list of venues |
| standing | ||
| GET |
Get Season Team Standing /api/season/team/standing/{season_id} |
Returns team standings for a season |
| GET |
Get Competition Standing /api/standing/{competition_id}/{season_id} |
Returns standings for a competition in a specific season |
| stages | ||
| GET |
Get Stages List /api/stages/list/{page} |
Returns paginated list of stages |
| image | ||
| GET |
Get Image /api/{type}/image/{image} |
Returns an image for a specific entity (country, team, player, or competition) |
| live | ||
| GET |
Get Live Match Data /api/living/{mid} |
Returns real-time data for a live match |
| GET |
m3u8 /api/m3u8/{match_id} |
Get the m3u8 playlist |
TotalFootball API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $5.9 / month | 300 / minute |
|
| ULTRA Recommended | $19.9 / month | 600 / minute |
|
| MEGA | $39.9 / month | 900 / minute |
|