College Football DataCollege Football Data
  • CollegeFootballData.com
  • Get API Key
  • Legacy Swagger UI
  • Getting Started
  • Official libraries
  • Methodology and resources
  • API Reference
Helpful Links
  • CFBD
  • Patreon
  • Gumroad
Data + Code Packs
  • Starter Pack
  • Model Training Pack
  • AI Launchpad
  • AI Builder Pack
Other Resources
  • Rad Sports Analytics
  • Blog
  • Basketball

A Rad Sports Analytics platform.

xdiscordgithub
Information
games
    /gamesget/games/teamsget/games/playersget/games/mediaget/games/weatherget/recordsget/calendarget/scoreboardget/game/box/advancedget
playoffs
    /playoffs/cfpget/playoffs/cfp/participantsget/playoffs/cfp/gamesget
drives
    /drivesget
plays
    /playsget/plays/typesget/plays/statsget/plays/stats/typesget/live/playsget
teams
    /teamsget/teams/fbsget/teams/matchupget/teams/atsget/rosterget/talentget
conferences
    /conferencesget
venues
    /venuesget
coaches
    /coachesget/coaches/profileget/coaches/seasonsget/coaches/tenuresget
players
    /player/searchget/player/usageget/player/season/overviewget/player/returningget/player/portalget
rankings
    /rankingsget
betting
    /linesget
recruiting
    /recruiting/playersget/recruiting/teamsget/recruiting/groupsget
ratings
    /ratings/coreget/ratings/spget/ratings/sp/conferencesget/ratings/srsget/ratings/srs/expandedget/ratings/eloget/ratings/fpiget
metrics
    /ppa/predictedget/ppa/teamsget/ppa/gamesget/ppa/players/gamesget/ppa/players/seasonget/metrics/wpget/metrics/wp/pregameget/metrics/fg/epget
stats
    /stats/player/seasonget/stats/player/successget/stats/player/success/gameget/stats/seasonget/stats/categoriesget/stats/season/advancedget/stats/game/advancedget/stats/game/havocget
draft
    /draft/teamsget/draft/positionsget/draft/picksget
adjustedMetrics
    /wepa/team/seasonget/wepa/players/passingget/wepa/players/rushingget/wepa/players/kickingget
info
    /infoget/info/usageget
Schemas
powered by Zudoku
College Football Data API
College Football Data API

recruiting

Download schema

Player and team recruiting rankings and aggregated ratings.


GET
https://api.collegefootballdata.com
/recruiting/players
Bearer

Returns player recruiting rankings.

query Parameters

year
​integer · int32

Recruiting class year. Required unless team is specified.

team
​string

Team name. Required unless year is specified.

position
​string

Position category.

state
​string

State or province abbreviation.

classification
​RecruitClassification · enum

Recruit classification. Defaults to HighSchool.

Enum values:
JUCO
PrepSchool
HighSchool

Responses

200

Ok

​Recruit[]
Recruit
id
​string · required
athleteId
​string | null · required
recruitType
​RecruitClassification · enum · required
Enum values:
JUCO
PrepSchool
HighSchool
year
​integer · int32 · required
ranking
​integer | null · int32 · required
name
​string · required
school
​string | null · required
committedTo
​string | null · required
position
​string | null · required
height
​number | null · double · required
weight
​integer | null · int32 · required
stars
​integer | null · int32 · required
rating
​number | null · double · required
city
​string | null · required
stateProvince
​string | null · required
country
​string | null · required
​object · required
GET/recruiting/players
curl https://api.collegefootballdata.com/recruiting/players \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "id": "id", "athleteId": "athleteId", "recruitType": "JUCO", "year": 0, "ranking": 0, "name": "name", "school": "school", "committedTo": "committedTo", "position": "position", "height": 0, "weight": 0, "stars": 0, "rating": 0, "city": "city", "stateProvince": "stateProvince", "country": "country", "hometownInfo": { "fipsCode": "fipsCode", "longitude": 0, "latitude": 0 } } ]
json
application/json

GET
https://api.collegefootballdata.com
/recruiting/teams
Bearer

Returns team recruiting rankings.

query Parameters

year
​integer · int32

Recruiting class year.

team
​string

Team name.

Responses

200

Ok

​TeamRecruitingRanking[]
TeamRecruitingRanking
year
​integer · int32 · required
rank
​integer · int32 · required
team
​string · required
points
​number · double · required
GET/recruiting/teams
curl https://api.collegefootballdata.com/recruiting/teams \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "rank": 0, "team": "team", "points": 0 } ]
json
application/json

GET
https://api.collegefootballdata.com
/recruiting/groups
Bearer

Returns recruiting ratings aggregated by team and position group.

query Parameters

team
​string

Team name.

conference
​string

Conference name or abbreviation.

recruitType
​RecruitClassification · enum

Recruit classification. Defaults to HighSchool.

Enum values:
JUCO
PrepSchool
HighSchool
startYear
​integer · int32

Earliest recruiting class year. Defaults to 2000.

endYear
​integer · int32

Latest recruiting class year. Defaults to the current year.

Responses

200

Ok

​AggregatedTeamRecruiting[]
AggregatedTeamRecruiting
team
​string · required
conference
​string · required
positionGroup
​string | null · required
averageRating
​number · double · required
totalRating
​number · double · required
commits
​integer · int32 · required
averageStars
​number · double · required
GET/recruiting/groups
curl https://api.collegefootballdata.com/recruiting/groups \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "team": "team", "conference": "conference", "positionGroup": "positionGroup", "averageRating": 0, "totalRating": 0, "commits": 0, "averageStars": 0 } ]
json
application/json

bettingratings