Skip to main content

​
Base URL

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

​
V1 vs V2 Comparison

​
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

​
Seasonal Aggregate Player Stats

GET /api/players/{playerId}/statistics returns seasonal aggregate totals (points, assists, rebounds, steals, blocks, shooting splits and advanced metrics) broken down per season, per competition and per stage, with appearances for deriving per-game averages such as PPG, RPG and APG. Discover the available seasons with /api/players/{playerId}/statistics/seasons. See Player Endpoints.

​
League Stat Leaders

V2 has no season-wide leaderboard for basketball (no top-players, no season player-statistics). To fetch many players at once, use V1: GET /v1/basketball/competition/{competitionId}/stats returns seven player leader tables (Points, Assists, Rebounds, Steals, Turnovers, Blocks, Fouls — per game, top 20 each) and ten team tables in a single response. Same API key and quota. See V1 Competitions — basketball stat leaders.

​
Key Basketball IDs for Testing

​
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

​
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
Last modified on September 23, 2026