# NFL v3 Scores API

> NFL v3 Scores API on Apizie: 40 endpoints (Teams (All), Are Games In Progress, Bye Weeks, Season Current, …) 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-scores/{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-scores`
- Category: Entertainment
- Status: byok
- Source: https://sportsdata.io
- Page: https://apizie.tech/api/entertainment/sportsdata-nfl-v3-scores
- OpenAPI: https://apizie.tech/api/entertainment/sportsdata-nfl-v3-scores/openapi.json

NFL schedules, scores, odds, weather, and news API.

## Endpoints

### Teams (All)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/teams-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Are Games In Progress
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/are-games-in-progress` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Bye Weeks
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/bye-weeks` (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 ,… |

### Season Current
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/season-current` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Week Current
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/week-current` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Depth Charts
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/depth-charts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Player Details by Free Agents
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/player-details-by-free-agents` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Game Stats by Season (Deprecated, use Team Game Stats instead)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/game-stats-by-season-deprecated-use-team-game-stats-instead` (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 ,… |

### Game Stats by Week (Deprecated, use Team Game Stats instead)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/game-stats-by-week-deprecated-use-team-game-stats-instead` (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 |

### Season Last Completed
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/season-last-completed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Week Last Completed
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/week-last-completed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### News
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/news` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### News by Date
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/news-by-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| date | string | yes | The date of the news. Examples: 2017-JUL-31 , 2017-SEP-01 . |

### News by Player
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/news-by-player` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| playerid | string | yes | Each NFL player has a unique ID assigned by FantasyData. Player IDs can be determined by pulling player related data. Example: 14257 . |

### News by Team
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/news-by-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| team | string | yes | Abbreviation of the team. Example: WAS . |

### X Ping
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/xping` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| seconds | string | yes | Number of seconds to sleep before responding |

### Player Details by Player
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/player-details-by-player` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| playerid | string | yes | Each NFL player has a unique ID assigned by FantasyData. Player IDs can be determined by pulling player related data. Example: 732 . |

### Player Details by Available
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/player-details-by-available` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Player Details by Team
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/player-details-by-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| team | string | yes | Abbreviation of the team. Example: WAS . |

### Players by Team (Basic)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/players-by-team-basic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| team | string | yes | Abbreviation of the team. Example: WAS . |

### Referees
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/referees` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Player Details by Rookie Draft Year
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/player-details-by-rookie-draft-year` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| season | string | yes | Year of the season. Examples: 2018 , 2019 , etc. |

### Schedule
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/schedule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| season | string | yes | Year of the season (with optional season type). Examples: 2018 , 2018PRE , 2018POST , 2018STAR , 2019 , etc. |

### Schedule (Basic)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/schedule-basic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| season | string | yes | Year of the season (with optional season type). Examples: 2018 , 2018PRE , 2018POST , 2018STAR , 2019 , etc. |

### Scores by Season
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/scores-by-season` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| season | string | yes | Year of the season (with optional season type). Examples: 2018 , 2018PRE , 2018POST , 2018STAR , 2019 , etc. |

### Scores by Week (Basic)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/scores-by-week-basic` (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 |

### Scores by Date
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/scores-by-date` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| date | string | yes | The date of the games. Examples: 2021-SEP-12 , 2021-NOV-28 . |

### Scores by Week
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/scores-by-week` (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 |

### Scores by Week Simulation
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/scores-by-week-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. |

### Stadiums
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/stadiums` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Standings
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/standings` (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 ,… |

### Team Game Stats
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/team-game-stats` (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 |

### Team Game Logs By Season
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/team-game-logs-by-season` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| season | string | yes | Season to get games from. Example 2019POST , 2020 |
| teamid | string | yes | Unique ID of team. Example 8 |
| numberofgames | string | yes | How many games to return. Example all , 10 , 25 |

### Team Season Stats
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/team-season-stats` (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 ,… |

### Teams (Active)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/teams-active` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Teams by Season
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/teams-by-season` (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 ,… |

### Teams (Basic)
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/teams-basic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Timeframes
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/timeframes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |
| type | string | yes | The type of timeframes to return. Valid entries are current or upcoming or completed or recent or all . |

### Season Upcoming
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/season-upcoming` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

### Week Upcoming
`GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/week-upcoming` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | yes | Desired response format. Valid entries are XML or JSON . |

## Example
```
curl "https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/teams-all" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the NFL v3 Scores API?
Create a free Apizie key, then send GET https://apizie.tech/v1/entertainment:sportsdata-nfl-v3-scores/teams-all with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the NFL v3 Scores 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-scores.

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