Skip to main content
College Football Data logo
  • Category: analytics
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 56
  • Triggers: 0
  • Slug: COLLEGE_FOOTBALL_DATA
  • Version: 20261101_00

Tools

Slug: 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

integer
required
Unique game identifier from CFBD API. Obtain from Get Games and Results action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_ADVANCED_GAME_STATSRetrieve advanced team metrics at the game level, including offensive and defensive success rates, explosiveness, PPA, and situational breakdowns.

Input Parameters

string
Team filter by school name (e.g., ‘Alabama’, ‘Ohio State’). Required if year is not specified.
integer
Week number to filter games (e.g., 1–18).
integer
Season year to filter games (e.g., 2023). Required if team is not specified.
string
Opponent filter by school name (e.g., ‘Clemson’).
string ("regular" | "postseason" | "both")
Season type filter: ‘regular’, ‘postseason’, or ‘both’. Defaults to ‘regular’ if not specified.
boolean
If true, exclude garbage time plays from calculations. Useful for more accurate metrics.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team name filter (e.g., ‘Alabama’, ‘Ohio State’). Required if ‘year’ is not specified. Use full school name.
integer
Season year to retrieve stats for (e.g., 2023). Required if ‘team’ is not specified.
integer
Ending week filter to narrow stats to a specific window within the season (1-15+).
integer
Starting week filter to narrow stats to a specific window within the season (1-15+).
boolean
When true, excludes garbage time plays (late blowout plays) for more meaningful efficiency stats.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Filter by away team name (e.g., ‘Clemson’). Only returns games where the specified team is away.
string
Filter by home team name (e.g., ‘Alabama’). Only returns games where the specified team is home.
string
Filter by team name (e.g., ‘Alabama’, ‘Ohio State’). Returns games where the team is either home or away.
integer
Week number within the season (1-15 for regular season, varies for postseason).
integer
Season year filter (e.g., 2023).
integer
Filter by specific game ID.
string
Filter by conference abbreviation (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’).
string ("regular" | "postseason")
Season type filter: ‘regular’ for regular season games, ‘postseason’ for bowl games and playoffs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
required
Season year for team talent data (e.g., 2024). Data is available from 2015 onwards.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_DIVISIONS_BY_CONFERENCEList conference divisions represented by team records, optionally filtered by season year. Results include conference and division names and may include classification tier.

Input Parameters

