---
name: college-football-data-api
description: "College Football Data API skill. Use when working with College Football Data for wepa, teams, roster. Covers 74 endpoints."
version: 1.0.0
generator: lapsh
---

# College Football Data API
API version: 5.24.1

## Auth
Bearer bearer

## Base URL
https://api.collegefootballdata.com/

## Setup
1. Set Authorization header with Bearer token
2. GET /wepa/team/season -- returns opponent-adjusted team statistics by season.
3. Explore available endpoints below

## Endpoints
74 endpoints across 26 groups. See references/api-spec.lap for full details.

### Wepa
| Method | Path | Description |
|--------|------|-------------|
| GET | /wepa/team/season | Returns opponent-adjusted team statistics by season. |
| GET | /wepa/players/passing | Returns opponent-adjusted player passing metrics. |
| GET | /wepa/players/rushing | Returns opponent-adjusted player rushing metrics. |
| GET | /wepa/players/kicking | Returns Points Added Above Replacement (PAAR) ratings for kickers. |

### Teams
| Method | Path | Description |
|--------|------|-------------|
| GET | /teams | Returns team information and conference affiliations. |
| GET | /teams/fbs | Returns Football Bowl Subdivision (FBS) teams for a season. |
| GET | /teams/matchup | Returns historical matchup results between two teams. |
| GET | /teams/ats | Returns against-the-spread (ATS) records by team. |

### Roster
| Method | Path | Description |
|--------|------|-------------|
| GET | /roster | Returns historical roster data. |

### Conferences
| Method | Path | Description |
|--------|------|-------------|
| GET | /conferences | Returns conferences and member counts. |
| GET | /conferences/changes | Returns team conference changes by season. |
| GET | /conferences/affiliations | Returns historical team conference affiliations. |

### Talent
| Method | Path | Description |
|--------|------|-------------|
| GET | /talent | Returns 247Sports Team Talent Composite ratings for a season. |

### Venues
| Method | Path | Description |
|--------|------|-------------|
| GET | /venues | Returns college football venues. |

### Stats
| Method | Path | Description |
|--------|------|-------------|
| GET | /stats/player/season | Returns player statistics aggregated by season. |
| GET | /stats/player/success | Returns player passing and rushing success rates by season. |
| GET | /stats/player/success/game | Returns player passing and rushing success rates by game. |
| GET | /stats/season | Returns team statistics aggregated by season. |
| GET | /stats/categories | Returns the available team statistical categories. |
| GET | /stats/season/advanced | Returns advanced team statistics aggregated by season. |
| GET | /stats/game/advanced | Returns advanced team statistics aggregated by game. |
| GET | /stats/game/havoc | Returns team havoc statistics aggregated by game. |

### Recruiting
| Method | Path | Description |
|--------|------|-------------|
| GET | /recruiting/players | Returns player recruiting rankings. |
| GET | /recruiting/teams | Returns team recruiting rankings. |
| GET | /recruiting/groups | Returns recruiting ratings aggregated by team and position group. |

### Ratings
| Method | Path | Description |
|--------|------|-------------|
| GET | /ratings/core | Returns Context & Opponent-Relative Efficiency (CORE) ratings. |
| GET | /ratings/sp | Returns SP+ ratings by team and season. |
| GET | /ratings/sp/conferences | Returns conference-level SP+ ratings by season. |
| GET | /ratings/srs | Returns Simple Rating System (SRS) ratings by team and season. |
| GET | /ratings/srs/expanded | Returns expanded Simple Rating System (SRS) ratings, including FCS teams. |
| GET | /ratings/elo | Returns historical Elo ratings. |
| GET | /ratings/fpi | Returns historical Football Power Index (FPI) ratings. |

### Rankings
| Method | Path | Description |
|--------|------|-------------|
| GET | /rankings | Returns historical poll rankings. |

### Plays
| Method | Path | Description |
|--------|------|-------------|
| GET | /plays | Returns historical play-by-play data. |
| GET | /plays/types | Returns the available play types. |
| GET | /plays/stats | Returns player and play-stat associations, limited to 2,000 records. |
| GET | /plays/stats/types | Returns the available play stat types. |

### Playoffs
| Method | Path | Description |
|--------|------|-------------|
| GET | /playoffs/cfp | Returns the complete College Football Playoff bracket for a season. |
| GET | /playoffs/cfp/participants | Returns College Football Playoff participants for a season. |
| GET | /playoffs/cfp/games | Returns College Football Playoff matchups for a season. |

### Player
| Method | Path | Description |
|--------|------|-------------|
| GET | /player/search | Returns up to 100 players whose names match the search term. |
| GET | /player/usage | Returns player usage metrics for a season. |
| GET | /player/season/overview | Returns a player season overview with box score, usage, and Predicted |
| GET | /player/returning | Returns returning production metrics by team and season. |
| GET | /player/portal | Returns transfer portal entries for a season. |

### Ppa
| Method | Path | Description |
|--------|------|-------------|
| GET | /ppa/predicted | Returns predicted points values by down and distance. |
| GET | /ppa/teams | Returns team Predicted Points Added (PPA) metrics by season. |
| GET | /ppa/games | Returns team Predicted Points Added (PPA) metrics by game. |
| GET | /ppa/players/games | Returns player Predicted Points Added (PPA) metrics by game. |
| GET | /ppa/players/season | Returns player Predicted Points Added (PPA) metrics by season. |

