College Football Data

56 tools available

CollegeFootballData.com provides comprehensive college football data, including game scores, statistics, and recruiting information, accessible via a RESTful API.

analytics

Connect College Football Data Visit College Football Data ↗

Connect College Football Data to Definable to answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas call College Football Data's 56 tools directly from chat or scheduled flows. Plug into a data-analysis persona to ask questions in plain English — the agent runs the queries.

Common workflows with College Football Data

Weekly anomaly digest

Query metrics from this tool
Compare against rolling baseline
Surface anomalies with reasoning

Funnel deep-dive

Pull funnel events for a date range
Compute drop-offs at each step
Generate a written analysis

Cohort answers on demand

User asks a question in chat
Agent translates it to a query
Returns numbers + a chart-ready summary

College Football Data actions 56

Every College Football Data action below is a callable tool any Definable persona can invoke.

Advanced Box Score

Retrieves advanced analytics for a single college football game including: - Team metrics: PPA (Predicted Points Added), success rates, rushing efficiency, havoc rates, scoring opportunities - Player metrics: Usage rates by quarter and play type, individual PPA breakdowns - Game info: Teams, scores, win probabilities, excitement index Requires a valid gameId from Get Games and Results action. Returns detailed breakdown by quarter.

Advanced Game Stats

Tool to retrieve advanced team metrics at the game level. Use when detailed offensive and defensive metrics (success rates, explosiveness, havoc) are needed.

Advanced Season Stats by Team

Retrieve advanced season-level team statistics including PPA (Predicted Points Added), success rates, explosiveness, havoc metrics, and rushing/passing efficiency breakdowns. Use this for in-depth team performance analysis beyond basic stats. At least one of 'year' or 'team' must be provided.

Betting Lines

Tool to fetch betting lines and totals by game and provider. Use when you need current or historical betting line data filtered by specific criteria.

Composite Team Talent

Fetches 247Sports composite team talent rankings for a given season. Returns a list of all FBS teams ranked by their composite talent score, which is based on aggregate recruit ratings. Higher scores indicate rosters with more highly-rated recruits.

Conference Memberships

Tool to retrieve current conference memberships for college football teams. Returns which teams belong to which conference, optionally filtered by conference. Use to find all teams in a specific conference or to see the current conference landscape.

Divisions by Conference

Tool to list FBS/FCS conference divisions with active years and metadata. Use after specifying an optional season year to filter active divisions.

Get Conference SP+ Ratings

Retrieve aggregated historical conference SP+ (Success Rate + Points Per Play) ratings for college football conferences. Use this to get conference-level offensive, defensive, and special teams metrics aggregated from all teams in each conference. Filter by year to get specific season data, or by conference name to get historical ratings for a specific conference.

Get Drive Data

Retrieves college football drive-level data including offensive/defensive teams, yards gained, drive results (TD, PUNT, INT, etc.), time elapsed, and scoring information. Use to analyze drive efficiency, red zone performance, or game flow. Requires year; optionally filter by week, team, conference, or season type (regular/postseason).

Get Field Goal Expected Points

Retrieves field goal expected points values for various field positions and distances. Returns static model data showing expected points for field goal attempts based on distance. Useful for analyzing field goal decision-making and expected value calculations.

FPI Ratings

Retrieves historical Football Power Index (FPI) ratings for college football teams. FPI is ESPN's measure that predicts team strength and game outcomes. Use this to get team ratings, efficiency metrics, and resume rankings. Specify a year to get all teams' ratings for that season, or a team name to get historical ratings, or both for a specific team-season combination.

Get Game Havoc Stats

Tool to retrieve havoc statistics aggregated by game. Use when you need game-level havoc metrics including DB havoc rate, front seven havoc rate, and total havoc events for offense and defense.

Get Game Media

Retrieve broadcast information for college football games including TV channels, streaming platforms, and radio outlets. Use this to find where games are being broadcast. Returns information about the broadcaster/outlet, start time, and teams involved. Common use cases: - Find TV channel for a specific game: set year, week, and team - Get all broadcasts for a conference: set year and conference - Find streaming options: set mediaType='web' - Get bowl game broadcasts: set seasonType='postseason'

Get Games and Results

Tool to retrieve college American football games and results for a given season/week/team. Use when you need game schedules or outcomes filtered by specific criteria. Covers NCAA only; NFL and other sports return no data. Overly narrow filter combinations (e.g., mismatched `team` and `conference`) may yield zero results — relax filters if the response is empty.

Get Player Game Stats

Fetches detailed player statistics for college football games. Returns individual player stats (passing, rushing, receiving, defensive, kicking, etc.) organized by game and team. Use cases: - Get QB passing stats for a specific team's games - View rushing leaders for a conference in a given week - Analyze defensive stats for postseason games NOTE: Requires 'year' plus at least one of: 'week', 'team', or 'conference'. Use 'category' filter to limit results to specific stat types (recommended for faster responses).

