CollegeFootballData.com provides comprehensive college football data, including game scores, statistics, and recruiting information, accessible via a RESTful API.
CollegeFootballData.com provides comprehensive college football data, including game scores, statistics, and recruiting information, accessible via a RESTful API. On Nagent, College Football Data is exposed as a fully-configurable analytics integration that any agent can call — 56 actions, and API key authentication. No code is required to wire College Football Data into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use College Football Data to automate the kinds of tasks analytics teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire College Football Data into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against College Football Data, with input parameters and output schema. Drop these into any step of an agent built in Helix.
COLLEGE_FOOTBALL_DATA_ADVANCED_BOX_SCORERetrieves 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.
Input parameters
Unique game identifier from CFBD API. Obtain from Get Games and Results action.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_ADVANCED_GAME_STATSTool to retrieve advanced team metrics at the game level. Use when detailed offensive and defensive metrics (success rates, explosiveness, havoc) are needed.
Input parameters
Team filter by school name (e.g., 'Alabama', 'Ohio State'). Required if year is not specified.
Week number to filter games (e.g., 1–18).
Season year to filter games (e.g., 2023). Required if team is not specified.
Opponent filter by school name (e.g., 'Clemson').
Season type filter: 'regular', 'postseason', or 'both'. Defaults to 'regular' if not specified.
If true, exclude garbage time plays from calculations. Useful for more accurate metrics.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_ADVANCED_SEASON_STATS_TEAMRetrieve 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.
Input parameters
Team name filter (e.g., 'Alabama', 'Ohio State'). Required if 'year' is not specified. Use full school name.
Season year to retrieve stats for (e.g., 2023). Required if 'team' is not specified.
Ending week filter to narrow stats to a specific window within the season (1-15+).
Starting week filter to narrow stats to a specific window within the season (1-15+).
When true, excludes garbage time plays (late blowout plays) for more meaningful efficiency stats.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_BETTING_LINESTool to fetch betting lines and totals by game and provider. Use when you need current or historical betting line data filtered by specific criteria.
Input parameters
Filter by away team name (e.g., 'Clemson'). Only returns games where the specified team is away.
Filter by home team name (e.g., 'Alabama'). Only returns games where the specified team is home.
Filter by team name (e.g., 'Alabama', 'Ohio State'). Returns games where the team is either home or away.
Week number within the season (1-15 for regular season, varies for postseason).
Season year filter (e.g., 2023).
Filter by specific game ID.
Filter by conference abbreviation (e.g., 'SEC', 'Big Ten', 'ACC').
Season type filter: 'regular' for regular season games, 'postseason' for bowl games and playoffs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_COMPOSITE_TEAM_TALENTFetches 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.
Input parameters
Season year for team talent data (e.g., 2024). Data is available from 2015 onwards.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_CONFERENCE_MEMBERSHIPS_HISTORYTool 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.
Input parameters
Filter by conference name or abbreviation. Common values: 'SEC', 'B1G' (Big Ten), 'ACC', 'B12' (Big 12), 'PAC' (Pac-12), 'MWC' (Mountain West), 'AAC' (American Athletic), 'SBC' (Sun Belt), 'CUSA' (Conference USA). Use LIST_CONFERENCES action to get valid values. If not provided, returns all teams across all conferences.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_DIVISIONS_BY_CONFERENCETool to list FBS/FCS conference divisions with active years and metadata. Use after specifying an optional season year to filter active divisions.
Input parameters
Filter divisions active in the given season year (YYYY)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_CONFERENCE_SPRetrieve 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.
Input parameters
Season year for which to retrieve conference SP+ ratings (YYYY format, e.g., 2023)
Conference name or abbreviation to filter results (e.g., 'SEC', 'Big Ten', 'ACC')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_DRIVE_DATARetrieves 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).
Input parameters
Filter by team name (returns drives where team is on offense or defense). Use full school name like 'Alabama' or 'Ohio State'.
Week number filter within the season (1-15 for regular season).
Season year to filter drives (e.g., 2023). Required parameter.
Filter by defensive team name. Returns only drives where this team is on defense.
Filter by offensive team name. Returns only drives where this team is on offense.
Filter by conference abbreviation (e.g., 'SEC', 'Big Ten', 'ACC'). Returns drives involving teams from this conference.
Season type filter: 'regular' for regular season or 'postseason' for bowl games and playoffs.
Filter by defensive team's conference abbreviation.
Filter by offensive team's conference abbreviation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_FIELD_GOAL_EXPECTED_POINTSRetrieves 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_FPIRetrieves 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.
Input parameters
Team name to filter FPI ratings (e.g. 'Alabama', 'Ohio State'). Required if year is not specified. Can be combined with year to get a specific team's rating for a specific season.
Season year for which to retrieve FPI ratings (YYYY format, e.g. 2023). Required if team is not specified.
Conference abbreviation to filter results (e.g., 'SEC', 'Big Ten', 'ACC'). Optional filter that can be combined with year.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_GAME_HAVOC_STATSTool 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.
Input parameters
Team filter by school name (e.g., 'Alabama', 'Ohio State'). Required if year is not specified.
Optional week number filter within the season (e.g., 1-15 for regular season, 16+ for postseason).
Season year filter (e.g., 2023). Required if team is not specified.
Optional opponent filter by school name (e.g., 'Clemson').
Season type enumeration for havoc stats queries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_GAME_MEDIARetrieve 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'
Input parameters
Team name to filter results (e.g., 'Alabama', 'Ohio State', 'Notre Dame')
Week number within the season (1-15 for regular season, 1 for postseason/bowl games)
Season year (required). Example: 2024 for the 2024-2025 season
Filter by broadcast type: 'tv' for television, 'web' for streaming (ESPN+, Peacock), 'radio', 'ppv' for pay-per-view, 'mobile'
Conference abbreviation to filter results (e.g., 'SEC', 'Big Ten', 'ACC', 'Big 12')
Filter by season type: 'regular' for regular season, 'postseason' for bowl games/playoffs, 'both' for all games
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_GAMES_AND_RESULTSTool 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.
Input parameters
Single game filter by unique game ID.
Away team filter by school name.
Home team filter by school name.
Team filter by school name.
Week filter within the season.
Year/season filter for games.
Conference abbreviation filter.
Season segment; e.g., regular or postseason.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_PLAYER_GAME_STATSFetches 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).
Input parameters
Team name to filter by (e.g., 'Alabama', 'Ohio State'). Required if week and conference are not specified.
Week number within the season (1-15 for regular season, higher for postseason). Required if team and conference are not specified.
Required. Season year (e.g., 2023). Used with at least one of: week, team, or conference.
Specific game ID to retrieve stats for. Can be obtained from get_games_and_results action. Must still provide week, team, or conference.
Filter stats by category. Options: 'passing' (QB stats), 'rushing' (RB/run stats), 'receiving' (WR/TE stats), 'defensive' (tackles, sacks), 'fumbles', 'interceptions', 'punting', 'puntReturns', 'kicking' (FG/XP), 'kickReturns'.
Conference abbreviation to filter by (e.g., 'SEC', 'Big Ten', 'ACC', 'Big 12', 'Pac-12'). Required if week and team are not specified.
Filter by season phase: 'regular' for regular season games, 'postseason' for bowl games and playoffs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_PLAYER_USAGERetrieves 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.
Input parameters
Team name filter (e.g., 'Alabama', 'Ohio State', 'Michigan'). Case-sensitive.
Required. Season year for player usage data (e.g., 2023, 2024).
Player ID filter to retrieve usage data for a specific player.
Position abbreviation filter (e.g., 'QB', 'RB', 'WR', 'TE', 'OL', 'DL', 'LB', 'DB').
Conference abbreviation filter (e.g., 'SEC', 'Big Ten', 'Big 12', 'ACC', 'Pac-12').
Exclude garbage time plays from usage calculations. Defaults to false if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_PLAY_TYPESTool to fetch all available play types. Use when you need a catalog of play types for filtering or referencing play data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_PREDICTED_POINTS_ADDED_BY_TEAMTool 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.
Input parameters
Team filter, required if year not specified. Team name or abbreviation to filter by.
Year filter, required if team not specified. Season year to filter PPA data.
Conference abbreviation filter to narrow results to a specific conference.
If true, exclude garbage time plays from PPA calculations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_PREGAME_WIN_PROBABILITIESTool 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.
Input parameters
Filter by team name (e.g., 'Alabama', 'Ohio State'). Returns games where the specified team is either home or away.
Week number filter within the season (1-15 for regular season, varies for postseason). Narrows results to a specific week.
Season year filter (e.g., 2024). Returns win probabilities for games in the specified season.
Season type for filtering pregame win probabilities.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_RECRUITSRetrieves 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.
Input parameters
Team filter by school name (e.g., 'Alabama', 'Ohio State'). Required when year is not specified.
Year filter for recruiting class (e.g., 2023, 2024). Required when team is not specified.
Optional state/province filter to narrow results by recruit's home state (e.g., 'FL', 'TX', 'CA').
Optional position categorization filter (e.g., 'QB', 'WR', 'RB', 'OL', 'DL'). Use to filter recruits by position.
Classification types for recruits.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_STATS_CATEGORIESTool to fetch all available team statistical categories. Use when you need to discover valid category names for statistical analysis or filtering team stats.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_TEAM_GAME_STATSFetch 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.
Input parameters
Team school name to filter by (e.g., 'Alabama', 'Ohio State', 'Michigan'). Required unless week or conference is provided.
Week number (1-20). Required unless team or conference is provided. Weeks 1-15 are regular season, 16+ are postseason.
Required. Season year (e.g., 2024). College football data is available from 1869 onwards.
Specific game ID filter. Can be combined with week/team/conference for targeted lookup. Does not satisfy the requirement for week/team/conference alone.
Conference abbreviation filter. Common values: 'SEC', 'B1G' (Big Ten), 'Big 12', 'ACC', 'Pac-12'. Required unless week or team is provided.
Season type filter. Use 'regular' for regular season games or 'postseason' for bowl games and playoffs. Defaults to all types if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_TEAM_RECRUITING_RANKINGSRetrieve 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.
Input parameters
Optional filter by team name. Use exact team name (e.g., 'Alabama', 'Ohio State'). Returns rankings only for the specified team.
Optional filter for recruiting class year (YYYY format). Returns rankings for the specified recruiting year.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_TEAMS_ATSTool 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.
Input parameters
Optional team filter (e.g., 'Alabama', 'Ohio State').
Required year filter for which to retrieve ATS statistics.
Optional conference filter (e.g., 'SEC', 'Big Ten', 'ACC').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_USER_INFORetrieves 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_GET_WIN_PROBABILITYTool 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.
Input parameters
Required game ID to retrieve win probability data for. Must be a valid game identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_LIST_COACHES_AND_HISTORYTool to get coaching records and history. Use when you need coaches’ season-by-season data with optional filters.
Input parameters
Filter by team or school name
Filter by specific season year
Filter by maximum season year (inclusive)
Filter by minimum season year (inclusive)
Filter by coach's last name
Filter by coach's first name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_LIST_CONFERENCESRetrieves 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_LIST_FBS_TEAMSTool to list FBS teams for a given season. Use after selecting the season year to retrieve all FBS teams.
Input parameters
Season year to filter FBS teams (e.g., 2025)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_LIST_FCS_TEAMSTool 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.
Input parameters
Season year to filter FCS teams (e.g., 2025)
Conference to filter FCS teams (e.g., 'SoCon')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_LIST_TEAMSRetrieve 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.
Input parameters
Filter teams by season year (YYYY format). Returns teams that existed in the specified season. Without this filter, returns all teams including historical ones.
Filter by conference abbreviation. Common values: 'SEC', 'B1G' (Big Ten), 'ACC', 'Big 12', 'Pac-12', 'AAC', 'MWC', 'Sun Belt', 'MAC', 'CUSA'. Use LIST_CONFERENCES action to get all valid conference abbreviations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_LIST_VENUES_STADIUMSTool to list college football venues with metadata (name, capacity, location, etc.). Use when you need detailed venue information for a specific season.
Input parameters
Season year in YYYY format to filter venues
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_NFL_DRAFT_PICKSTool to list NFL Draft picks. Use when you need draft pick data by year, round, team, player, etc.
Input parameters
Pick number within the round
NFL team location name (e.g., 'Carolina', 'New England', 'Houston'). Use COLLEGE_FOOTBALL_DATA_NFL_DRAFT_TEAMS to get valid team names.
Draft year (e.g., 2025)
Maximum number of results to return
Draft round number (starting at 1)
Number of results to skip for paging
College program name filter (e.g., 'Alabama', 'Ohio State')
Overall pick number
Player position filter. Use COLLEGE_FOOTBALL_DATA_NFL_DRAFT_POSITIONS to get valid position values.
College conference name filter (e.g., 'SEC', 'Big Ten')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_NFL_DRAFT_POSITIONSRetrieves 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_NFL_DRAFT_TEAMSTool to list NFL teams used in draft endpoints. Use when preparing to retrieve NFL draft data by team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_PLAY_BY_PLAY_DATATool to fetch play-by-play data for college football games. Use when you need detailed play logs filtered by season, week, team, or game.
Input parameters
Team name filter (school name or abbreviation)
Week number within the season
4-digit season year filter
Specific game ID filter
Defense team filter (school name or abbreviation)
Offense team filter (school name or abbreviation)
Play type filter (e.g., pass, run)
Conference abbreviation filter (e.g., SEC)
Season phase filter; 'regular' or 'postseason'
Defense conference abbreviation filter (e.g., ACC)
Offense conference abbreviation filter (e.g., SEC)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_PLAY_STATS_PLAYERFetch 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.
Input parameters
Team name filter (school name, e.g., 'Alabama', 'Ohio State').
Week number filter within the season (1-25).
Season year filter (e.g., 2024). Recommended to always specify.
Filter by specific CFBD game ID.
Filter by specific CFBD athlete ID.
Season type filter: 'regular', 'postseason', or 'both'.
Filter by specific stat type ID (see Play Stat Types endpoint for valid IDs).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_PLAY_STAT_TYPESTool to fetch all play-level stat type definitions. Use when you need a catalog of available play stat types for filtering or referencing.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_PPA_PLAYER_BY_GAME_ACTIONRetrieve 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.
Input parameters
Team school name (e.g., 'Alabama', 'Ohio State'). Required if 'week' is not specified. Case-sensitive.
Week number to filter (1-15 regular season, higher for postseason). Required if 'team' is not specified.
Season year to filter PPA stats (e.g., 2023). Highly recommended for efficient queries.
Unique player ID to filter for a specific player. Still requires 'week' or 'team' to be set.
Position filter: QB (Quarterback), RB (Running Back), WR (Wide Receiver), TE (Tight End).
Minimum number of plays threshold. Only returns players with at least this many plays in the game.
If true, exclude garbage time plays (low-leverage plays in blowout games) from calculations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_PPA_PLAYER_BY_SEASONTool to fetch player-level PPA/EPA aggregated by season. Use when you need seasonal PPA metrics for specific players or groups after applying filters.
Input parameters
Team name to filter by (e.g., 'Alabama', 'Ohio State').
Season year to filter results (e.g., 2023).
CFBD player ID to retrieve PPA data for a specific player across all seasons.
Position abbreviation to filter by (e.g., 'QB').
Minimum number of plays a player must have to be included in results.
Conference abbreviation to filter by (e.g., 'SEC').
If true, exclude garbage time plays from calculations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_PPA_PREDICTED_POINTS_EPGet 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.
Input parameters
The down number (1-4). Example: 1 for 1st down, 3 for 3rd down.
Distance to go in yards (yards needed for a first down). Example: 10 for 1st and 10.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_PPA_TEAM_BY_GAMETool 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.
Input parameters
Team filter by school name or abbreviation.
Week number filter within the season.
Season year to filter PPA by game.
Filter games on or before this date (YYYY-MM-DD).
Filter games on or after this date (YYYY-MM-DD).
Conference abbreviation filter.
Season segment: 'regular' or 'postseason'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_RANKINGS_POLLSRetrieve 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.
Input parameters
Optional week number of the season to retrieve rankings
Season year in YYYY format to filter rankings
Optional season type filter. One of: 'regular', 'postseason', 'both', 'allstar', 'spring_regular', 'spring_postseason'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_RATINGS_ELOTool to retrieve Elo ratings for college football teams. Use when you need historical Elo ratings by season or for a specific team.
Input parameters
Team name to filter Elo ratings for a single team
Season year for which to retrieve Elo ratings (YYYY)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_RATINGS_SP_PLUSRetrieve 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.
Input parameters
Team name to filter SP+ ratings (e.g. 'Alabama', 'Ohio State'). Required if year is not specified. Can be combined with year to get a specific team's rating for a specific season.
Season year for which to retrieve SP+ ratings (YYYY format, e.g. 2023). Required if team is not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_RATINGS_SRSRetrieves 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.
Input parameters
Full team name (e.g., 'Alabama', 'Ohio State'). Required if year is not specified. Returns historical ratings for the team.
Season year (YYYY format). Required if team is not specified. Returns all team ratings for the given season.
Conference abbreviation to filter results (e.g., 'SEC', 'Big Ten', 'ACC', 'Big 12', 'Pac-12'). Optional filter.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_RECRUITING_GROUP_DICTIONARYRetrieves 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.
Input parameters
Full team name to filter results (e.g., 'Alabama').
Inclusive end year for recruiting data aggregation; must be >= startYear.
Inclusive start year for recruiting data aggregation.
Conference abbreviation to filter results (e.g., 'SEC').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_RECRUITING_TRANSFER_PORTALRetrieves 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.
Input parameters
Season year for transfer portal data (e.g., 2024, 2025). Data available from 2021 onwards.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_RETURNING_PRODUCTION_TEAMTool 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.
Input parameters
Team name to filter results (e.g., 'Alabama', 'Ohio State'). Required if year is not specified.
Season year (YYYY) to query returning production data. Required if team is not specified.
Conference abbreviation to filter results (e.g., 'SEC', 'Big Ten'). Only used alongside year or team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_SEARCH_PLAYERSSearch 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.
Input parameters
Optional team name filter to narrow search to players from a specific team (e.g., 'Alabama', 'Ohio State').
Optional year filter to narrow search to players active in a specific season.
Optional position abbreviation filter to narrow search to players at a specific position (e.g., 'QB', 'RB', 'WR', 'LB', 'DB').
Search term for matching player name (first name, last name, or full name). Returns top 100 results matching the search term.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_SEASON_STATS_PLAYERFetch 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.
Input parameters
Filter by team school name (e.g., 'Alabama', 'Ohio State', 'Michigan'). Case-sensitive.
Required. Season year for player stats (e.g., 2023, 2024).
Filter stats up to this week number (inclusive). Use with startWeek to define a range.
Filter by stat category. Common values: 'passing', 'rushing', 'receiving', 'defensive', 'interceptions', 'kicking', 'punting', 'kickReturns', 'puntReturns'.
Filter stats from this week number onward (inclusive). Week 1 is the season start.
Filter by conference abbreviation (e.g., 'SEC', 'Big Ten', 'Big 12', 'ACC', 'Pac-12').
Season phase filter. Options: 'regular' (default), 'postseason', or 'both'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_SEASON_STATS_TEAMTool to get basic season stats aggregated by team and season. Use when you need a summary of team-level statistics for a particular season.
Input parameters
Filter by school/team name, e.g., 'Alabama'
Season year in YYYY format (e.g., 2023 for the 2023 college football season)
Ending week number (must be >= startWeek)
Starting week number (1-based)
Filter by conference abbreviation (e.g., 'SEC', 'B1G', 'ACC', 'Big 12', 'Pac-12')
Season type to include: 'regular', 'postseason', or 'both'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_SEASON_TYPES_DICTIONARYRetrieve 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.
Input parameters
The season year to retrieve available season types for. Required. Common types include 'regular' and 'postseason'. Some years (like 2020-2021) may have additional types such as 'spring_regular' and 'spring_postseason'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_TEAM_MATCHUP_HISTORYTool to retrieve head-to-head team matchup records over a date range. Use after selecting two FBS teams to compare their matchup history.
Input parameters
First team name (FBS) to query head-to-head history.
Second team name (FBS) to query head-to-head history.
Maximum season year (YYYY) to include in results.
Minimum season year (YYYY) to include in results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_TEAM_RECORDSRetrieve 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.
Input parameters
Team/school name filter (e.g., 'Alabama', 'Ohio State', 'Michigan').
Season year for which to retrieve team records (must be >= 1869).
Limit the number of results returned (for pagination).
Number of records to skip for pagination.
NCAA division filter: 'fbs' (Division I FBS), 'fcs' (Division I FCS), 'd1', 'd2', or 'd3'.
Conference abbreviation filter (e.g., 'SEC', 'ACC', 'Big Ten', 'Big 12', 'Pac-12').
Type of season to include: 'regular', 'postseason', or 'all'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COLLEGE_FOOTBALL_DATA_TEAM_ROSTERFetches 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.
Input parameters
Team name (e.g., 'Alabama', 'Ohio State', 'Michigan'). Must be exact team name.
Season year for the roster (2009-present).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 76 agents privately built on Nagent that already use College Football Data.
Build on Nagent
Connect College Football Data to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find College Football Data, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, College Football Data is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once College Football Data is connected, you configure its 56 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop College Football Data steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a College Football Data event fires, the agent kicks off automatically.
Every College Football Data action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While College Football Data ships with 56 pre-built analytics actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching College Football Data together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build College Football Data-based workflows tailored to your business.