# NFL v3 Play-by-Play API

> NFL v3 Play-by-Play API on Apizie: 3 endpoints (Play By Play, Play By Play Delta, Play By Play Simulation) 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-nfl-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-nfl-v3-play-by-play`
- Category: Entertainment
- Status: byok
- Source: https://sportsdata.io
- Page: https://apizie.tech/api/entertainment/sportsdata-nfl-v3-play-by-play
- OpenAPI: https://apizie.tech/api/entertainment/sportsdata-nfl-v3-play-by-play/openapi.json

NFL play-by-play API.

## Endpoints

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| season | string | yes | Year of the season and the season type. If no season type is provided, then the default is regular season. Examples: 2015REG , 2015PRE ,… |
| week | string | yes | Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4. Example: 1 |
| hometeam | string | yes | Abbreviation of the home team. Example: WAS . |

### Play By Play Delta
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-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 . |
| season | string | yes | Year of the season and the season type. If no season type is provided, then the default is regular season. Examples: 2015REG , 2015PRE ,… |
| week | string | yes | Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4. Example: 1 |
| minutes | string | yes | Only returns player statistics that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries… |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| numberofplays | string | yes | The number of plays to progress in this NFL live game simulation. Example entries are 0 , 1 , 2 , 3 , 150 , 200 , etc. |

## Example
```
curl "https://apizie.tech/v1/entertainment:sportsdata-nfl-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 NFL v3 Play-by-Play API?
Create a free Apizie key, then send GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-play-by-play/play-by-play with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the NFL 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. NFL v3 Play-by-Play itself also needs your own key from sportsdata.io.

### Can AI agents use the NFL 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-nfl-v3-play-by-play.

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