Football V2 API Overview

Enhanced Football API with 147+ endpoints — shotmaps, AI insights, player heatmaps, tournament brackets, WebSocket live scores, and more

Base URL

https://v2.football.sportsapipro.com

What’s Different in V2?

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

147+ 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://v2.football.sportsapipro.com/ws

Authentication

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

curl -X GET "https://v2.football.sportsapipro.com/api/live" \
  -H "x-api-key: YOUR_API_KEY"

V1 vs V2 Comparison

Feature	V1	V2
Base URL	v1.football.sportsapipro.com	v2.football.sportsapipro.com
Parameter style	Query strings (?gameId=123)	Path parameters (/api/match/123)
Match endpoints	12	39
Player endpoints	6	22
Team endpoints	8	17
Tournament endpoints	5	28
Shotmaps & xG	❌	✅
AI Insights	❌	✅
Player Heatmaps	❌	✅
Manager/Referee Data	❌	✅
Venue Data	❌	✅
WebSocket Live	❌	✅
Fantasy Data	❌	✅

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

Endpoint Categories

Match (39 endpoints)

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

Tournament (28 endpoints)

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

Team (17 endpoints)

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

Player (22 endpoints)

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

Manager / Referee / Venue

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

Global & Search

Live scores, search, schedule, trending, countries, leagues, 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.