Quick Start

Get Your API Key

Create an Account

Access Dashboard

Navigate to your dashboard after logging in

Copy API Key

Find your API key in the API Credentials section and copy it

Your API key works across all 25+ sports APIs. The same key is used for Football, Basketball, Tennis, Baseball, and every other supported sport.

Your First API Call

All V2 endpoints use the pattern https://v2.{sport}.sportsapipro.com/api/{endpoint}. Authentication is via the x-api-key header.

Get Live Football Scores

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

const response = await fetch("https://api.sportsapipro.com/v2/football/live", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const data = await response.json();
console.log(`${data.count} live matches`);
data.events.forEach(e => {
  console.log(`${e.homeTeam} ${e.homeScore} - ${e.awayScore} ${e.awayTeam} (${e.status})`);
});

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 client honestly
    },
    timeout=30,
)
data = response.json()
for event in data.get("events", []):
    print(f"{event['homeTeam']} {event['homeScore']} - {event['awayScore']} {event['awayTeam']} ({event['status']})")

Response (Football `/api/live`)

{
  "count": 58,
  "events": [
    {
      "id": 15269945,
      "homeTeam": "Charlotte FC",
      "awayTeam": "Nashville SC",
      "homeScore": 1,
      "awayScore": 2,
      "status": "2nd half",
      "tournament": "MLS",
      "slug": "charlotte-fc-nashville-sc",
      "startTimestamp": 1775950200
    }
  ]
}

Football’s /api/live returns a simplified format with flat score values. Other sports (Basketball, Baseball, Tennis) return enhanced formats with score breakdowns — see examples below.

Multi-Sport Examples

Basketball — Live Scores with Quarter Breakdown

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

const response = await fetch("https://api.sportsapipro.com/v2/basketball/live", {
  headers: { "x-api-key": "YOUR_API_KEY" }
});
const data = await response.json();
data.events.forEach(e => {
  console.log(`${e.homeTeam} ${e.homeScore.current} - ${e.awayScore.current} ${e.awayTeam}`);
  console.log(`  Q1: ${e.homeScore.period1}-${e.awayScore.period1}, Q2: ${e.homeScore.period2}-${e.awayScore.period2}`);
});

{
  "count": 22,
  "events": [
    {
      "id": 15714288,
      "homeTeam": "ADS Sentinels",
      "homeTeamId": 1176741,
      "awayTeam": "Little Rock Lightning",
      "awayTeamId": 1078133,
      "homeScore": { "current": 63, "display": 63, "period1": 25, "period2": 29, "period3": 9 },
      "awayScore": { "current": 50, "display": 50, "period1": 18, "period2": 23, "period3": 9 },
      "status": "3rd quarter",
      "statusCode": 15,
      "tournament": "The Basketball League, Regular Season",
      "tournamentId": 25249,
      "season": "2026",
      "seasonId": 90882,
      "startTimestamp": 1775952000
    }
  ]
}

Baseball — Live Scores with Innings

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

{
  "count": 6,
  "events": [
    {
      "id": 15507550,
      "homeTeam": { "id": 3630, "name": "Milwaukee Brewers" },
      "awayTeam": { "id": 5930, "name": "Washington Nationals" },
      "homeScore": {
        "current": 0,
        "display": 0,
        "innings": {
          "inning1": { "run": 0 }, "inning2": { "run": 0 }, "inning3": { "run": 0 },
          "inning4": { "run": 0 }, "inning5": { "run": 0 }, "inning6": { "run": 0 },
          "inning7": { "run": 0 }, "inning8": { "run": 0 }, "inning9": { "run": 0 }
        },
        "inningsBaseball": { "errors": 3, "hits": 1, "run": 0 },
        "period1": 0, "period2": 0, "period3": 0, "period4": 0, "period5": 0,
        "period6": 0, "period7": 0, "period8": 0, "period9": 0
      },
      "status": { "code": 29, "description": "9th Inning", "type": "inprogress" },
      "tournament": "MLB",
      "tournamentId": 11205,
      "season": "MLB 2026",
      "seasonId": 84695,
      "startTimestamp": 1775949000
    }
  ]
}

Tennis — Live Scores with Point & Set Data

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

{
  "data": {
    "events": [
      {
        "id": 15988472,
        "homeTeam": {
          "id": 301986,
          "name": "Jack Clements",
          "country": { "alpha2": "AU", "name": "Australia" },
          "gender": "M"
        },
        "awayTeam": {
          "id": 1122567,
          "name": "Robin Eldin",
          "country": { "alpha2": "FR", "name": "France" },
          "gender": "M"
        },
        "homeScore": { "current": 1, "display": 1, "period1": 7, "period2": 1, "point": "40" },
        "awayScore": { "current": 0, "display": 0, "period1": 5, "period2": 0, "point": "15" },
        "firstToServe": 2,
        "groundType": "Hardcourt outdoor"
      }
    ]
  }
}

