Football Coverage

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

{
  "success": true,
  "total": 4234,
  "leagues": [
    {
      "id": 19115,
      "name": "3. NL - Zapad",
      "slug": "3-nl-zapad",
      "countrySlug": "croatia",
      "countryName": "Croatia",
      "categoryId": 14,
      "hasStandings": false,
      "path": "croatia/3-nl-zapad"
    }
  ]
}

curl -s -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/tournaments" \
| python3 -c "
import csv, json, sys
rows = json.load(sys.stdin)['leagues']
w = csv.writer(sys.stdout)
w.writerow(['id', 'name', 'country', 'slug', 'hasStandings'])
for r in rows:
    w.writerow([r['id'], r['name'], r.get('countryName'), r.get('slug'), r.get('hasStandings')])
" > football-coverage.csv

# All countries / categories (272 entries)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/countries"

# Extended form with subcategories
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/countries/all"

# Competitions inside one category (1 = England)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/categories/1/tournaments"

# Or by country slug
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/leagues?country=netherlands"

# Dutch amateur pyramid (Derde Divisie, Vierde Divisie, 1e-5e Klasse, Districtsbeker)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/categories/1587/tournaments"

# German amateur pyramid (Regionalliga, Oberliga, Kreisoberliga, Kreisklasse)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/categories/122/tournaments"

# 1. Pull every competition ID
curl -s -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/tournaments" > tournaments.json

# 2. Count seasons per competition -> CSV
python3 - <<'PY' > depth.csv
import csv, json, sys, urllib.request
KEY = "YOUR_API_KEY"
rows = json.load(open("tournaments.json"))["leagues"]
w = csv.writer(sys.stdout)
w.writerow(["id", "name", "country", "seasons", "oldest"])
for r in rows:
    url = f"https://api.sportsapipro.com/v2/football/api/tournaments/{r['id']}/seasons"
    req = urllib.request.Request(url, headers={"x-api-key": KEY, "User-Agent": "curl/8"})
    try:
        s = json.load(urllib.request.urlopen(req, timeout=30)).get("seasons", [])
    except Exception:
        s = []
    w.writerow([r["id"], r["name"], r.get("countryName"), len(s), s[-1]["year"] if s else ""])
PY

# A. Derive it from one cheap call, then fan out
GET /api/tournament/37/season/77012/info
# → homeTeamWins 141 + awayTeamWins 95 + draws 85 = 321 finished
#   pages = ceil(321 / 30) = 11

# B. Speculatively request pages 0..N in parallel and stop at the first
#    page that 404s or returns "hasNextPage": false
GET /api/tournament/37/season/77012/events/last/0   → 30 events, hasNextPage true
...
GET /api/tournament/37/season/77012/events/last/10  → 25 events, hasNextPage false
GET /api/tournament/37/season/77012/events/last/11  → 404 (end of list)

# Competitions with matches in progress right now
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/live-tournaments"

# Competitions with matches on a given date
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/scheduled-tournaments/2026-08-31"

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/football/api/venue/2325

{
  "venue": {
    "id": 2325,
    "name": "Stadionul Gaz Metan",
    "capacity": 7814,
    "city": { "name": "Medias", "country": { "alpha2": "RO", "name": "Romania" } },
    "venueCoordinates": { "latitude": 46.172346, "longitude": 24.352697 }
  }
}

GET /api/tournaments/{uniqueTournamentId}/seasons

GET /api/tournament/{tournamentId}/season/{seasonId}/events/last/{page}   # played
GET /api/tournament/{tournamentId}/season/{seasonId}/events/next/{page}   # scheduled

GET /api/tournament/{tournamentId}/season/{seasonId}/knockout   # alias: /cuptrees

{
  "changes": {
    "changes": ["status.code", "status.description", "status.type", "awayScore.normaltime"],
    "changeTimestamp": 1787415982
  }
}

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/api/newly-added-events"

GET /api/tournaments/{uniqueTournamentId}/seasons   # 1 request per competition