V1 Quickstart

The V1 API covers 9 sports behind one auth key, with sub-100ms responses and a real-time WebSocket. This page gets you to a working call quickly.

1. Get your API key

2. Pick a base URL

https://api.sportsapipro.com/v1/{sport}

{sport} is one of: football, basketball, tennis, hockey, handball, american-football, baseball, volleyball, rugby.

3. Your first call — live scores

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

const res = await fetch(
  'https://api.sportsapipro.com/v1/football/live',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const { success, data } = await res.json();
console.log(`${data.games.length} live games`);

import requests
r = requests.get(
    'https://api.sportsapipro.com/v1/football/live',
    headers={'x-api-key': 'YOUR_API_KEY'},
)
print(r.json()['data']['games'])

Response envelope

Every V1 endpoint returns the same wrapper:

{
  "success": true,
  "type": "live",
  "cacheHit": false,
  "sport": "football",
  "data": { "games": [], "competitions": [], "countries": [] }
}

See Response Format for the full envelope, status codes, and cache TTLs.

4. Open the WebSocket

const ws = new WebSocket(
  'wss://api.sportsapipro.com/v1/football/ws?x-api-key=YOUR_API_KEY'
);
ws.onopen = () => ws.send(JSON.stringify({ type: 'subscribe', channel: 'live' }));
ws.onmessage = (e) => console.log(JSON.parse(e.data));

Full protocol: WebSocket.

Where to next

Scores

Live, scheduled, and date-range scores across all 9 sports.

Game Detail

Events, lineups, stats, venue, play-by-play, predictions.

Competitions

Standings, results, brackets, transfers, top scorers.

Recipes

Copy-paste snippets for tickers, tables, and match pages.

V1 and V2 share the same key. Use V1 when you need the fastest score updates; reach for V2 when you need deeper data like fantasy, rankings, or detailed odds.

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

1. Get your API key

2. Pick a base URL

3. Your first call — live scores

Response envelope

4. Open the WebSocket

Where to next

Scores

Game Detail

Competitions

Recipes

​1. Get your API key

​2. Pick a base URL

​3. Your first call — live scores

​Response envelope

​4. Open the WebSocket

​Where to next

Scores

Game Detail

Competitions

Recipes

1. Get your API key

2. Pick a base URL

3. Your first call — live scores

Response envelope

4. Open the WebSocket

Where to next