V3 API Overview

Real-time sports data from 34 sports

V3 API

The V3 API provides real-time and historical sports data across 34 sports with rich match data including scores, statistics, lineups, head-to-head records, commentary, odds, and search.

Key Features

• 34 sports — the widest coverage of any SportsAPI Pro version
• REST-only — no WebSocket, optimized for polling with aggressive caching (15s for live data)
• 25 endpoint categories — scores, match details, statistics, lineups, H2H, commentary, odds, team data, search, and more
• Full image URLs — team and league logos are returned as ready-to-use URLs, no image proxy needed

Base URL Pattern

https://v3.{sport}.sportsapipro.com

Examples:

• https://v3.football.sportsapipro.com
• https://v3.tennis.sportsapipro.com
• https://v3.basketball.sportsapipro.com

Authentication

All endpoints require your API key:

curl -H "x-api-key: YOUR_API_KEY" \
  https://v3.football.sportsapipro.com/api/v1/football/live

Quick Start

// Fetch live football scores
const response = await fetch('https://v3.football.sportsapipro.com/api/v1/football/live', {
  headers: { 'x-api-key': 'YOUR_API_KEY' }
});
const data = await response.json();
// data.leagues[].events[] — live match objects

V3 vs V1 vs V2

Feature	V1	V2	V3
Sports	9	25	34
WebSocket	✅	✅	❌
Live cache TTL	5s	1s	15s
Event IDs	Numeric	Numeric	String
Best for	Real-time scores	Deep stats	Widest coverage

Event Status Codes

Code	Status
1	not_started
2	live
3	finished
4	cancelled

Caching Behavior

Endpoint	Cache TTL
Live scores	15 seconds
Today/tomorrow/yesterday	60 seconds
Match summary/statistics	30 seconds
Match lineups	120 seconds
Match H2H/standings	300 seconds
Match commentary	15 seconds
Team transfers/news	300 seconds
Search	No cache