Open documentation ↗Overview
Unofficial detailed American college football statistics, records, and results API
CollegeFootballData.com is a sports & fitness API from collegefootballdata.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 51 endpoints.
At a glance
- Authentication
- API key
- HTTPS
- Yes
- CORS
- Unknown
- Category
- Sports & Fitness
- Base URL
https://api.collegefootballdata.com- Version
- 4.4.12
- Endpoints
- 51
- OpenAPI
- Specification ↗
- Spec updated
- 2023-03-06
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://api.collegefootballdata.com/calendar" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"const response = await fetch("https://api.collegefootballdata.com/calendar", {
method: "GET",
headers: {
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"GET",
"https://api.collegefootballdata.com/calendar",
headers={
"Accept": "application/json",
"X-API-Key": "YOUR_API_KEY",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| GET | /calendar | Season calendar |
| GET | /coaches | Coaching records and history |
| GET | /conferences | Conferences |
| GET | /draft/picks | List of NFL Draft picks |
| GET | /draft/positions | List of NFL positions |
| GET | /draft/teams | List of NFL teams |
| GET | /drives | Drive data and results |
| GET | /game/box/advanced | Advanced box scores |
| GET | /games | Games and results |
| GET | /games/media | Game media information and schedules |
| GET | /games/players | Player game stats |
| GET | /games/teams | Team game stats |
| GET | /games/weather | Game weather information (Patreon only) |
| GET | /lines | Betting lines |
| GET | /live/plays | Live metrics and PBP (Patreon only) |
| GET | /metrics/wp | Win probability chart data |
| GET | /metrics/wp/pregame | Pregame win probability data |
| GET | /play/stat/types | Types of player play stats |
| GET | /play/stats | Play stats by play |
| GET | /play/types | Play types |
| GET | /player/portal | Transfer portal by season |
| GET | /player/returning | Team returning production metrics |
| GET | /player/search | Search for player information |
| GET | /player/usage | Player usage metrics broken down by season |
| GET | /plays | Play by play data |
| GET | /ppa/games | Team Predicated Points Added (PPA/EPA) by game |
| GET | /ppa/players/games | Player Predicated Points Added (PPA/EPA) broken down by game |
| GET | /ppa/players/season | Player Predicated Points Added (PPA/EPA) broken down by season |
| GET | /ppa/predicted | Predicted Points (i.e. Expected Points or EP) |
| GET | /ppa/teams | Predicted Points Added (PPA/EPA) data by team |
| GET | /rankings | Historical polls and rankings |
| GET | /ratings/elo | Historical Elo ratings |
| GET | /ratings/sp | Historical SP+ ratings |
| GET | /ratings/sp/conferences | Historical SP+ ratings by conference |
| GET | /ratings/srs | Historical SRS ratings |
| GET | /records | Team records |
| GET | /recruiting/groups | Recruit position group ratings |
| GET | /recruiting/players | Player recruiting ratings and rankings |
| GET | /recruiting/teams | Team recruiting rankings and ratings |
| GET | /roster | Team rosters |
| GET | /scoreboard | Live game results (Patreon only) |
| GET | /stats/categories | Team stat categories |
| GET | /stats/game/advanced | Advanced team metrics by game |
| GET | /stats/player/season | Player stats by season |
| GET | /stats/season | Team statistics by season |
| GET | /stats/season/advanced | Advanced team metrics by season |
| GET | /talent | Team talent composite rankings |
| GET | /teams | Team information |
| GET | /teams/fbs | FBS team list |
| GET | /teams/matchup | Team matchup history |
| GET | /venues | Arena and venue information |
Questions
Does the CollegeFootballData.com API need an API key?
Yes. The CollegeFootballData.com API uses API key authentication; the documentation explains how to get credentials.
Does the CollegeFootballData.com API support HTTPS?
Yes, the CollegeFootballData.com API is served over HTTPS.
How many endpoints does the CollegeFootballData.com API have?
Its OpenAPI description lists 51 endpoints in version 4.4.12. All of them are shown on this page.
What are alternatives to the CollegeFootballData.com API?
Other Sports & Fitness APIs include Fitbit, TheSportsDB, Cloudbet, Sportmonks Cricket, balldontlie.
Similar sports & fitness APIs
Compare alternatives →Fitbit
Sports & FitnessYou'll fit in here. Using JavaScript, CSS, and SVG, developers now have a fast, easy way to build apps and clock faces for Fitbit OS.
TheSportsDB
Sports & FitnessCrowd-Sourced Sports Data and Artwork
Cloudbet
Sports & FitnessOfficial Cloudbet API provides real-time sports odds and betting API to place bets programmatically
Sportmonks Cricket
Sports & FitnessLive cricket score, player statistics and fantasy API
balldontlie
Sports & FitnessBalldontlie provides access to stats data from the NBA
Football (Soccer) Videos
Sports & FitnessEmbed codes for goals and highlights from Premier League, Bundesliga, Serie A and many more
Listed from public-apis (MIT), public-apis database (MIT), APIs.guru (CC0).