Migrating from API-Football - SportsAPI Pro

If you are moving an existing football site or app from API-Football, this table maps the endpoints most projects use to their Football V2 equivalents. Every linked section includes a real recorded response. Base URL: https://api.sportsapipro.com/v2/football. Authenticate with the x-api-key header.

API-Football	Football V2	Notes
`/fixtures?date=`	`/schedule/{date}`	Use `/scheduled-tournaments/{date}` to list every competition playing that day
`/fixtures?live=all`	`/live`	Or the WebSocket feed, which does not count toward your daily limit
`/fixtures?league=&season=`	`/tournament/{tournamentId}/season/{seasonId}/events/last/{page}` and `/events/next/{page}`	30 matches per page; pages can be fetched in parallel
`/fixtures?id=`	`/match/{matchId}`
`/fixtures/statistics`	`/match/{matchId}/statistics`	Per period, 40+ metrics including xG on top leagues
`/fixtures/events`	`/match/{matchId}/incidents`	Goals, cards, substitutions, VAR
`/fixtures/lineups`	`/match/{matchId}/lineups`	Includes per-player match statistics and ratings
`/fixtures/players`	`/match/{matchId}/lineups`	Player match stats are inside the lineup entries
`/fixtures/headtohead`	`/match/{matchId}/h2h`
`/standings`	`/tournament/{tournamentId}/season/{seasonId}/standings`
`/players?id=&season=`	`/players/{playerId}/statistics`
`/players/topscorers`	`/tournament/{tournamentId}/season/{seasonId}/top-players`
`/teams?id=`	`/teams/{teamId}`
`/leagues`	`/categories/{categoryId}/tournaments`	Amateur tiers sit in separate “Amateur” categories
`/odds`	`/match/{matchId}/odds/all`

Extra data with no direct equivalent there: shotmap with coordinates, momentum graph, average positions and text commentary.

Differences to plan for

IDs differ. Match, team, player and competition IDs are our own. Resolve them once through /search and store the mapping.
Times. Every event carries startTimestamp in Unix seconds (UTC).
Status. Use status.type (notstarted, inprogress, finished) and status.code for the exact phase. See the status codes.

See What Data You Get for a one-page tour of real responses.

Last modified on October 24, 2026