--- name: college-football-data-api description: "College Football Data API skill. Use when working with College Football Data for wepa, teams, roster. Covers 60 endpoints." version: 1.0.0 generator: lapsh --- # College Football Data API API version: 5.13.2 ## Auth Bearer bearer ## Base URL https://api.collegefootballdata.com/ ## Setup 1. Set Authorization header with Bearer token 2. GET /wepa/team/season -- retrieve opponent-adjusted team season statistics 3. Explore available endpoints below ## Endpoints 60 endpoints across 25 groups. See references/api-spec.lap for full details. ### Wepa | Method | Path | Description | |--------|------|-------------| | GET | /wepa/team/season | Retrieve opponent-adjusted team season statistics | | GET | /wepa/players/passing | Retrieve opponent-adjusted player passing statistics | | GET | /wepa/players/rushing | Retrieve opponent-adjusted player rushing statistics | | GET | /wepa/players/kicking | Retrieve Points Added Above Replacement (PAAR) ratings for kickers | ### Teams | Method | Path | Description | |--------|------|-------------| | GET | /teams | Retrieves team information | | GET | /teams/fbs | Retrieves information on teams playing in the highest division of CFB | | GET | /teams/matchup | Retrieves historical matchup details for two given teams | | GET | /teams/ats | Retrieves against-the-spread (ATS) summary by team | ### Roster | Method | Path | Description | |--------|------|-------------| | GET | /roster | Retrieves historical roster data | ### Conferences | Method | Path | Description | |--------|------|-------------| | GET | /conferences | Retrieves list of conferences | ### Talent | Method | Path | Description | |--------|------|-------------| | GET | /talent | Retrieve 247 Team Talent Composite for a given year | ### Venues | Method | Path | Description | |--------|------|-------------| | GET | /venues | Retrieve list of venues | ### Stats | Method | Path | Description | |--------|------|-------------| | GET | /stats/player/season | Retrieves aggregated player statistics for a given season | | GET | /stats/season | Retrieves aggregated team season statistics | | GET | /stats/categories | Gets team statistical categories | | GET | /stats/season/advanced | Retrieves advanced season statistics for teams | | GET | /stats/game/advanced | Retrieves advanced statistics aggregated by game | | GET | /stats/game/havoc | Retrieves havoc statistics aggregated by game | ### Recruiting | Method | Path | Description | |--------|------|-------------| | GET | /recruiting/players | Retrieves player recruiting rankings | | GET | /recruiting/teams | Retrieves team recruiting rankings | | GET | /recruiting/groups | Retrieves aggregated recruiting statistics by team and position grouping | ### Ratings | Method | Path | Description | |--------|------|-------------| | GET | /ratings/sp | Retrieves SP+ ratings for a given year or school | | GET | /ratings/sp/conferences | Retrieves aggregated historical conference SP+ data | | GET | /ratings/srs | Retrieves historical SRS for a year or team | | GET | /ratings/elo | Retrieves historical Elo ratings | | GET | /ratings/fpi | Retrieves historical Football Power Index (FPI) ratings | ### Rankings | Method | Path | Description | |--------|------|-------------| | GET | /rankings | Retrieves historical poll data | ### Plays | Method | Path | Description | |--------|------|-------------| | GET | /plays | Retrieves historical play data | | GET | /plays/types | Retrieves available play types | | GET | /plays/stats | Retrieve player-play associations (limit 2000) | | GET | /plays/stats/types | Retrieves available play stat types | ### Player | Method | Path | Description | |--------|------|-------------| | GET | /player/search | Search for players (lists top 100 results) | | GET | /player/usage | Retrieves player usage data for a given season | | GET | /player/returning | Retrieves returning production data. Either a year or team filter must be specified. | | GET | /player/portal | Retrieves transfer portal data for a given year | ### Ppa | Method | Path | Description | |--------|------|-------------| | GET | /ppa/predicted | Query Predicted Points values by down and distance | | GET | /ppa/teams | Retrieves historical team PPA metrics by season | | GET | /ppa/games | Retrieves historical team PPA metrics by game | | GET | /ppa/players/games | Queries player PPA statistics by game | | GET | /ppa/players/season | Queries player PPA statistics by season | ### Metrics | Method | Path | Description | |--------|------|-------------| | GET | /metrics/wp | Query play win probabilities by game | | GET | /metrics/wp/pregame | Queries pregame win probabilities | | GET | /metrics/fg/ep | Queries field goal expected points values | ### Live | Method | Path | Description | |--------|------|-------------| | GET | /live/plays | Queries live play-by-play data and advanced stats | ### Lines | Method | Path | Description | |--------|------|-------------| | GET | /lines | Retrieves historical betting data | ### Info | Method | Path | Description | |--------|------|-------------| | GET | /info | Retrieves information about the user, including their Patreon level and remaining API calls. | ### Games | Method | Path | Description | |--------|------|-------------| | GET | /games | Retrieves historical game data | | GET | /games/teams | Retrieves team box score statistics | | GET | /games/players | Retrieves player box score statistics | | GET | /games/media | Retrieves media information for games | | GET | /games/weather | Retrieve historical and future weather data (Patreon only) | ### Records | Method | Path | Description | |--------|------|-------------| | GET | /records | Retrieves historical team records | ### Calendar | Method | Path | Description | |--------|------|-------------| | GET | /calendar | Retrieves calendar information | ### Scoreboard | Method | Path | Description | |--------|------|-------------| | GET | /scoreboard | Retrieves live scoreboard data | ### Drives | Method | Path | Description | |--------|------|-------------| | GET | /drives | Retrieves historical drive data | ### Draft | Method | Path | Description | |--------|------|-------------| | GET | /draft/teams | Retrieves list of NFL teams | | GET | /draft/positions | Retrieves list of player position categories for the NFL Draft | | GET | /draft/picks | Retrieve historical NFL draft data | ### Coaches | Method | Path | Description | |--------|------|-------------| | GET | /coaches | Retrieves historical head coach information and records | ### Game | Method | Path | Description | |--------|------|-------------| | GET | /game/box/advanced | Retrieves 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 talent?" -> GET /talent - "List all venues?" -> GET /venues - "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 sp?" -> GET /ratings/sp - "List all srs?" -> GET /ratings/srs - "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 search?" -> GET /player/search - "List all usage?" -> GET /player/usage - "List all returning?" -> GET /player/returning - "List all portal?" -> GET /player/portal - "List all predicted?" -> GET /ppa/predicted - "List all games?" -> GET /ppa/games - "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 - "How to authenticate?" -> See Auth section above ## Response Tips - Check response schemas in references/api-spec.lap for field details ## 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)