Skip to main content

​
Base URL

​
What’s Different in V2?

The V2 Football API provides enhanced data coverage with significantly more endpoints and richer data compared to V1:

~154 Endpoints

Match, Tournament, Team, Player, Manager, Referee, Venue, Rankings, Odds, Fantasy

Advanced Analytics

Shotmaps with xG, heatmaps, momentum graphs, AI-generated match insights

Path Parameters

RESTful path parameters instead of query strings (e.g., /api/match/12345)

WebSocket Support

Real-time live scores via WebSocket at wss://api.sportsapipro.com/v2/football/ws

​
Authentication

Same x-api-key header as V1 — your existing API key works for both versions:

​
V1 vs V2 Comparison

​
League coverage depth

Looking for the list of competitions we carry? See Football Coverage — 6,473 competitions across 272 country and regional categories, identical on every plan (plans only change your daily request quota). That page also documents the separate amateur categories and how far the archive goes tier by tier.
Advanced metrics (shotmaps with xG/xGOT, 40+ match statistics, lineup expectedGoals / expectedAssists, top-player rankings) are available on premium-tier competitions. Verified premium leagues include:
The coverage matrix in Troubleshooting is the single source of truth for which competitions return full player and advanced-metric data. Lower-tier leagues still return fixtures, scores, standings, lineups and basic statistics, but may omit xG and top-player rankings.

​
Important: Entity ID Discovery

Entity IDs (players, matches, teams, venues, referees) are numeric and must be discovered dynamically — never hardcode them.Discovery flow:
  1. Use /api/search?q=arsenal to find team/player IDs
  2. Use /api/live or /api/schedule/{date} to find match IDs
  3. Use /api/match/{id} to extract venue, referee, and player IDs from the response
  4. Use /api/tournaments/{id}/seasons to discover valid season IDs

​
Example responses and Postman collection

Every endpoint on the Football V2 pages has a collapsible Example response recorded from a real call. To try them all at once, download the Postman collection (145 requests, pre-filled with working Bundesliga IDs), set apiKey, and run the collection. The Stats Catalogue lists every stat key.

​
Endpoint Categories

Match (37 endpoints)

Lineups, statistics, shotmaps, AI insights, odds, heatmaps, penalties, highlights

Tournament (32 endpoints)

Standings, top players/teams, brackets, team of the week, media, venues

Team (18 endpoints)

Squad, transfers, performance, goal distributions, statistics, media, featured events

Player (24 endpoints)

Statistics, heatmaps, transfer history, characteristics, penalty history, ratings

Manager / Referee / Venue (10 endpoints)

Manager careers & stats, referee statistics, venue details and events

Global & Search (33 endpoints)

Live scores, search, schedule, trending, countries, leagues, fantasy, news

Rankings

FIFA rankings, rankings by type, featured events

Odds

Featured events with odds, popular events, odds providers

Fantasy

Fantasy player data, fixtures, player of the season awards

​
WebSocket Real-Time

Real-time live scores, match events, statistics, and odds are available via WebSocket with sub-second latency. For full WebSocket documentation including channels, response types, delivery modes, and code examples, see the WebSocket Real-Time API page.

​
Coverage and public overview

Last modified on September 24, 2026