# CFB v3 Scores API

> CFB v3 Scores API on Apizie: 22 endpoints (Are Games In Progress, Current Season, Current Season Details, Current SeasonType, …) 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://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-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-cfb-v3-scores`
- Category: Entertainment
- Status: byok
- Source: https://sportsdata.io
- Page: https://zieapi.vercel.app/api/entertainment/sportsdata-cfb-v3-scores
- OpenAPI: https://zieapi.vercel.app/api/entertainment/sportsdata-cfb-v3-scores/openapi.json

CFB schedules, scores, team stats, odds, weather, and news API.

## Endpoints

### Are Games In Progress
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/are-games-in-progress` (byok)

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

### Current Season
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/current-season` (byok)

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

### Current Season Details
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/current-season-details` (byok)

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

### Current SeasonType
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/current-seasontype` (byok)

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

### Current Week
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/current-week` (byok)

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

### Schedules
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/schedules` (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. |

### Games by Date
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/games-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 game(s). Examples: 2016-SEP-01 , 2017-SEP-10 . |

### Games by Week
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/games-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. Examples: 2015 , 2016 , etc. |
| week | string | yes | The week of the game(s). Examples: 1 , 2 , 3 , etc. |

### Injured Players
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/injured-players` (byok)

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

### Conference Hierarchy (with Teams)
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/conference-hierarchy-with-teams` (byok)

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

### Player Details By Player
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-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 | Unique FantasyData Player ID. Example: 50002016 . |

### Player Details By Active
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/player-details-by-active` (byok)

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

### Player Details by Team
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-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 | The abbreviation of the requested team. Examples: SF , NYY . |

### Players by Team (Basic)
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-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 | The abbreviation of the requested team. Examples: SF , NYY . |

### Schedules (Basic)
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/schedules-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. |

### Games by Week (Basic)
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/games-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. Examples: 2015 , 2016 , etc. |
| week | string | yes | The week of the game(s). Examples: 1 , 2 , 3 , etc. |

### Stadiums
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/stadiums` (byok)

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

### Team Game Logs By Season
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-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 1 |
| numberofgames | string | yes | How many games to return. Example all , 10 , 25 |

### Team Game Stats by Week
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/team-game-stats-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. Examples: 2015 , 2016 , etc. |
| week | string | yes | The week of the game(s). Examples: 1 , 2 , 3 , etc. |

### Team Season Stats & Standings
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/team-season-stats-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 (with optional season type). Examples: 2017 , 2017POST , 2018 . |

### Teams
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/teams` (byok)

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

### Teams (Basic)
`GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/teams-basic` (byok)

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

## Example
```
curl "https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/are-games-in-progress" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the CFB v3 Scores API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/entertainment:sportsdata-cfb-v3-scores/are-games-in-progress with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the CFB v3 Scores API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key entertainment:sportsdata-cfb-v3-scores.

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