NBA API

Shot coordinates, advanced box scores, standings and teams.

Game-level NBA detail — play-by-play with court coordinates, shot charts, reconstructed lineups and box scores with computed TS% and USG% — plus standings, teams, rosters, team schedules and team stats.

Compare all plans

Documented routes19

Base path/nba

Hostpropsports-api.sales-fd3.workers.dev

Live cacheLive 10 s

01 Why NBA

Game-level basketball detail — shot coordinates, lineups and advanced box scores.

Built for

Shot-chart visualizationsCourt-coordinate plays ready to plot.
Game-center productsSummary, box score, plays and lineups per game.
Player analysisEfficiency metrics computed per game.
Live score appsSlate and live games.
Team pagesStandings, rosters, schedules and team stats per club.

Shot coordinates

Every made and missed shot with court x/y, plus a ready shot chart.

Reconstructed lineups

On-court five rebuilt from starters and substitutions (estimates, labelled as such).

Advanced box scores

Box scores with computed TS% and USG%.

Win-probability series

ESPN's win-probability series per game, clearly sourced.

Standings and teams

Conference standings, all 30 teams, team profiles, rosters, team schedules and team statistics.

02 Live now

NBA on the network, right now.

A real event read from the same open route customers call, refreshed every 15 seconds. Open it in NBACast for the full live cast.

Connecting…

03 Capabilities

What the NBA API covers.

Schedule & live

Schedule & slate
Live games
Game lines

Play-by-play & game

Plays with coordinates
Shot chart
Box score
Game summary

Players

Player stats
League leaders
Rosters

Teams & standings

Standings
Teams
Team profiles
Rosters
Team schedules
Team stats

Advanced

TS% & USG%
Estimated lineups
Win-probability series
Hustle box

04 Endpoints

19 documented NBA routes.

Every NBA route in the production catalog, all GET on https://propsports-api.sales-fd3.workers.dev.

Schedule & live 3

GET
/nba/scheduleScoreboard by date (playoffs, then regular season)
GET
/nba/schedule/todayToday's slate
GET
/nba/games/liveGames in progress

Game detail 7

GET
/nba/game/:id/summaryGame summary with header
GET
/nba/game/:id/boxscoreNormalized box score with computed TS% and USG%
GET
/nba/game/:id/playsPlay-by-play with court coordinates and event category
GET
/nba/game/:id/shotchartMade and missed shots with x/y coordinates
GET
/nba/game/:id/lineupOn-court five reconstructed from starters and substitutions (estimated)
GET
/nba/game/:id/winprobWin-probability series (ESPN source)
GET
/nba/game/:id/hustleHustle box when the source allows it (may return available:false)

Teams & standings 6

GET
/nba/standingsConference standings
GET
/nba/teamsAll 30 teams
GET
/nba/team/:idTeam profile
GET
/nba/team/:id/rosterCurrent roster
GET
/nba/team/:id/scheduleTeam schedule and results
GET
/nba/team/:id/statsTeam statistics

Players & markets 3

GET
/nba/leadersLeague leaders (?stat, ?season)
GET
/nba/player/:id/statsYear-over-year player stats
GET
/nba/oddsGame lines

05 Example

Example request and response.

Captured from production.

GET

Loading example…

06 Data notes

Depth and availability.

Where the data comes from, and what it deliberately does not claim.

SOURCESESPN game summaries, stats.nba.com and the PropBetEdge NBA data layer (standings, teams, rosters, schedules, team stats)
ACCESSSingle Sport ($29/mo), Developer (up to 3 sports, $79/mo) or any all-sports plan from $149/mo. Every plan that covers NBA includes all 19 routes.
NOTELineups are reconstructed from starters and substitutions and are estimates.
NOTEThe hustle box depends on stats.nba.com access and may return available:false.
NOTEWin probability is the ESPN series, passed through.
NOTEStandings, teams, rosters, team schedules and team stats come from the PropBetEdge NBA data layer.

Build on NBA data

NBA API guide and examples · NBA routes in the API reference

Compare all plans

Other sports