integer
Filter divisions active in the given season year (YYYY)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Season year for which to retrieve conference SP+ ratings (YYYY format, e.g., 2023)
string
Conference name or abbreviation to filter results (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Filter by team name (returns drives where team is on offense or defense). Use full school name like ‘Alabama’ or ‘Ohio State’.
integer
Week number filter within the season (1-15 for regular season).
integer
required
Season year to filter drives (e.g., 2023). Required parameter.
string
Filter by defensive team name. Returns only drives where this team is on defense.
string
Filter by offensive team name. Returns only drives where this team is on offense.
string
Filter by conference abbreviation (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’). Returns drives involving teams from this conference.
string ("regular" | "postseason")
Season type filter: ‘regular’ for regular season or ‘postseason’ for bowl games and playoffs.
string
Filter by defensive team’s conference abbreviation.
string
Filter by offensive team’s conference abbreviation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
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.
integer
Season year for which to retrieve FPI ratings (YYYY format, e.g. 2023). Required if team is not specified.
string
Conference abbreviation to filter results (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’). Optional filter that can be combined with year.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team filter by school name (e.g., ‘Alabama’, ‘Ohio State’). Required if year is not specified.
integer
Optional week number filter within the season (e.g., 1-15 for regular season, 16+ for postseason).
integer
Season year filter (e.g., 2023). Required if team is not specified.
string
Optional opponent filter by school name (e.g., ‘Clemson’).
string ("regular" | "postseason" | "both" | "allstar" | "spring_regular" | "spring_postseason")
Season type enumeration for havoc stats queries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_GET_GAME_MEDIARetrieve college football game broadcast listings, including TV, streaming, and radio outlets, start times, and teams. Requires a season year and supports filters for week, team, conference, season type, and media type.

Input Parameters

string
Team name to filter results (e.g., ‘Alabama’, ‘Ohio State’, ‘Notre Dame’)
integer
Week number within the season (1-15 for regular season, 1 for postseason/bowl games)
integer
required
Season year (required). Example: 2024 for the 2024-2025 season
string ("tv" | "radio" | "web" | "ppv" | "mobile")
Filter by broadcast type: ‘tv’ for television, ‘web’ for streaming (ESPN+, Peacock), ‘radio’, ‘ppv’ for pay-per-view, ‘mobile’
string
Conference abbreviation to filter results (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’, ‘Big 12’)
string ("regular" | "postseason" | "both")
Filter by season type: ‘regular’ for regular season, ‘postseason’ for bowl games/playoffs, ‘both’ for all games

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Single game filter by unique game ID.
string
Away team filter by school name.
string
Home team filter by school name.
string
Team filter by school name.
integer
Week filter within the season.
integer
required
Year/season filter for games.
string
Conference abbreviation filter.
string ("regular" | "postseason")
Season segment; e.g., regular or postseason.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team name to filter by (e.g., ‘Alabama’, ‘Ohio State’). Required if week and conference are not specified.
integer
Week number within the season (1-15 for regular season, higher for postseason). Required if team and conference are not specified.
integer
required
Required. Season year (e.g., 2023). Used with at least one of: week, team, or conference.
integer
Specific game ID to retrieve stats for. Can be obtained from get_games_and_results action. Must still provide week, team, or conference.
string ("passing" | "rushing" | "receiving" | "defensive" | "fumbles" | "interceptions" | "punting" | "puntReturns" | "kicking" | "kickReturns")
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’.
string
Conference abbreviation to filter by (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’, ‘Big 12’, ‘Pac-12’). Required if week and team are not specified.
string ("regular" | "postseason")
Filter by season phase: ‘regular’ for regular season games, ‘postseason’ for bowl games and playoffs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team name filter (e.g., ‘Alabama’, ‘Ohio State’, ‘Michigan’). Case-sensitive.
integer
required
Required. Season year for player usage data (e.g., 2023, 2024).
integer
Player ID filter to retrieve usage data for a specific player.
string
Position abbreviation filter (e.g., ‘QB’, ‘RB’, ‘WR’, ‘TE’, ‘OL’, ‘DL’, ‘LB’, ‘DB’).
string
Conference abbreviation filter (e.g., ‘SEC’, ‘Big Ten’, ‘Big 12’, ‘ACC’, ‘Pac-12’).
boolean
Exclude garbage time plays from usage calculations. Defaults to false if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team filter, required if year not specified. Team name or abbreviation to filter by.
integer
Year filter, required if team not specified. Season year to filter PPA data.
string
Conference abbreviation filter to narrow results to a specific conference.
boolean
If true, exclude garbage time plays from PPA calculations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_GET_PREGAME_WIN_PROBABILITIESRetrieve pregame win probabilities for college football games, filtered by season, week, or team. Probabilities are derived from available point spreads; games without a qualifying spread are omitted.

Input Parameters

string
Filter by team name (e.g., ‘Alabama’, ‘Ohio State’). Returns games where the specified team is either home or away.
integer
Week number filter within the season (1-15 for regular season, varies for postseason). Narrows results to a specific week.
integer
Season year filter (e.g., 2024). Returns win probabilities for games in the specified season.
string ("regular" | "postseason" | "both" | "allstar" | "spring_regular" | "spring_postseason")
Season type for filtering pregame win probabilities.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team filter by school name (e.g., ‘Alabama’, ‘Ohio State’). Required when year is not specified.
integer
Year filter for recruiting class (e.g., 2023, 2024). Required when team is not specified.
string
Optional state/province filter to narrow results by recruit’s home state (e.g., ‘FL’, ‘TX’, ‘CA’).
string
Optional position categorization filter (e.g., ‘QB’, ‘WR’, ‘RB’, ‘OL’, ‘DL’). Use to filter recruits by position.
string ("JUCO" | "PrepSchool" | "HighSchool")
Classification types for recruits.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team school name to filter by (e.g., ‘Alabama’, ‘Ohio State’, ‘Michigan’). Required unless week or conference is provided.
integer
Week number (1-20). Required unless team or conference is provided. Weeks 1-15 are regular season, 16+ are postseason.
integer
required
Required. Season year (e.g., 2024). College football data is available from 1869 onwards.
integer
Specific game ID filter. Can be combined with week/team/conference for targeted lookup. Does not satisfy the requirement for week/team/conference alone.
string
Conference abbreviation filter. Common values: ‘SEC’, ‘B1G’ (Big Ten), ‘Big 12’, ‘ACC’, ‘Pac-12’. Required unless week or team is provided.
string ("regular" | "postseason")
Season type filter. Use ‘regular’ for regular season games or ‘postseason’ for bowl games and playoffs. Defaults to all types if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Optional filter by team name. Use exact team name (e.g., ‘Alabama’, ‘Ohio State’). Returns rankings only for the specified team.
integer
Optional filter for recruiting class year (YYYY format). Returns rankings for the specified recruiting year.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Optional team filter (e.g., ‘Alabama’, ‘Ohio State’).
integer
required
Required year filter for which to retrieve ATS statistics.
string
Optional conference filter (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
required
Required game ID to retrieve win probability data for. Must be a valid game identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Filter by team or school name
integer
Filter by specific season year
integer
Filter by maximum season year (inclusive)
integer
Filter by minimum season year (inclusive)
string
Filter by coach’s last name
string
Filter by coach’s first name

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Season year to filter FBS teams (e.g., 2025)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Season year to filter FCS teams (e.g., 2025)
string
Conference to filter FCS teams (e.g., ‘SoCon’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Filter teams by season year (YYYY format). Returns teams that existed in the specified season. Without this filter, returns all teams including historical ones.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Season year in YYYY format to filter venues

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_NFL_DRAFT_PICKSList NFL Draft picks for a required draft year, with optional filters including round, pick, NFL team, college, conference, and position.

Input Parameters

integer
Pick number within the round
string
NFL team location name (e.g., ‘Carolina’, ‘New England’, ‘Houston’). Use COLLEGE_FOOTBALL_DATA_NFL_DRAFT_TEAMS to get valid team names.
integer
required
Draft year (e.g., 2025)
integer
Maximum number of results to return
integer
Draft round number (starting at 1)
integer
Number of results to skip for paging
string
College program name filter (e.g., ‘Alabama’, ‘Ohio State’)
integer
Overall pick number
string
Player position filter. Use COLLEGE_FOOTBALL_DATA_NFL_DRAFT_POSITIONS to get valid position values.
string
College conference name filter (e.g., ‘SEC’, ‘Big Ten’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_PLAY_BY_PLAY_DATAFetch play-by-play data for college football games. Requires a season and week, with optional filters including team or game.

Input Parameters

string
Team name filter (school name or abbreviation)
integer
required
Week number within the season
integer
required
4-digit season year filter
integer
Specific game ID filter
string
Defense team filter (school name or abbreviation)
string
Offense team filter (school name or abbreviation)
string
Play type filter (e.g., pass, run)
string
Conference abbreviation filter (e.g., SEC)
string ("regular" | "postseason")
Season phase filter; ‘regular’ or ‘postseason’
string
Defense conference abbreviation filter (e.g., ACC)
string
Offense conference abbreviation filter (e.g., SEC)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team name filter (school name, e.g., ‘Alabama’, ‘Ohio State’).
integer
Week number filter within the season (1-25).
integer
Season year filter (e.g., 2024). Recommended to always specify.
integer
Filter by specific CFBD game ID.
integer
Filter by specific CFBD athlete ID.
string ("regular" | "postseason" | "both")
Season type filter: ‘regular’, ‘postseason’, or ‘both’.
integer
Filter by specific stat type ID (see Play Stat Types endpoint for valid IDs).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team school name (e.g., ‘Alabama’, ‘Ohio State’). Required if ‘week’ is not specified. Case-sensitive.
integer
Week number to filter (1-15 regular season, higher for postseason). Required if ‘team’ is not specified.
integer
Season year to filter PPA stats (e.g., 2023). Highly recommended for efficient queries.
integer
Unique player ID to filter for a specific player. Still requires ‘week’ or ‘team’ to be set.
string
Position filter: QB (Quarterback), RB (Running Back), WR (Wide Receiver), TE (Tight End).
string
Minimum number of plays threshold. Only returns players with at least this many plays in the game.
boolean
If true, exclude garbage time plays (low-leverage plays in blowout games) from calculations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team name to filter by (e.g., ‘Alabama’, ‘Ohio State’).
integer
Season year to filter results (e.g., 2023).
integer
CFBD player ID to retrieve PPA data for a specific player across all seasons.
string
Position abbreviation to filter by (e.g., ‘QB’).
string
Minimum number of plays a player must have to be included in results.
string
Conference abbreviation to filter by (e.g., ‘SEC’).
boolean
If true, exclude garbage time plays from calculations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
required
The down number (1-4). Example: 1 for 1st down, 3 for 3rd down.
integer
required
Distance to go in yards (yards needed for a first down). Example: 10 for 1st and 10.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team filter by school name or abbreviation.
integer
Week number filter within the season.
integer
required
Season year to filter PPA by game.
string
Filter games on or before this date (YYYY-MM-DD).
string
Filter games on or after this date (YYYY-MM-DD).
string
Conference abbreviation filter.
string ("regular" | "postseason")
Season segment: ‘regular’ or ‘postseason’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_RANKINGS_POLLSRetrieve weekly college football poll rankings for a season, optionally filtered by season type and week. Results include team ranks, schools, conferences, first-place votes, and points; coverage varies by poll and season.

Input Parameters

integer
Optional week number of the season to retrieve rankings
integer
required
Season year in YYYY format to filter rankings
string ("regular" | "postseason" | "both" | "allstar" | "spring_regular" | "spring_postseason")
Optional season type filter. One of: ‘regular’, ‘postseason’, ‘both’, ‘allstar’, ‘spring_regular’, ‘spring_postseason’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team name to filter Elo ratings for a single team
integer
Season year for which to retrieve Elo ratings (YYYY)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
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.
integer
Season year for which to retrieve SP+ ratings (YYYY format, e.g. 2023). Required if team is not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Full team name (e.g., ‘Alabama’, ‘Ohio State’). Required if year is not specified. Returns historical ratings for the team.
integer
Season year (YYYY format). Required if team is not specified. Returns all team ratings for the given season.
string
Conference abbreviation to filter results (e.g., ‘SEC’, ‘Big Ten’, ‘ACC’, ‘Big 12’, ‘Pac-12’). Optional filter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Full team name to filter results (e.g., ‘Alabama’).
integer
Inclusive end year for recruiting data aggregation; must be >= startYear.
integer
Inclusive start year for recruiting data aggregation.
string
Conference abbreviation to filter results (e.g., ‘SEC’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
required
Season year for transfer portal data (e.g., 2024, 2025). Data available from 2021 onwards.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_RETURNING_PRODUCTION_TEAMFetch returning production metrics by team and season, including overall, passing, receiving, and rushing production and usage measures.

Input Parameters

string
Team name to filter results (e.g., ‘Alabama’, ‘Ohio State’). Required if year is not specified.
integer
Season year (YYYY) to query returning production data. Required if team is not specified.
string
Conference abbreviation to filter results (e.g., ‘SEC’, ‘Big Ten’). Only used alongside year or team.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Optional team name filter to narrow search to players from a specific team (e.g., ‘Alabama’, ‘Ohio State’).
integer
Optional year filter to narrow search to players active in a specific season.
string
Optional position abbreviation filter to narrow search to players at a specific position (e.g., ‘QB’, ‘RB’, ‘WR’, ‘LB’, ‘DB’).
string
required
Search term for matching player name (first name, last name, or full name). Returns top 100 results matching the search term.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Filter by team school name (e.g., ‘Alabama’, ‘Ohio State’, ‘Michigan’). Case-sensitive.
integer
required
Required. Season year for player stats (e.g., 2023, 2024).
integer
Filter stats up to this week number (inclusive). Use with startWeek to define a range.
string
Filter by stat category. Common values: ‘passing’, ‘rushing’, ‘receiving’, ‘defensive’, ‘interceptions’, ‘kicking’, ‘punting’, ‘kickReturns’, ‘puntReturns’.
integer
Filter stats from this week number onward (inclusive). Week 1 is the season start.
string
Filter by conference abbreviation (e.g., ‘SEC’, ‘Big Ten’, ‘Big 12’, ‘ACC’, ‘Pac-12’).
string ("regular" | "postseason" | "both")
Season phase filter. Options: ‘regular’ (default), ‘postseason’, or ‘both’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Filter by school/team name, e.g., ‘Alabama’
integer
required
Season year in YYYY format (e.g., 2023 for the 2023 college football season)
integer
Ending week number (must be >= startWeek)
integer
Starting week number (1-based)
string
Filter by conference abbreviation (e.g., ‘SEC’, ‘B1G’, ‘ACC’, ‘Big 12’, ‘Pac-12’)
string ("regular" | "postseason" | "both")
Season type to include: ‘regular’, ‘postseason’, or ‘both’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_SEASON_TYPES_DICTIONARYRetrieve the distinct season types found in calendar entries for a specified college football year. The tool fails if no season types are found.

Input Parameters

integer
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
First team name (FBS) to query head-to-head history.
string
required
Second team name (FBS) to query head-to-head history.
integer
Maximum season year (YYYY) to include in results.
integer
Minimum season year (YYYY) to include in results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Team/school name filter (e.g., ‘Alabama’, ‘Ohio State’, ‘Michigan’).
integer
required
Season year for which to retrieve team records (must be >= 1869).
integer
Limit the number of results returned (for pagination).
integer
Number of records to skip for pagination.
string ("fbs" | "fcs" | "d1" | "d2" | "d3")
NCAA division filter: ‘fbs’ (Division I FBS), ‘fcs’ (Division I FCS), ‘d1’, ‘d2’, or ‘d3’.
string
Conference abbreviation filter (e.g., ‘SEC’, ‘ACC’, ‘Big Ten’, ‘Big 12’, ‘Pac-12’).
string ("regular" | "postseason" | "all")
Type of season to include: ‘regular’, ‘postseason’, or ‘all’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COLLEGE_FOOTBALL_DATA_TEAM_ROSTERFetch a college football team’s roster for a specified season from 2009 onward. Player details can include position, height, weight, jersey number, academic year, and hometown; coverage and field completeness vary by team and season.

Input Parameters

string
required
Team name (e.g., ‘Alabama’, ‘Ohio State’, ‘Michigan’). Must be exact team name.
integer
required
Season year for the roster (2009-present).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not