Skip to content
DunkAPI

NBA APINBA player props by sportsbook, with the result.

Closing prop lines by sportsbook since May 2023 for points, rebounds, assists, threes, blocks and steals, each with the player's record against his line. Underneath them, NBA play-by-play since 2003-04 with every shot located, box scores and game odds, plus the WNBA and college basketball. Call it over REST or MCP.

500 free credits every month, no card. Works in Claude, ChatGPT and Cursor: connect over MCP

plays
14.6M+
games
32,000+
players
3,900+
seasons
24

Underneath them, NBA play-by-play since 2003-04 with every shot located, box scores and game odds, plus the WNBA and college basketball. Call it over REST or MCP.

Try it

One request, JSON back.

Copy the call, put your key in, run it. get_player_props costs 10 credits, and every account starts with 500 free credits every month, no card.

Request

curl -X POST https://mcp.dunkapi.com/v1/get_player_props \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "401909918",
  "market": "player_points",
  "bookmaker": "draftkings"
}'

Response

json
{
  "snapshot_type": "closing",
  "games": 1,
  "props": [
    {
      "game_id": "401909918",
      "game_date": "2026-11-02",
      "player_name": "Aaron Gordon",
      "player_id": "3064290",
      "market": "player_points",
      "bookmaker": "draftkings",
      "line": 13.5,
      "over_odds": -113,
      "under_odds": -113,
      "captured_at": "2026-11-03T01:05:39.626Z",
      "scheduled_start": "2026-11-03T02:00:00.000Z",
      "minutes_before_scheduled_start": 54.3,
      "source": "archive"
    },
    {
      "game_id": "401909918",
      "game_date": "2026-11-02",
  ...

First 22 lines. Full response and every field

Also in DunkAPI

The WNBA API

Women's National Basketball Association, every season since 2006: play-by-play, shot locations, standings, sportsbook lines and season lines. Same key and credits as the NBA.

WNBA API: see the data
games
4,995
plays
1,936,436
seasons
21

Also in DunkAPI

The college basketball API

NCAA Division I men's basketball, every season since 2013-14: play-by-play, standings, sportsbook lines and season lines. Same key and credits as the NBA.

NCAAM API: see the data
games
78,121
plays
25,310,159
seasons
14

Also in DunkAPI

The women's college basketball API

NCAA Division I women's basketball, every season since 2014-15: play-by-play, standings, sportsbook lines and season lines. Same key and credits as the NBA.

NCAAW API: see the data
games
67,805
plays
16,685,751
seasons
13

Also in DunkAPI

The NBL API

National Basketball League (Australia and New Zealand), every season since 2023: play-by-play, shot locations, standings, sportsbook lines and season lines. Same key and credits as the NBA.

NBL API: see the data
games
722
plays
246,578
seasons
5

This week

What get_schedule returns right now.

Rendered from the same rows get_schedule returns, refreshed every hour. Lines are the median closing number across sportsbooks.

Tip-offAwayHomeLineTotalGame id
Sun 3:30 PM ETDETATLDET -1.75224401910029
Sun 6:00 PM ETOKCMIAMIA -3.5231.5401910030
Sun 7:00 PM ETORLWSHORL -4.75219.5401910031
Sun 7:00 PM ETDENCHIDEN -8.75237.5401910032
Sun 7:00 PM ETDALUTAHDAL -1.25225.5401910033
Sun 8:00 PM ETINDNYNY -8.5213.5401910034

get_schedule · 2 credits · then get_game for the box scores and every book's line

Coverage

Coverage you can inspect before you build.

Play-by-play
Since 2003-04

Play-by-play for NBA games since 2003-04, with the location of every shot in it.

Sportsbook lines
4 to 12 books

Each sportsbook's moneyline, spread and total: 4 to 12 books per regular-season NBA game from 2013-14 to 2023-24 (10 to 12 from 2020-21), opening and closing lines from 6 to 8 books per game since July 2020, 4 to 10 for most men's college seasons, and a median of 4 for women's college games since November 2024.

Leagues
NBA, WNBA, college

The WNBA since 2006 and Division I men's (from 2013-14) and women's (from 2014-15) college basketball, on the same tools.

DatasetSeasonsVolumeStatusTools
Games and box scores
Scores, both teams' box scores and every player's line: minutes, points, shooting, rebounds, assists, steals, blocks, turnovers, fouls, plus-minus.
2003-04 to currentEvery game, every playerPartial
About one game in eight from 2012-13 to 2017-18 has no box score in the source; those lines are counted from the play-by-play (97-100% exact where checked), without minutes or plus-minus. 26 games have a box score but no play-by-play.
Play-by-play
Every play with clock, score, players involved, shot type and points.
2003-04 to currentAbout 450 plays per NBA gameFull
Shot locations
Each shot's x/y in feet, distance, zone and our expected points.
2003-04 to currentEvery field goal attemptFull
Win probability
The home team's win probability after each play, as computed upstream, not by us.
2018 to currentAfter every playPartial
From 2017-18 only.
Odds
Moneyline, spread and total by sportsbook; opening and closing lines from July 2020 (sportsbook odds archive), the final pregame line only in the earlier seasons.
2013-14 to current4 to 12 books per regular-season game to 2023-24; 6 to 8 with opening and closing lines since July 2020Partial
No lines before 2012-13; opening and closing lines from July 2020; player props are separate (get_player_props, from May 2023).
Ratings
Our Elo, before and after every game.
2003-04 to currentEvery team, every gameFull
Injury report
Each listed player's status, injury and expected return, captured daily (NBA and WNBA).
From launchDailyPartial
Daily captures from launch; no history before that.

Full detail in the data atlas. Sportsbooks: the books reported with each game: 4 to 12 per regular-season NBA game from 2013-14 to 2023-24, 10 to 12 from 2020-21 (DraftKings, Caesars, BetMGM, Unibet and Betfair among them in 2023-24), plus up to eight books with opening and closing lines since July 2020, among them DraftKings, FanDuel, BetMGM, ESPN BET and Pinnacle. No lines before 2012-13, and the daily feed is one or two books a game since 2024-25; the other books come from the sportsbook odds archive.

Last written 2026-11-22 15:05 UTC. Every dataset's own refresh time is in the changelog.

Why trust it

The parts of basketball data that take real work.

Box scores are everywhere. Shot locations joined to a value model, a decade of lines by book, and four leagues on one schema are where shortcuts show.

Every shot

Located, zoned and valued

Every NBA field goal attempt since 2003-04 carries its spot on the floor in feet, its zone and our expected points for that type of shot from that distance, fitted on the league's own history. A shot chart is one call, not a scraping project.

4 to 12 books

A decade of lines, by sportsbook

Moneylines, spreads and totals from 4 to 12 sportsbooks per NBA game from 2013-14 to 2023-24 (10 to 12 from 2020-21), opening and closing lines from 6 to 8 books since July 2020, and most college seasons, each stored separately, with results against the median close. Enough history to backtest a model across eras, not just last season.

4 leagues

The same tools, one argument apart

The NBA, the WNBA and men's and women's Division I college basketball share one set of endpoints. Pass league and the same box scores, play-by-play, standings and ratings come back for that league, each kept in its own tables.

Tools

Every tool, and what a call costs.

Every tool is one REST endpoint and one MCP tool with the same name, the same parameters, and a fixed credit cost. Empty results are not charged.

Access

REST or MCP. Same data either way.

Call it from any language over REST. Let Claude or Cursor query it in plain English over MCP.

  • GET https://mcp.dunkapi.com/v1/tools public catalogue with JSON Schema
  • GET https://mcp.dunkapi.com/openapi.json OpenAPI 3.1 spec
  • POST https://mcp.dunkapi.com/v1/{tool}
  • MCP https://mcp.dunkapi.com/mcp
curl -X POST https://mcp.dunkapi.com/v1/list_teams \
  -H "x-api-key: YOUR_API_KEY"

# every tool: POST /v1/{tool} with a JSON body
# responses carry X-Credits-Used and X-Credits-Remaining

Pricing

Free to start, then you pay per call.

500 credits every month, no card. Subscriptions add a monthly allowance; wallet top-ups do not expire while your account is open.

Free
$0
500 free credits every month
  • +All 24 endpoints
  • +REST API + MCP access
  • +No credit card required
Start free
Starter
$19/mo
10,000 credits/month
  • +10,000 credits/month
  • +All 24 endpoints
  • +Email support
  • +Overage at wallet rates
Choose Starter
ProMost popular
$49/mo
30,000 credits/month
  • +30,000 credits/month
  • +All 24 endpoints
  • +Priority support
  • +Overage at wallet rates
Choose Pro
Scale
$149/mo
125,000 credits/month
  • +125,000 credits/month
  • +All 24 endpoints
  • +Dedicated support
  • +Volume rates available
Choose Scale

Full breakdown, credit costs per tool, and FAQ on the pricing page.

Questions

The things people ask before signing up.

Is DunkAPI free?

Every account gets 500 credits every month and no card. Calls cost 1 to 25 credits depending on the endpoint, so 500 is a few hundred real requests. Paid plans start at $19/mo for 10,000 credits a month, and wallet top-ups do not expire while your account is open.

How far back does the data go?

NBA play-by-play, with the location of every shot, runs from the 2003-04 season to today; win probability starts in 2017-18. Sportsbook lines start in 2012-13 and carry 4 to 12 books per regular-season game from 2013-14 to 2023-24 (10 to 12 from 2020-21), then usually one in the daily feed; since July 2020 the sportsbook odds archive adds opening and closing lines from 6 to 8 books per game. The WNBA runs from 2006, men's college from 2013-14 and women's college from 2014-15, with about ten books per men's college game to 2023-24.

What is MCP, and do I need it?

MCP is the protocol Claude, Cursor and similar assistants use to call tools. Point one at https://mcp.dunkapi.com/mcp with your key and it picks the endpoint and reads the response itself, no client code. If you are writing an application instead, ignore MCP and use the REST endpoints; they are the same 24 tools.

Can I use this commercially?

Yes, inside your own product or model, within the terms. Reselling the data itself as a feed is not permitted. DunkAPI is independent and not affiliated with the NBA, the WNBA or the NCAA.

How current is it?

Odds refresh every hour for games in the next four days. Everything else updates once a day, early morning US Eastern (10:00 UTC): scores, box scores and the previous night's play-by-play, the next week's schedule, the day's lines, the injury report and the ratings. There is no live in-game feed.

Where do the stats come from?

Games, box scores, play-by-play, shot locations, win probability and injuries from public data; sportsbook lines are captured from the books that post them. Shot zones, expected points per shot, pace, offensive and defensive ratings, standings and team Elo are computed here from those rows. Nothing is licensed from another analytics provider.

What are the rate limits?

60 requests a minute, dropping to 10 if your credit balance falls below 100. The limit is the same on every plan: credits, not requests, are the spend boundary.

Before you write another scraper

Start with 500 free credits every month, no card.

DunkAPI · The basketball data API.