Get Player Usage

Retrieves player usage data for a given season. Returns usage percentages across different play situations (overall, passing, rushing, by down, etc.). Use this to analyze how frequently players are involved in plays, filtered by team, conference, position, or specific player.

Get Play Types

Tool to fetch all available play types. Use when you need a catalog of play types for filtering or referencing play data.

Get Predicted Points Added By Team

Tool to retrieve historical team Predicted Points Added (PPA) metrics by season. Use when you need season-level PPA performance data for teams to analyze offensive and defensive efficiency across play types and down situations.

Get Pregame Win Probabilities

Tool to retrieve pregame win probabilities for college football games. Use when you need predictive data about game outcomes before they are played, filtered by season, week, or team.

Get Recruits

Retrieves player recruiting rankings from the College Football Data API. Returns detailed information about high school, prep school, and junior college recruits including star ratings, composite ratings, rankings, physical measurements, and commitment status. Use this action to analyze recruiting classes by year or team, compare recruits by position or location, or track where top prospects commit. At least one of year or team parameters must be provided.

Get Stats Categories

Tool to fetch all available team statistical categories. Use when you need to discover valid category names for statistical analysis or filtering team stats.

Get Team Game Stats

Fetch team-level box score statistics for college football games. Returns detailed game stats including offense (rushing/passing yards, TDs, turnovers), defense (tackles, sacks, interceptions), and special teams (kick/punt returns) for each team. Use cases: - Get box scores for a specific team's games in a season - Compare team performance across conference games in a given week - Analyze offensive/defensive stats for a specific matchup Note: At least one of week, team, or conference must be provided to filter results.

Get Team Recruiting Rankings

Retrieve team recruiting rankings from the College Football Data API. Returns composite recruiting rankings based on recruit star ratings and commitments. Use to compare recruiting success across teams or track a team's recruiting performance over time.

Get Teams ATS Records

Tool to retrieve against-the-spread (ATS) summary by team. Use when you need historical betting performance data showing how teams performed relative to point spreads.

Get User Info

Retrieves information about the authenticated user from the College Football Data API. Returns the user's Patreon subscription level and remaining API calls for rate limit monitoring. Use this to check your current API quota and subscription status.

Get Win Probability

Tool to query play-by-play win probabilities for a specific game. Use when you need detailed probability metrics showing how win likelihood changed throughout the game.

List Coaches and History

Tool to get coaching records and history. Use when you need coaches’ season-by-season data with optional filters.

List Conferences

Retrieves all college football conferences from the College Football Data API. Returns conferences across all NCAA divisions (FBS, FCS, Division II, Division III). Use this to get conference IDs for filtering other API calls or to display conference information. No parameters required - returns the complete list of conferences.

List FBS Teams

Tool to list FBS teams for a given season. Use after selecting the season year to retrieve all FBS teams.

List FCS Teams

Tool to list FCS teams for a given season and conference. Use when you need a list of FCS programs filtered by season year and conference.

List Teams

Retrieve a list of college football teams from the CFBD (College Football Data) API. Use this action to: - Get all college football teams (call with no parameters) - Get teams from a specific season (use year parameter) - Get teams from a specific conference (use conference parameter) - Combine filters to get conference teams for a specific season Returns team details including: name, mascot, abbreviation, conference, classification (FBS/FCS/D2/D3), team colors, logos, Twitter handle, and stadium/venue information.

List Venues and Stadiums

Tool to list college football venues with metadata (name, capacity, location, etc.). Use when you need detailed venue information for a specific season.

NFL Draft Picks

Tool to list NFL Draft picks. Use when you need draft pick data by year, round, team, player, etc.

NFL Draft Positions

Retrieves the standardized list of NFL draft positions. Returns all position names and abbreviations used to classify players in NFL drafts. Useful for filtering draft picks by position or understanding position categories in draft analysis. No parameters required.

NFL Draft Teams

Tool to list NFL teams used in draft endpoints. Use when preparing to retrieve NFL draft data by team.

Play-by-Play Data

Tool to fetch play-by-play data for college football games. Use when you need detailed play logs filtered by season, week, team, or game.

Play Stats Player

Fetch player-level statistics tied to individual plays. Returns detailed stats for each player's contribution to a play (rushes, receptions, completions, etc.). Use this when you need: - Play-by-play player statistics - Granular data on individual player performance per play - Analysis of a specific athlete's game contributions Note: Recommend filtering by year/week/team or gameId to limit result size.

Play Stat Types

Tool to fetch all play-level stat type definitions. Use when you need a catalog of available play stat types for filtering or referencing.

Player PPA by Game

Retrieve player-level PPA (Predicted Points Added) / EPA (Expected Points Added) stats for individual games. PPA measures how many points a player adds/subtracts compared to average performance on similar plays. Use this tool to analyze individual player contributions per game, filtered by season, week, team, or position. IMPORTANT: Either 'week' OR 'team' must be specified in the request.

