OneFootball
OneFootball API (onefootball.com): Real-Time Scores, Results & Match Stats. Get detailed sports data including live scores, fixtures, results, and stats from OneFootball across football (soccer).
OneFootball endpoints
| Method | Endpoint | Description |
|---|---|---|
| Match | ||
| GET |
Get live matches /api/onefootball/v1/match/live |
Returns the currently live matches, grouped by competition. |
| GET |
Get matches by date /api/onefootball/v1/match/list |
Returns the matches for a date, grouped by competition. Defaults to today. |
| GET |
Get match details /api/onefootball/v1/match/details |
Returns details for a match. |
| GET |
Get match events /api/onefootball/v1/match/events |
Returns the events (goals, cards, substitutions) for a match. |
| GET |
Get match lineup /api/onefootball/v1/match/lineup |
Returns the line-ups for a match. |
| GET |
Get match stats /api/onefootball/v1/match/stats |
Returns the statistics for a match. |
| GET |
Get match form guide /api/onefootball/v1/match/form-guide |
Returns the recent form of both teams in a match. |
| GET |
Get match prediction /api/onefootball/v1/match/prediction |
Returns the fan prediction (votes) for a match. |
| Competition | ||
| GET |
Get all competition letters /api/onefootball/v1/competition/letters |
Returns the alphabetical index of all competitions. |
| GET |
Get competitions by letter /api/onefootball/v1/competition/list |
Returns all competitions for a letter. |
| GET |
Get competition details /api/onefootball/v1/competition/details |
Returns details for a competition. |
| GET |
Get competition fixtures /api/onefootball/v1/competition/fixtures |
Returns the fixtures for a competition. |
| GET |
Get competition results /api/onefootball/v1/competition/results |
Returns the results for a competition. |
| GET |
Get competition table /api/onefootball/v1/competition/table |
Returns the standings table for a competition. Supports single tables and multi-group tables. |
| GET |
Get competition knockout tree /api/onefootball/v1/competition/knockout-tree |
Returns the knockout bracket (stages with matches) for a competition. |
| GET |
Get competition transfers /api/onefootball/v1/competition/transfers |
Returns the transfers for a competition. |
| Team | ||
| GET |
Get all team letters /api/onefootball/v1/team/letters |
Returns the alphabetical index of all teams. |
| GET |
Get teams by letter /api/onefootball/v1/team/list |
Returns all teams for a letter. |
| GET |
Get team details /api/onefootball/v1/team/details |
Returns details for a team. |
| GET |
Get team competitions /api/onefootball/v1/team/competitions |
Returns the competitions a team takes part in. |
| GET |
Get team fixtures /api/onefootball/v1/team/fixtures |
Returns the upcoming fixtures for a team, grouped by month. |
| GET |
Get team results /api/onefootball/v1/team/results |
Returns the past results for a team, grouped by month. |
| GET |
Get team squad /api/onefootball/v1/team/squad |
Returns the squad of a team, grouped by position. |
| GET |
Get team transfers /api/onefootball/v1/team/transfers |
Returns the transfers for a team. |
| Player | ||
| GET |
Get player seasons /api/onefootball/v1/player/seasons |
Returns the seasons/competitions a player has stats for. |
| GET |
Get player stats /api/onefootball/v1/player/stats |
Returns a player stats for a season, grouped by category. |
| GET |
Get player details /api/onefootball/v1/player/details |
Returns details for a player. |
| Transfer | ||
| GET |
Get transfer details /api/onefootball/v1/transfer/details |
Returns the details for a transfer. |
| Other endpoints | ||
| GET |
Search /api/onefootball/v1/search |
Searches teams, competitions, players and news. |
OneFootball pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $3.5 / month | 90 / minute |
|
| ULTRA Recommended | $9.5 / month | 240 / minute |
|
| MEGA | $19.5 / month | 360 / minute |
|