# NBA v3 Play-by-Play API

> NBA v3 Play-by-Play API on Apizie: 2 endpoints (Play By Play, Play By Play Delta) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/entertainment:sportsdata-nba-v3-play-by-play/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `entertainment:sportsdata-nba-v3-play-by-play`
- Category: Entertainment
- Status: byok
- Source: https://sportsdata.io
- Page: https://apizie.tech/api/entertainment/sportsdata-nba-v3-play-by-play
- OpenAPI: https://apizie.tech/api/entertainment/sportsdata-nba-v3-play-by-play/openapi.json

NBA play-by-play API.

## Endpoints

### Play By Play
`GET https://apizie.tech/v1/entertainment:sportsdata-nba-v3-play-by-play/play-by-play` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| gameid | string | yes | The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 14620 , 16905 , etc. |

### Play By Play Delta
`GET https://apizie.tech/v1/entertainment:sportsdata-nba-v3-play-by-play/play-by-play-delta` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| date | string | yes | The date of the game(s). Examples: 2016-OCT-31 , 2017-JAN-15 . |
| minutes | string | yes | Only returns plays that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are: 1 , 2 ...… |

## Example
```
curl "https://apizie.tech/v1/entertainment:sportsdata-nba-v3-play-by-play/play-by-play" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the NBA v3 Play-by-Play API?
Create a free Apizie key, then send GET https://apizie.tech/v1/entertainment:sportsdata-nba-v3-play-by-play/play-by-play with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the NBA v3 Play-by-Play API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. NBA v3 Play-by-Play itself also needs your own key from sportsdata.io.

### Can AI agents use the NBA v3 Play-by-Play API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key entertainment:sportsdata-nba-v3-play-by-play.

### What is the status of the NBA v3 Play-by-Play API?
Needs your own provider key (bring your own key)