College Football Data API
Build college football applications, models, and analysis with game, team, player, recruiting, ranking, and advanced metrics data. Request an API key at…
Data & analytics#sports--fitness
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Build college football applications, models, and analysis with game, team, player, recruiting, ranking, and advanced metrics data. Request an API key at CollegeFootballData.com.
Endpoints 93
games
- GETGetGames
/gamesReturns historical game data. - GETGetGameTeamStats
/games/teamsReturns team box score statistics by game. - GETGetGamePlayerStats
/games/playersReturns player box score statistics by game. - GETGetMedia
/games/media?year=0Returns broadcast and media information for games. - GETGetWeather
/games/weatherReturns historical and forecast weather data for games. Requires Patreon. - GETGetGameSchedule
/games/scheduleReturns games for the current, next, or requested week. - GETGetGamePreview
/games/:gameId/previewReturns pregame team comparisons and key players for a game. - GETGetAdjustedGamePreview
/games/:gameId/preview/adjustedReturns adjusted pregame team and player metrics for a game. Requires Patreon Tier 1. - GETGetRecords
/recordsReturns historical team records by season. - GETGetCalendar
/calendar?year=0Returns the week-by-week season calendar. - GETGetScoreboard
/scoreboardReturns current scoreboard data. - GETGetAdvancedBoxScore
/game/box/advanced?id=0Returns an advanced box score for a game. Returns 404 for games without play-by-play data.
playoffs
- GETGetCfpPlayoff
/playoffs/cfp?year=0Returns the complete College Football Playoff bracket for a season. - GETGetCfpParticipants
/playoffs/cfp/participants?year=0Returns College Football Playoff participants for a season. - GETGetCfpGames
/playoffs/cfp/games?year=0Returns College Football Playoff matchups for a season.
drives
- GETGetDrives
/drives?year=0Returns historical drive data.
plays
- GETGetPlays
/plays?year=0&week=0Returns historical play-by-play data. - GETGetPlayTypes
/plays/typesReturns the available play types. - GETGetPlayStats
/plays/statsReturns player and play-stat associations, limited to 2,000 records. - GETGetPlayStatTypes
/plays/stats/typesReturns the available play stat types. - GETGetLivePlays
/live/plays?gameId=0Returns live play-by-play data and advanced metrics for a game. Results may be cached for up to five seconds after calculation.
passing
- GETGetPassingPlays
/passing/plays?year=0Returns enriched pass attempts with completion probability and CPOE. - GETGetPlayerPassingBySeason
/passing/players/seasonReturns player passing statistics and CPOE by season. - GETGetPlayerPassingByGame
/passing/players/games?year=0Returns player passing statistics and CPOE by game. - GETGetTeamPassingBySeason
/passing/teams/seasonReturns team passing statistics and CPOE by season. - GETGetTeamPassingByGame
/passing/teams/games?year=0Returns team passing statistics and CPOE by game.
rushing
- GETGetRushingPlays
/rushing/playsReturns enriched rushing attempts with direction and attribution. - GETGetPlayerRushingBySeason
/rushing/players/seasonReturns player rushing statistics by season. - GETGetPlayerRushingByGame
/rushing/players/gamesReturns player rushing statistics by game. - GETGetTeamRushingBySeason
/rushing/teams/seasonReturns team rushing statistics by season. - GETGetTeamRushingByGame
/rushing/teams/games?year=0Returns team rushing statistics by game.
punting
- GETGetPuntingPlays
/punting/playsReturns enriched punt plays with yardage, field position, and outcomes. - GETGetPlayerPuntingBySeason
/punting/players/season?year=0Returns player punting and punt return statistics by season. - GETGetPlayerPuntingByGame
/punting/players/games?year=0Returns player punting and punt return statistics by game. - GETGetTeamPuntingBySeason
/punting/teams/season?year=0Returns team punting and punt return statistics by season. - GETGetTeamPuntingByGame
/punting/teams/games?year=0Returns team punting and punt return statistics by game.
teams
- GETGetTeamSeasonOverview
/teams/season/overview?year=0&team=stringReturns a full-season team overview, including postseason and garbage time. - GETGetTeams
/teamsReturns team information and conference affiliations. - GETGetFBSTeams
/teams/fbsReturns Football Bowl Subdivision (FBS) teams for a season. - GETGetMatchup
/teams/matchup?team1=string&team2=stringReturns historical matchup results between two teams. - GETGetTeamsATS
/teams/ats?year=0Returns against-the-spread (ATS) records by team. - GETGetRoster
/rosterReturns historical roster data. - GETGetTalent
/talent?year=0Returns 247Sports Team Talent Composite ratings for a season.
conferences
- GETGetConferences
/conferencesReturns conferences and member counts. - GETGetTeamConferenceChanges
/conferences/changes?year=0Returns team conference changes by season. - GETGetTeamConferenceAffiliations
/conferences/affiliationsReturns historical team conference affiliations.
venues
- GETGetVenues
/venuesReturns college football venues.
coaches
- GETGetCoaches
/coachesReturns historical head coach records. - GETGetCoachProfile
/coaches/profile?coachId=0Returns a coach profile with canonical identity and career totals. - GETGetCoachSeasons
/coaches/seasonsReturns coach-season records with attributed results and team context. - GETGetCoachTenures
/coaches/tenuresReturns head coaching tenures and their records.
players
- GETSearchPlayers
/player/search?searchTerm=stringReturns up to 100 players whose names match the search term. - GETGetPlayerUsage
/player/usage?year=0Returns player usage metrics for a season. - GETGetPlayerSeasonOverview
/player/season/overview?year=0&playerId=0Returns a player season overview with box score, usage, and PPA data. - GETGetReturningProduction
/player/returningReturns returning production metrics by team and season. - GETGetTransferPortal
/player/portal?year=0Returns transfer portal entries for a season.
rankings
- GETGetRankings
/rankings?year=0Returns historical poll rankings.
betting
- GETGetLines
/linesReturns historical betting lines and results.
recruiting
- GETGetRecruits
/recruiting/playersReturns player recruiting rankings. - GETGetTeamRecruitingRankings
/recruiting/teamsReturns team recruiting rankings. - GETGetAggregatedTeamRecruitingRatings
/recruiting/groupsReturns recruiting ratings aggregated by team and position group.
ratings
- GETGetCore
/ratings/coreReturns Context & Opponent-Relative Efficiency (CORE) ratings. - GETGetSP
/ratings/spReturns SP+ ratings by team and season. - GETGetConferenceSP
/ratings/sp/conferencesReturns conference-level SP+ ratings by season. - GETGetSRS
/ratings/srsReturns Simple Rating System (SRS) ratings by team and season. - GETGetExpandedSRS
/ratings/srs/expandedReturns expanded Simple Rating System (SRS) ratings, including FCS teams. - GETGetElo
/ratings/eloReturns historical Elo ratings. - GETGetFPI
/ratings/fpiReturns historical Football Power Index (FPI) ratings.
metrics
- GETGetPredictedPoints
/ppa/predicted?down=0&distance=0Returns predicted points values by down and distance. - GETGetPredictedPointsAddedByTeam
/ppa/teamsReturns team Predicted Points Added (PPA) metrics by season. - GETGetPredictedPointsAddedByGame
/ppa/games?year=0Returns team Predicted Points Added (PPA) metrics by game. - GETGetPredictedPointsAddedByPlayerGame
/ppa/players/games?year=0Returns player Predicted Points Added (PPA) metrics by game. - GETGetPredictedPointsAddedByPlayerSeason
/ppa/players/seasonReturns player Predicted Points Added (PPA) metrics by season. - GETGetWinProbability
/metrics/wp?gameId=0Returns play-by-play win probabilities for a game. - GETGetPregameWinProbabilities
/metrics/wp/pregameReturns pregame win probabilities. - GETGetFieldGoalExpectedPoints
/metrics/fg/epReturns expected points values for field goal attempts.
stats
- GETGetPlayerSeasonStats
/stats/player/season?year=0Returns player statistics aggregated by season. - GETGetPlayerSeasonSuccessRates
/stats/player/successReturns player passing and rushing success rates by season. - GETGetPlayerGameSuccessRates
/stats/player/success/game?year=0Returns player passing and rushing success rates by game. - GETGetTeamStats
/stats/seasonReturns team statistics aggregated by season. - GETGetCategories
/stats/categoriesReturns the available team statistical categories. - GETGetAdvancedSeasonStats
/stats/season/advancedReturns advanced team statistics aggregated by season. - GETGetAdvancedGameStats
/stats/game/advancedReturns advanced team statistics aggregated by game. - GETGetGameHavocStats
/stats/game/havocReturns team havoc statistics aggregated by game.
draft
- GETGetDraftTeams
/draft/teamsReturns the NFL teams represented in draft data. - GETGetDraftPositions
/draft/positionsReturns the player position categories used in NFL Draft data. - GETGetDraftPicks
/draft/picksReturns historical NFL Draft picks.
adjustedMetrics
- GETGetAdjustedTeamSeasonStats
/wepa/team/seasonReturns opponent-adjusted team statistics by season. - GETGetAdjustedPlayerPassingStats
/wepa/players/passingReturns opponent-adjusted player passing metrics. - GETGetAdjustedPlayerRushingStats
/wepa/players/rushingReturns opponent-adjusted player rushing metrics. - GETGetKickerPaar
/wepa/players/kickingReturns Points Added Above Replacement (PAAR) ratings for kickers.
info
- GETGetUserInfo
/infoReturns the authenticated user's Patreon level and remaining API calls. Returns null when the request is not authenticated. - GETGetUsage
/info/usageReturns recent usage of the authenticated user's shared CFB and CBB quota. Returns null when the request is not authenticated.
API details
- Base URL
https://api.collegefootballdata.com- Authentication
- A bearer token in the Authorization header
- Operations
- 93 operations on 93 pathsGET 93
- Main resources
- games 12metrics 8stats 8ratings 7teams 7passing 5players 5plays 5punting 5rushing 5
- Response formats
application/json- Description format
- OpenAPI 3.0.0, API version
5.33.3 - Links
- OpenAPI document · Support
How to test the College Football Data API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the College Football Data API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “GetGames” (GET /games), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the College Football Data API?
Build college football applications, models, and analysis with game, team, player, recruiting, ranking, and advanced metrics data. Request an API key at… It is listed under Data & analytics and has 93 endpoints.
Who publishes the College Football Data API?
It is listed from Collegefootballdata's public API description (an OpenAPI document), not published by Collegefootballdata on Swastik Codes. Anyone who controls collegefootballdata.com can claim the profile by adding a DNS TXT record.
What is the base URL of the College Football Data API?
Requests go to https://api.collegefootballdata.com. Endpoint paths are added to this base URL.
How do I authenticate with the College Football Data API?
With A bearer token in the Authorization header.
How many endpoints does the College Football Data API have?
93 operations on 93 paths (93 GET). The largest groups are games, metrics, stats, ratings.
Is forking the College Football Data API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.