Overview
The V1 API provides real-time and historical sports data for 9 sports with 30+ REST endpoints and WebSocket for live score updates.
Key features:
- ⚡ Sub-100ms response times — pure JSON API, no rendering overhead
- 🔌 WebSocket real-time — adaptive 1-3s update interval for live scores
- 🌍 9 sports — Football, Basketball, Tennis, Hockey, Handball, American Football, Baseball, Volleyball, Rugby
- 📊 Full coverage — scores, standings, stats, brackets, news, transfers, play-by-play, lineups, H2H
Base URL Pattern: https://v1.{sport}.sportsapipro.comAll requests require the x-api-key header with your API key.
Supported Sports
| Sport | Base URL | Sport ID |
|---|
| Football | https://v1.football.sportsapipro.com | 1 |
| Basketball | https://v1.basketball.sportsapipro.com | 2 |
| Tennis | https://v1.tennis.sportsapipro.com | 3 |
| Hockey | https://v1.hockey.sportsapipro.com | 4 |
| Handball | https://v1.handball.sportsapipro.com | 5 |
| American Football | https://v1.american-football.sportsapipro.com | 6 |
| Baseball | https://v1.baseball.sportsapipro.com | 7 |
| Volleyball | https://v1.volleyball.sportsapipro.com | 8 |
| Rugby | https://v1.rugby.sportsapipro.com | 9 |
Authentication
Include your API key in the request header:
curl -X GET "https://v1.football.sportsapipro.com/api/v1/football/live" \
-H "x-api-key: YOUR_API_KEY"
Quick Start
curl -H "x-api-key: YOUR_API_KEY" \
https://v1.football.sportsapipro.com/api/v1/football/live
V1 vs V2 Comparison
| Feature | V1 | V2 |
|---|
| Sports covered | 9 | 25+ |
| Response time | Sub-100ms | ~200ms |
| WebSocket | ✅ Adaptive 1-3s polling | ✅ NATS relay |
| Score latency | 1-2 seconds | 3-7 seconds |
| Endpoint count | 30+ per sport | 80-100+ per sport |
| Data depth | Scores, standings, stats, lineups, H2H | + Fantasy, odds, rankings, detailed player data |
| Active development | ✅ Yes | ✅ Yes |
When to use V1 vs V2:
- Use V1 when you need the fastest possible score updates and core match data
- Use V2 when you need deeper data (fantasy, detailed odds, player career stats, rankings)
Both APIs use the same API key and x-api-key header. Next Steps
Support
Need help? Contact us at support@sportsapipro.com