Tennis-specific fields: point (current game point: “0”, “15”, “30”, “40”, “AD”), firstToServe (1=home, 2=away), groundType (surface type). Set scores appear as period1–period5.

Check Your Usage

Monitor your API usage with the /status endpoint:

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

{
  "success": true,
  "api": "SportsAPI Pro - Football V2 (Enhanced)",
  "version": "v2",
  "account": {
    "email": "[email protected]",
    "name": "Your Name",
    "plan": "Pro",
    "member_since": "2025-01-15T10:30:00Z"
  },
  "usage": {
    "daily_limit": 7500,
    "remaining": 7255,
    "requests_today": 245,
    "reset_at": "2026-04-13T00:00:00.000Z"
  }
}

Usage is tracked across all sports APIs. Your daily limit is shared across Football, Basketball, Tennis, and every other sport.

Search for Teams, Players & Tournaments

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v2/football/search?q=arsenal"

{
  "data": {
    "results": [
      {
        "type": "team",
        "score": 4923659,
        "entity": {
          "id": 42,
          "name": "Arsenal",
          "slug": "arsenal",
          "country": { "alpha2": "EN", "name": "England" },
          "teamColors": { "primary": "#cc0000", "secondary": "#ffffff", "text": "#ffffff" },
          "gender": "M",
          "userCount": 3303460
        }
      },
      {
        "type": "player",
        "score": 453220.3,
        "entity": {
          "id": 934235,
          "name": "Bukayo Saka",
          "position": "F",
          "jerseyNumber": "7",
          "team": { "id": 42, "name": "Arsenal" }
        }
      }
    ]
  }
}

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

{
  "data": {
    "categories": [
      {
        "id": 1,
        "name": "England",
        "slug": "england",
        "alpha2": "EN",
        "flag": "england",
        "priority": 10,
        "sport": { "id": 1, "name": "Football", "slug": "football" }
      }
    ]
  }
}

Common V2 Endpoint Patterns

All V2 sports share the same endpoint structure:

Endpoint	Description
`GET /api/live`	Currently live matches (simplified)
`GET /api/today`	Today’s full schedule (detailed)
`GET /api/schedule/{date}`	Schedule by date (YYYY-MM-DD)
`GET /api/search?q={query}`	Search teams, players, tournaments
`GET /api/countries`	Country/category list
`GET /api/match/{id}`	Full match details
`GET /api/match/{id}/statistics`	Match statistics
`GET /api/match/{id}/lineups`	Match lineups
`GET /api/match/{id}/incidents`	Match events/incidents
`GET /api/match/{id}/odds`	Match betting odds
`GET /api/tournament/{id}/info`	Tournament details
`GET /api/tournaments/{id}/seasons`	Tournament seasons (football uses plural `tournaments`; most other V2 sports use singular `tournament`)
`GET /api/teams/{id}`	Team details
`GET /api/players/{id}`	Player details
`GET /status`	Account status & usage

V2 endpoints use /api/live, not /api/football/live. The sport is determined by the subdomain (v2.football.sportsapipro.com), not the URL path.

Next Steps

Authentication

Security best practices for API key management

API Reference

Full endpoint documentation for all sports

V1 API (Fastest)

1–2s score latency with WebSocket support

Rate Limits

Understand usage quotas and rate limits

Getting Started

Core Concepts

Updates

Get Your API Key

Your First API Call

Get Live Football Scores

Response (Football `/api/live`)

Multi-Sport Examples

Basketball — Live Scores with Quarter Breakdown

Baseball — Live Scores with Innings

Tennis — Live Scores with Point & Set Data

Check Your Usage

Search for Teams, Players & Tournaments

Common V2 Endpoint Patterns

Next Steps

Authentication

API Reference

V1 API (Fastest)

Rate Limits

​Get Your API Key

​Your First API Call

​Get Live Football Scores

​Response (Football /api/live)

​Multi-Sport Examples

​Basketball — Live Scores with Quarter Breakdown

​Baseball — Live Scores with Innings

​Tennis — Live Scores with Point & Set Data

​Check Your Usage

​Search for Teams, Players & Tournaments

​Get Country/Category List

​Common V2 Endpoint Patterns

​Next Steps

Authentication

API Reference

V1 API (Fastest)

Rate Limits

Get Your API Key

Your First API Call

Get Live Football Scores

Response (Football `/api/live`)

Multi-Sport Examples

Basketball — Live Scores with Quarter Breakdown

Baseball — Live Scores with Innings

Tennis — Live Scores with Point & Set Data

Check Your Usage

Search for Teams, Players & Tournaments

Get Country/Category List

Common V2 Endpoint Patterns

Next Steps