Global, Search & Schedule Endpoints

Base URL

https://api.sportsapipro.com/v2/basketball

Live Data

Live Scores

GET /api/live

Returns all currently live basketball matches with quarter-by-quarter scores, teams, and status. Use this as the primary source for discovering live match IDs.

Example Response — /api/live

{
  "success": true,
  "count": 18,
  "events": [
    {
      "id": 15972577,
      "homeTeam": "Admirals Basketball Academy U20",
      "homeTeamId": 1157137,
      "awayTeam": "TEAM 7 U20",
      "awayTeamId": 1137861,
      "homeScore": {
        "current": 96,
        "display": 96,
        "period1": 20,
        "period2": 31,
        "period3": 21,
        "period4": 24
      },
      "awayScore": {
        "current": 74,
        "display": 74,
        "period1": 15,
        "period2": 14,
        "period3": 27,
        "period4": 18
      },
      "status": "Pause",
      "statusCode": 30,
      "tournament": "EYBL U20, CHALLENGE CUP",
      "tournamentId": 29909,
      "season": "25/26",
      "seasonId": 83999,
      "startTimestamp": 1775892600
    }
  ],
  "timezone": { "name": "UTC", "source": "default", "utcOffset": "+00:00" }
}

Basketball-specific fields: Score objects include period1-period4 for quarters, plus current and display totals. The statusCode field is a numeric status (e.g., 30 = Pause). Team IDs (homeTeamId, awayTeamId) and tournament/season IDs are included in the live response for easy cross-referencing.

All Live Events

GET /api/live/all

Returns all live events unfiltered with full raw data (nested team objects, detailed match metadata).

Today’s Games

GET /api/today

Returns all basketball games scheduled for today.

GET /api/trending-players

Returns currently trending basketball players based on recent performance.

Live Tournaments

GET /api/live-tournaments

Returns tournaments that currently have live games in progress.

Search

Search All

GET /api/search?q={query}

Search across teams, players, and tournaments simultaneously. Returns entity IDs for use with other endpoints.

string

required

Search query (e.g., lakers, lebron, nba). Minimum 2 characters.

This is the primary way to discover entity IDs for teams, players, and tournaments.

Schedule

Events by Date

GET /api/schedule/{date}

Returns all basketball games for a specific date, grouped by tournament.

string

required

Date in YYYY-MM-DD format (e.g., 2025-03-15).

Scheduled Tournaments by Date

GET /api/scheduled-tournaments/{date}

Returns tournaments that have games on a specific date — useful for building a competition filter.

string

required

Date in YYYY-MM-DD format.

Countries & Categories

All Countries

GET /api/countries

Returns all basketball categories/countries.

All Countries (Extended)

GET /api/countries/all

Returns extended categories list with additional metadata.

Category Tournaments

GET /api/categories/{categoryId}/tournaments

Returns all tournaments within a specific category (country or region).

number

required

Category ID from the countries endpoint.

Country Flag

GET /api/country/{code}/flag

Returns the flag image URL for a country code.

string

required

Two-letter country code (e.g., US, ES, TR).

News

Basketball News

GET /api/news?lang={lang}

Returns the latest basketball news articles.

string

default:"en"

Language code (e.g., en, es).

Example Requests

# Search for a team
curl -X GET "https://api.sportsapipro.com/v2/basketball/search?q=lakers" \
  -H "x-api-key: YOUR_API_KEY"

# Get today's schedule
curl -X GET "https://api.sportsapipro.com/v2/basketball/schedule/2025-03-15" \
  -H "x-api-key: YOUR_API_KEY"

const results = await fetch(
  'https://api.sportsapipro.com/v2/basketball/search?q=lakers',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

import requests

headers = {'x-api-key': 'YOUR_API_KEY'}

results = requests.get(
    'https://api.sportsapipro.com/v2/basketball/search?q=lakers',
    headers=headers
).json()

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

Global, Search & Schedule Endpoints

Base URL

Live Data

Live Scores

All Live Events

Today’s Games

Live Tournaments

Search

Search All

Schedule

Events by Date

Scheduled Tournaments by Date

Countries & Categories

All Countries

All Countries (Extended)

Category Tournaments

Country Flag

News

Basketball News

Example Requests

​Base URL

​Live Data

​Live Scores

​All Live Events

​Today’s Games

​Trending Players

​Live Tournaments

​Search

​Search All

​Schedule

​Events by Date

​Scheduled Tournaments by Date

​Countries & Categories

​All Countries

​All Countries (Extended)

​Category Tournaments

​Country Flag

​News

​Basketball News

​Example Requests

Base URL

Live Data

Live Scores

All Live Events

Today’s Games

Trending Players

Live Tournaments

Search

Search All

Schedule

Events by Date

Scheduled Tournaments by Date

Countries & Categories

All Countries

All Countries (Extended)

Category Tournaments

Country Flag

News

Basketball News

Example Requests