The NBA stats API
Possession-level play-by-play, player props, lineup stints, injuries, referees, and standings — every NBA game from the 2020–21 season through tonight, one Bearer token away.
One call to the season.
Plain REST over HTTPS, keyset pagination, JSON out. The response below is real — game 6006886 is Knicks at Spurs, 2026 NBA Finals.
curl "https://api.stat-api.com/api/v1/nba/games?season_id=2025" \
-H "Authorization: Bearer YOUR_API_KEY"
# → { "games": [ {
# "id": 6006886,
# "game_time": "2026-06-14T00:30:00+00:00",
# "home_team": "SAS", "away_team": "NYK",
# "status": "Final", "season_type": "postseason",
# ... 28 fields per row
# } ], "next_from_id": ... }
Deeper than box scores.
Possession-level play-by-play
4.1M play-by-play rows and 1.6M possession stints with lineups on the floor — who ran the possession, not just what the scoreboard said.
Player props & game lines
Player props, game lines, and period lines per book, linked to the game and player they price — ready to join against actual performance.
Rosters, injuries & depth
Depth charts, injury reports, player news, and coaching staffs — the context that explains the box score.
Referees, broadcasters & standings
Officiating crews per game, broadcast coverage, and daily standings — the long tail most APIs skip.
NBA API questions, answered.
Is there a free NBA API?
Yes — the stat-api free tier includes 50,000 records a month across every league, NBA included, with no card required. Paid tiers start at $49/mo for 5M records.
Does the NBA API include play-by-play?
Yes — possession-level play-by-play: 4.1M event rows and 1.6M possession stints with the lineup on the floor, from the 2020–21 season forward.
Does it cover NBA player props and betting lines?
Yes — player props, game lines, and period lines per sportsbook, keyed to the game and player so you can join prices to results.
Can AI agents and assistants use it?
Yes — an MCP server at api.stat-api.com/mcp (catalog tools need no key), a full OpenAPI 3.1 spec, a public GraphQL schema, and llms.txt. Any MCP client — Claude, ChatGPT, or your own agent — can query NBA data directly.
Start with the free tier.
50,000 records a month, every league, no card. The full NBA reference has live, runnable examples for all 29 tables.