const response = await fetch(
  'https://api.sportsapipro.com/v2/football/match/12345678/statistics',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

// Safe way to extract statistics
const stats = data?.statistics || [];

// Check if match has statistics available
if (stats.length === 0) {
  console.log('Statistics not yet available — match may not have started.');
}

// Step 1: Get available seasons for a tournament
const seasons = await fetch(
  'https://api.sportsapipro.com/v2/football/tournaments/17/seasons',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

// Step 2: Use the latest season ID
const latestSeason = seasons.seasons[0];

// Step 3: Fetch top players with valid IDs
const topPlayers = await fetch(
  `https://api.sportsapipro.com/v2/football/tournament/17/season/${latestSeason.id}/top-players`,
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

// Premium tier competitions have 40+ stat types
const premiumTournaments = [17, 8, 35, 23, 34, 37, 238, 7, 679];

// Check if the match's tournament is premium before expecting detailed data
const matchDetails = await fetch(
  'https://api.sportsapipro.com/v2/football/match/12345678',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

const tournamentId = matchDetails?.event?.tournament?.uniqueTournament?.id;
const hasDetailedStats = premiumTournaments.includes(tournamentId);

if (hasDetailedStats) {
  // Fetch detailed lineups — will include xG, tackles, interceptions, etc.
  const lineups = await fetch(
    'https://api.sportsapipro.com/v2/football/match/12345678/lineups',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  ).then(r => r.json());
}

# NFL fixtures for a date (V2 — richest schedule data)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/american-football/schedule/2026-09-21"

# American football live / all / current (V1)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v1/american-football/live"

# Boxing — V3 is the only version with boxing
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v3/boxing/today"

// Get tournament details
const tournament = await fetch(
  'https://api.sportsapipro.com/v2/football/tournaments/17/seasons',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

console.log({
  seasons: tournament.seasons,  // All available seasons
});

// Check if standings are available for a specific season
const standings = await fetch(
  'https://api.sportsapipro.com/v2/football/tournament/17/season/76986/standings',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

console.log({
  hasStandings: !!standings?.standings,
});

const headers = { 'x-api-key': 'YOUR_API_KEY' };
const base = 'https://api.sportsapipro.com/v2/football';

// 1. Get the numeric seasonId
const { seasons } = await fetch(
  `${base}/api/tournaments/242/seasons`, { headers }
).then(r => r.json());
const seasonId = seasons[0].id; // e.g. 61644 — NOT "2024"

// 2. Use it in the path
const matches = await fetch(
  `${base}/api/tournament/242/season/${seasonId}/events/last/0`, { headers }
).then(r => r.json());

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

import requests

response = requests.get(
    "https://api.sportsapipro.com/v2/football/live",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "User-Agent": "MyApp/1.0",  # identify your own application honestly
        "Accept": "application/json",
    },
    timeout=30,
)
data = response.json()
print(data["count"])

import json
import urllib.request

req = urllib.request.Request(
    "https://api.sportsapipro.com/v2/football/live",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "User-Agent": "MyApp/1.0",  # do not impersonate a browser; use your app name
        "Accept": "application/json",
    },
)
with urllib.request.urlopen(req, timeout=30) as resp:
    data = json.load(resp)

print(data["count"])

// Exponential backoff example
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s
      await new Promise(resolve => setTimeout(resolve, waitTime));
      continue;
    }
    
    return response;
  }
  throw new Error('Max retries exceeded');
}

import time, requests

def get(url, key, attempts=3):
    for i in range(attempts):
        r = requests.get(url, headers={"x-api-key": key, "User-Agent": "MyApp/1.0"}, timeout=30)
        if r.status_code < 500:
            return r
        time.sleep(0.5 * (2 ** i))   # 0.5s, 1s, 2s
    return r