### Metrics
| Method | Path | Description |
|--------|------|-------------|
| GET | /metrics/wp | Returns play-by-play win probabilities for a game. |
| GET | /metrics/wp/pregame | Returns pregame win probabilities. |
| GET | /metrics/fg/ep | Returns expected points values for field goal attempts. |

### Live
| Method | Path | Description |
|--------|------|-------------|
| GET | /live/plays | Returns live play-by-play data and advanced metrics for a game. |

### Lines
| Method | Path | Description |
|--------|------|-------------|
| GET | /lines | Returns historical betting lines and results. |

### Info
| Method | Path | Description |
|--------|------|-------------|
| GET | /info | Returns the authenticated user's Patreon level and remaining API calls. |
| GET | /info/usage | Returns recent usage for the authenticated user's shared CFB and CBB call |

### Games
| Method | Path | Description |
|--------|------|-------------|
| GET | /games | Returns historical game data. |
| GET | /games/teams | Returns team box score statistics by game. |
| GET | /games/players | Returns player box score statistics by game. |
| GET | /games/media | Returns broadcast and media information for games. |
| GET | /games/weather | Returns historical and forecast weather data for games. Requires Patreon. |

### Records
| Method | Path | Description |
|--------|------|-------------|
| GET | /records | Returns historical team records by season. |

### Calendar
| Method | Path | Description |
|--------|------|-------------|
| GET | /calendar | Returns the week-by-week season calendar. |

### Scoreboard
| Method | Path | Description |
|--------|------|-------------|
| GET | /scoreboard | Returns current scoreboard data. |

### Drives
| Method | Path | Description |
|--------|------|-------------|
| GET | /drives | Returns historical drive data. |

### Draft
| Method | Path | Description |
|--------|------|-------------|
| GET | /draft/teams | Returns the NFL teams represented in draft data. |
| GET | /draft/positions | Returns the player position categories used in NFL Draft data. |
| GET | /draft/picks | Returns historical NFL Draft picks. |

### Coaches
| Method | Path | Description |
|--------|------|-------------|
| GET | /coaches | Returns historical head coach records. |
| GET | /coaches/profile | Returns a coach profile with canonical identity and career totals. |
| GET | /coaches/seasons | Returns coach-season records with attributed results and team context. |
| GET | /coaches/tenures | Returns continuous head-coaching tenures and their attributed records. |

### Game
| Method | Path | Description |
|--------|------|-------------|
| GET | /game/box/advanced | Returns an advanced box score for a game. |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all season?" -> GET /wepa/team/season
- "List all passing?" -> GET /wepa/players/passing
- "List all rushing?" -> GET /wepa/players/rushing
- "List all kicking?" -> GET /wepa/players/kicking
- "List all teams?" -> GET /teams
- "List all fbs?" -> GET /teams/fbs
- "List all matchup?" -> GET /teams/matchup
- "List all ats?" -> GET /teams/ats
- "List all roster?" -> GET /roster
- "List all conferences?" -> GET /conferences
- "List all changes?" -> GET /conferences/changes
- "List all affiliations?" -> GET /conferences/affiliations
- "List all talent?" -> GET /talent
- "List all venues?" -> GET /venues
- "List all success?" -> GET /stats/player/success
- "List all game?" -> GET /stats/player/success/game
- "List all categories?" -> GET /stats/categories
- "List all advanced?" -> GET /stats/season/advanced
- "List all havoc?" -> GET /stats/game/havoc
- "List all players?" -> GET /recruiting/players
- "List all groups?" -> GET /recruiting/groups
- "List all core?" -> GET /ratings/core
- "List all sp?" -> GET /ratings/sp
- "List all srs?" -> GET /ratings/srs
- "List all expanded?" -> GET /ratings/srs/expanded
- "List all elo?" -> GET /ratings/elo
- "List all fpi?" -> GET /ratings/fpi
- "List all rankings?" -> GET /rankings
- "List all plays?" -> GET /plays
- "List all types?" -> GET /plays/types
- "List all stats?" -> GET /plays/stats
- "List all cfp?" -> GET /playoffs/cfp
- "List all participants?" -> GET /playoffs/cfp/participants
- "List all games?" -> GET /playoffs/cfp/games
- "List all search?" -> GET /player/search
- "List all usage?" -> GET /player/usage
- "List all overview?" -> GET /player/season/overview
- "List all returning?" -> GET /player/returning
- "List all portal?" -> GET /player/portal
- "List all predicted?" -> GET /ppa/predicted
- "List all wp?" -> GET /metrics/wp
- "List all pregame?" -> GET /metrics/wp/pregame
- "List all ep?" -> GET /metrics/fg/ep
- "List all lines?" -> GET /lines
- "List all info?" -> GET /info
- "List all media?" -> GET /games/media
- "List all weather?" -> GET /games/weather
- "List all records?" -> GET /records
- "List all calendar?" -> GET /calendar
- "List all scoreboard?" -> GET /scoreboard
- "List all drives?" -> GET /drives
- "List all positions?" -> GET /draft/positions
- "List all picks?" -> GET /draft/picks
- "List all coaches?" -> GET /coaches
- "List all profile?" -> GET /coaches/profile
- "List all seasons?" -> GET /coaches/seasons
- "List all tenures?" -> GET /coaches/tenures
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)