Skip to main content

​
Base URL

https://v2.basketball.sportsapipro.com

​
Live Data

​
Live Scores

GET /api/live
Returns all currently live basketball matches with scores, teams, and status. Use this as the primary source for discovering live match IDs.

​
All Live Events

GET /api/live/all
Returns all live events unfiltered with full raw data.

​
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 All

GET /api/search?q={query}
Search across teams, players, and tournaments simultaneously. Returns entity IDs for use with other endpoints.
​
q
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.
​
date
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.
​
date
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).
​
categoryId
number
required
Category ID from the countries endpoint.

​
Country Flag

GET /api/country/{code}/flag
Returns the flag image URL for a country code.
​
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.
​
lang
string
default:"en"
Language code (e.g., en, es).

​
Example Requests

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

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