Base URL https://v2.basketball.sportsapipro.com
Live Data Live Scores 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 Returns all live events unfiltered with full raw data (nested team objects, detailed match metadata).
Today’s Games Returns all basketball games scheduled for today.
Trending Players 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.
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 Returns all basketball games for a specific date, grouped by tournament.
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 in YYYY-MM-DD format.
Countries & Categories All Countries Returns all basketball categories/countries.
All Countries (Extended) Returns extended categories list with additional metadata.
Category Tournaments GET /api/categories/{categoryId}/tournaments
Returns all tournaments within a specific category (country or region).
Category ID from the countries endpoint.
Country Flag GET /api/country/{code}/flag
Returns the flag image URL for a country code.
Two-letter country code (e.g., US, ES, TR).
News Basketball News GET /api/news?lang={lang}
Returns the latest basketball news articles.
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"
