Skip to content

CollegeFootballData.com API

by collegefootballdata.com

API keyHTTPSSports & Fitness
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
Base URL
https://api.collegefootballdata.com
Version
4.4.12
Endpoints
51
Spec updated
2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.collegefootballdata.com/calendar" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
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);
Python
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

MethodPathWhat it does
GET/calendarSeason calendar
GET/coachesCoaching records and history
GET/conferencesConferences
GET/draft/picksList of NFL Draft picks
GET/draft/positionsList of NFL positions
GET/draft/teamsList of NFL teams
GET/drivesDrive data and results
GET/game/box/advancedAdvanced box scores
GET/gamesGames and results
GET/games/mediaGame media information and schedules
GET/games/playersPlayer game stats
GET/games/teamsTeam game stats
GET/games/weatherGame weather information (Patreon only)
GET/linesBetting lines
GET/live/playsLive metrics and PBP (Patreon only)
GET/metrics/wpWin probability chart data
GET/metrics/wp/pregamePregame win probability data
GET/play/stat/typesTypes of player play stats
GET/play/statsPlay stats by play
GET/play/typesPlay types
GET/player/portalTransfer portal by season
GET/player/returningTeam returning production metrics
GET/player/searchSearch for player information
GET/player/usagePlayer usage metrics broken down by season
GET/playsPlay by play data
GET/ppa/gamesTeam Predicated Points Added (PPA/EPA) by game
GET/ppa/players/gamesPlayer Predicated Points Added (PPA/EPA) broken down by game
GET/ppa/players/seasonPlayer Predicated Points Added (PPA/EPA) broken down by season
GET/ppa/predictedPredicted Points (i.e. Expected Points or EP)
GET/ppa/teamsPredicted Points Added (PPA/EPA) data by team
GET/rankingsHistorical polls and rankings
GET/ratings/eloHistorical Elo ratings
GET/ratings/spHistorical SP+ ratings
GET/ratings/sp/conferencesHistorical SP+ ratings by conference
GET/ratings/srsHistorical SRS ratings
GET/recordsTeam records
GET/recruiting/groupsRecruit position group ratings
GET/recruiting/playersPlayer recruiting ratings and rankings
GET/recruiting/teamsTeam recruiting rankings and ratings
GET/rosterTeam rosters
GET/scoreboardLive game results (Patreon only)
GET/stats/categoriesTeam stat categories
GET/stats/game/advancedAdvanced team metrics by game
GET/stats/player/seasonPlayer stats by season
GET/stats/seasonTeam statistics by season
GET/stats/season/advancedAdvanced team metrics by season
GET/talentTeam talent composite rankings
GET/teamsTeam information
GET/teams/fbsFBS team list
GET/teams/matchupTeam matchup history
GET/venuesArena 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.

Compare alternatives →

Listed from public-apis (MIT), public-apis database (MIT), APIs.guru (CC0).