Skip to main content

​
Base URL

https://v2.basketball.sportsapipro.com

​
What’s Different in V2?

The V2 Basketball API provides enhanced data coverage with significantly more endpoints and richer data compared to V1:

115 Endpoints

Match, Tournament, Team, Player, Manager, Referee, Venue

Rich Box Scores

Period-by-period scoring (Q1-Q4, OT), full player stats, momentum graphs

Path Parameters

RESTful path parameters instead of query strings (e.g., /api/match/12345)

Conference Standings

Eastern/Western conference standings, home/away splits, playoff brackets

​
Authentication

Same x-api-key header as V1 — your existing API key works for both versions: 
curl -X GET "https://v2.basketball.sportsapipro.com/api/live" \
  -H "x-api-key: YOUR_API_KEY"

​
V1 vs V2 Comparison

FeatureV1V2
Base URLv1.basketball.sportsapipro.comv2.basketball.sportsapipro.com
Parameter styleQuery strings (?gameId=123)Path parameters (/api/match/123)
Match endpoints627
Player endpoints318
Team endpoints215
Tournament endpoints327
Box Scores (Q1-Q4)❌✅
Play-by-Play❌✅
Momentum Graphs❌✅
Manager/Referee Data❌✅
Venue Data❌✅
Playoff Brackets❌✅

​
Important: Entity ID Discovery

Entity IDs (players, matches, teams, venues, referees) are numeric and must be discovered dynamically — never hardcode them.Discovery flow:
  1. Use /api/search?q=lakers to find team/player IDs
  2. Use /api/live or /api/schedule/{date} to find match IDs
  3. Use /api/match/{id} to extract venue, referee, and player IDs from the response
  4. Use /api/tournament/{id}/seasons to discover valid season IDs

​
Key Basketball IDs for Testing

EntityNameID
TournamentNBA132
SeasonNBA 24/2562498
TeamLos Angeles Lakers3427
PlayerLeBron James817181

​
Key Differences from Football

Scoring: Basketball uses period1, period2, period3, period4, overtime, normaltime, and current fields in the score object — unlike football which uses halftime periods.Lineups: Starting 5 + bench (not 11 as in football).Incidents: Include baskets, fouls, free throws, and timeouts (not goals/cards).Standings: Typically have conference groups (Eastern/Western for NBA) instead of a single table.No shotmap or heatmap endpoints — these are football-specific features.Positions: G (Guard), F (Forward), C (Center) instead of football positions.

​
Endpoint Categories

Live & Schedule (7)

Live scores, today’s games, schedule by date, trending players

Search & Discovery (6)

Search, countries, categories, news, country flags

Tournament (27)

Standings, top players/teams, brackets, team of the week, venues

Match (27)

Scores, lineups, statistics, incidents, odds, momentum graph

Player (18)

Statistics, transfer history, characteristics, ratings, events

Team (15)

Roster, transfers, performance, media, season stats

Manager / Referee / Venue (15)

Coach careers, referee stats, arena details, event history

​
Example Requests

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

​
UI Design Ideas

  • Score display: Show Q1-Q4 with totals, highlight current quarter during live games
  • Box scores: Full player stat lines (PTS, REB, AST, STL, BLK, FG%, 3P%, FT%)
  • Standings: Conference tables (Eastern/Western), show W-L record, PCT, GB
  • Playoff bracket: Show 4 rounds (First Round → Conf Semis → Conf Finals → Finals)
  • Player profile: Position (G/F/C), height, weight, jersey number, draft info