PPA Player By Season

Tool to fetch player-level PPA/EPA aggregated by season. Use when you need seasonal PPA metrics for specific players or groups after applying filters.

Predict Expected Points (EP)

Get expected points (EP) for all field positions given a specific down and distance scenario. Returns expected points values for yard lines 1-99, useful for analyzing game situations and fourth-down decisions. Common scenarios: 1st and 10, 3rd and short, 4th and goal.

PPA Team By Game

Tool to retrieve team Predicted Points Added (PPA) by game. Use when you need team-level PPA metrics for games after filtering by season, week, team, or date.

Rankings Polls

Retrieve college football poll rankings (AP Top 25, Coaches Poll, Playoff Committee, FCS, Division II/III). Returns weekly rankings including team rank, school name, conference, first-place votes, and points. Use this tool to look up historical or current poll standings for any season from 1900 to present. Required: year (e.g., 2023). Optional: season_type (regular/postseason), week number.

Elo Ratings

Tool to retrieve Elo ratings for college football teams. Use when you need historical Elo ratings by season or for a specific team.

SP+ Ratings

Retrieve SP+ (Success Rate + Points Per Play) team ratings for college football. SP+ is an advanced tempo- and opponent-adjusted measure of college football efficiency. Use this to get overall team ratings, offensive/defensive rankings, and special teams metrics. Specify a year to get all teams' ratings for that season, or a team name to get historical ratings across seasons, or both for a specific team-season combination.

SRS Ratings

Retrieves Simple Rating System (SRS) team ratings. SRS measures team strength based on point differential adjusted for strength of schedule. Either year or team parameter must be provided. Use year to get all teams' ratings for a season, or team to get historical ratings for a specific team.

Recruiting Group Dictionary

Retrieves aggregated college football recruiting data grouped by position. Use this tool to analyze recruiting performance by position group for specific teams or conferences. Returns composite ratings, star averages, and commit counts by position group (e.g., Quarterback, Receiver, Defensive Back). Useful for comparing recruiting strength across different positions or evaluating team/conference recruiting patterns.

Recruiting Transfer Portal

Retrieves NCAA college football transfer portal entries for a given season. Returns player transfer information including origin school, destination school (if committed), position, star rating, transfer rating, transfer date, and eligibility status. Useful for tracking player movement between schools, analyzing transfer trends, and identifying key transfers. Data is available from 2021 onwards when the transfer portal became widely used.

Returning Production by Team

Tool to fetch Bill Connelly–style returning production splits by team and season. Use when evaluating returning offense, defense, and overall production for teams in a given season.

Search Players

Search for college football players by name. Returns top 100 results matching the search term. Use this action to find players by name and optionally filter by year, team, or position.

Season Stats Player

Fetch aggregated season statistics for college football players. Returns individual player stats by category (passing, rushing, receiving, defensive, kicking, etc.) for a specified year. Useful for comparing player performance across a season or filtering by team/conference.

Season Team Stats

Tool to get basic season stats aggregated by team and season. Use when you need a summary of team-level statistics for a particular season.

Season Types Dictionary

Retrieve the list of available season types for a specific college football year. Returns types like 'regular', 'postseason', and for certain years 'spring_regular', 'spring_postseason'. Use this to discover valid seasonType values to pass to other endpoints.

Team Matchup History

Tool to retrieve head-to-head team matchup records over a date range. Use after selecting two FBS teams to compare their matchup history.

Get team season records

Retrieve college football team win-loss records for a specific season. Returns detailed breakdowns including total, conference, home, away, neutral site, regular season, and postseason records. Requires a year parameter. Optionally filter by team name, conference, division, or season type.

Get Team Roster

Fetches the roster for a college football team for a specific season. Returns player details including name, position, height, weight, jersey number, academic year, and hometown info. Use this to get player information for any FBS or FCS team from 2009 onwards.

Frequently asked questions

What can I automate with College Football Data on Definable?

Anything College Football Data exposes through its API. Common analytics workflows on Definable include answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas can call any of the 56 College Football Data tools directly, then chain the result into another integration without you writing code.

How does College Football Data authentication work?

College Football Data uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the College Football Data integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 56 College Football Data tools. You only need a separate College Football Data subscription if College Football Data itself charges per seat or per API call.

Is using College Football Data through Definable secure?

Every call from a persona to College Football Data is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with College Football Data on Definable?

Sign up for Definable, open the integrations page, find College Football Data, and connect via OAuth or API key. You can immediately attach College Football Data to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What College Football Data actions does Definable expose?

Definable exposes all 56 College Football Data actions as callable tools — including `Advanced Box Score`, `Advanced Game Stats`, `Advanced Season Stats by Team`, plus 53 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with College Football Data?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations