College Football Data API
​string · required​integer · int32​string​string​string · required​string · required​string · required​string | null · required​string | null · required​integer | null · int32 · required​number | null · double · required​integer | null · int32 · required​string · required​string · required​string · required​string · required​integer | null · int32 · required​integer | null · int32 · required
​integer · int32 · required​string​string​string​integer · int32​boolean​integer · int32 · required​string · required​string · required​string · required​string · required​string · required
​integer · int32 · required​integer · int32 · required​integer · int32 · required​string · required​string · required​string · required​string · required​string · required​integer · int32 · required
​integer · int32​string​string​integer · int32 · required​string · required​string · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required
​integer · int32 · required​integer · int32 · required​string · required​string · required​string · required​string · required​string | null · required​string | null · date-time · required​number | null · double · required​integer | null · int32 · required​string · enum · required
players
Player search, usage, production, and transfer data.
GET
https://api.collegefootballdata.com
/player/search
Bearer
Returns up to 100 players whose names match the search term.
query Parameters
searchTermFull or partial player name.
yearSeason year.
teamTeam name.
positionPlayer position abbreviation.
Responses
200
Ok
idteamnamefirstNamelastNameweightheightjerseypositionhometownteamColorteamColorSecondaryactiveStartYearactiveEndYear​PlayerSearchTeamStint[] · required
GET
https://api.collegefootballdata.com
/player/usage
Bearer
Returns player usage metrics for a season.
query Parameters
yearSeason year.
conferenceConference abbreviation.
positionPlayer position abbreviation.
teamTeam name.
playerIdPlayer ID.
excludeGarbageTimeExcludes garbage-time plays when true. Defaults
to false.
Responses
200
Ok
seasonidnamepositionteamconference​object · required
GET
https://api.collegefootballdata.com
/player/season/overview
Bearer
Returns a player season overview with box score, usage, and Predicted Points Added (PPA) data.
query Parameters
yearSeason year.
playerIdPlayer ID.
Responses
200
Ok
seasonidnamepositionteamconferencegames​object · required
​object
GET
https://api.collegefootballdata.com
/player/returning
Bearer
Returns returning production metrics by team and season.
query Parameters
yearSeason year. Required unless team is specified.
teamTeam name. Required unless year is specified.
conferenceConference name or abbreviation.
Responses
200
Ok
seasonteamconferencetotalPPAtotalPassingPPAtotalReceivingPPAtotalRushingPPApercentPPApercentPassingPPApercentReceivingPPApercentRushingPPAusagepassingUsagereceivingUsagerushingUsageGET
https://api.collegefootballdata.com
/player/portal
Bearer
Returns transfer portal entries for a season.
query Parameters
yearSeason year.
Responses
200
Ok
seasonfirstNamelastNamepositionorigindestinationtransferDateratingstarseligibilityEnum values:
Withdrawn
TBD
PendingAppeal
SittingOne
Immediate