College Football Data

college_football_data

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

Analytics Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (41)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Advanced Box ScoreCOLLEGE_FOOTBALL_DATA_ADVANCED_BOX_SCOREAcción

Tool to retrieve advanced box score metrics for a single college football game. Use after selecting a specific game to access team- and player-level advanced analytics.

Parámetros de entrada

gameIdintegerObligatorio
Game ID filter for the single game to return

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Advanced Game StatsCOLLEGE_FOOTBALL_DATA_ADVANCED_GAME_STATSAcción

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

Parámetros de entrada

teamstring
Team filter by school name or abbreviation.
weekinteger
Week number to filter games (e.g., 1–18).
yearinteger
Season year to filter games (e.g., 2025).
opponentstring
Opponent filter by school name or abbreviation.
seasonTypestringenum
Season type filter: 'regular', 'postseason', or 'both'.
regularpostseasonboth
excludeGarbageTimeboolean
Exclude garbage time from calculations.

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Advanced Season Stats by TeamCOLLEGE_FOOTBALL_DATA_ADVANCED_SEASON_STATS_TEAMAcción

Tool to retrieve advanced season metrics aggregated by team and season. Use after selecting season and team filters.

Parámetros de entrada

teamstring
Team filter by school name.
yearinteger
Year filter for the season.
endWeekinteger
Ending week filter.
startWeekinteger
Starting week filter.
excludeGarbageTimeboolean
Exclude garbage time from calculations.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Betting LinesCOLLEGE_FOOTBALL_DATA_BETTING_LINESAcción

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

Parámetros de entrada

awaystring
Filter by away team name (full name or abbreviation).
homestring
Filter by home team name (full name or abbreviation).
teamstring
Filter by team name (full name or abbreviation).
weekinteger
Week number within the season.
yearinteger
Season year filter (e.g., 2025).
gameIdinteger
Filter by specific game ID.
conferencestring
Filter by conference abbreviation (e.g., SEC).
seasonTypestringenum
Season type filter (regular or postseason).
regularpostseason

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Composite Team TalentCOLLEGE_FOOTBALL_DATA_COMPOSITE_TEAM_TALENTAcción

Tool to fetch composite team talent rankings by season. Use when you need 247Sports team talent composites for specified seasons.

Parámetros de entrada

yearinteger
Season year to filter data (e.g., 2025). If omitted, returns all available seasons (since 2015).

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Conference Memberships HistoryCOLLEGE_FOOTBALL_DATA_CONFERENCE_MEMBERSHIPS_HISTORYAcción

Tool to retrieve historical conference memberships for teams, including years active and division. Use when you need to trace a team's conference history over time.

Parámetros de entrada

teamstring
Filter by school/team name, e.g., 'Alabama'
endYearinteger
Filter memberships up to this year (>=startYear)
startYearinteger
Filter memberships starting from this year (>=1869)
conferencestring
Filter by conference abbreviation, e.g., 'SEC'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Divisions by ConferenceCOLLEGE_FOOTBALL_DATA_DIVISIONS_BY_CONFERENCEAcción

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

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Drive DataCOLLEGE_FOOTBALL_DATA_GET_DRIVE_DATAAcción

Tool to retrieve drive-level data and results. Use when analyzing detailed drives for specified games after filtering by season, team, or week.

Parámetros de entrada

teamstring
Team filter by school name or abbreviation
weekinteger
Week number filter within the season
yearintegerObligatorio
Season year to filter drives (e.g., 2025)
defensestring
Defensive team filter by school name or abbreviation
offensestring
Offensive team filter by school name or abbreviation
conferencestring
Conference filter by conference abbreviation
seasonTypestringenum
Season type filter: 'regular' or 'postseason'
regularpostseason
defenseConferencestring
Defensive conference filter by conference abbreviation
offenseConferencestring
Offensive conference filter by conference abbreviation

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Game MediaCOLLEGE_FOOTBALL_DATA_GET_GAME_MEDIAAcción

Tool to retrieve game media information and broadcast schedules (TV, radio, web, etc.). Use after selecting season year and optional filters (week, team, conference). Example: "Get week 3 TV and radio outlets for 2025 SEC games."

Parámetros de entrada

teamstring
Team name or abbreviation
weekinteger
Week number of the season
yearintegerObligatorio
Season year to filter on
mediaTypestringenum
Media outlet type to filter on (tv, radio, web, ppv, or mobile)
tvradiowebppvmobile
conferencestring
Conference abbreviation
seasonTypestringenum
Season type to filter on (regular, postseason, or both)
regularpostseasonboth

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Games and ResultsCOLLEGE_FOOTBALL_DATA_GET_GAMES_AND_RESULTSAcción

Tool to retrieve games and results for a given season/week/team. Use when you need game schedules or outcomes filtered by specific criteria.

Parámetros de entrada

idinteger
Single game filter by unique game ID.
awaystring
Away team filter by school name.
homestring
Home team filter by school name.
teamstring
Team filter by school name.
weekinteger
Week filter within the season.
yearintegerObligatorio
Year/season filter for games.
conferencestring
Conference abbreviation filter.
seasonTypestringenum
Season segment; e.g., regular or postseason.
regularpostseason

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Player Game StatsCOLLEGE_FOOTBALL_DATA_GET_PLAYER_GAME_STATSAcción

Tool to fetch player statistics at the game level. Use when you need detailed stats for players in games after filtering parameters.

Parámetros de entrada

teamstring
Team name filter (full name or abbreviation).
weekinteger
Week number within the season (1–99).
yearintegerObligatorio
Season year to filter games (e.g., 2025).
gameIdinteger
Specific game ID filter.
categorystringenum
Stat category filter (e.g., 'passing', 'rushing', 'receiving', etc.).
passingrushingreceivingdefensivefumblesinterceptionspuntingpuntReturnskickingkickReturns
conferencestring
Conference abbreviation filter (e.g., 'SEC').
seasonTypestringenum
Season phase: 'regular' or 'postseason'.
regularpostseason

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Team Game StatsCOLLEGE_FOOTBALL_DATA_GET_TEAM_GAME_STATSAcción

Tool to fetch team statistics at the game level. Use when you need detailed box score stats for games after filtering parameters.

Parámetros de entrada

teamstring
Team filter by school name or abbreviation.
weekinteger
Week number filter (1–99).
yearintegerObligatorio
Season year to filter games (e.g., 2025).
gameIdinteger
Specific game ID filter.
conferencestring
Conference abbreviation filter (e.g., 'SEC').
seasonTypestringenum
Season type filter: 'regular' or 'postseason'.
regularpostseason

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Coaches and HistoryCOLLEGE_FOOTBALL_DATA_LIST_COACHES_AND_HISTORYAcción

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

Parámetros de entrada

teamstring
Filter by team or school name
yearinteger
Filter by specific season year
maxYearinteger
Filter by maximum season year (inclusive)
minYearinteger
Filter by minimum season year (inclusive)
lastNamestring
Filter by coach's last name
firstNamestring
Filter by coach's first name

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List ConferencesCOLLEGE_FOOTBALL_DATA_LIST_CONFERENCESAcción

Tool to list all college football conferences. Use after authenticating to retrieve the up-to-date list of conferences.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List FBS TeamsCOLLEGE_FOOTBALL_DATA_LIST_FBS_TEAMSAcción

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

Parámetros de entrada

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

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List FCS TeamsCOLLEGE_FOOTBALL_DATA_LIST_FCS_TEAMSAcción

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

Parámetros de entrada

yearinteger
Season year to filter FCS teams (e.g., 2025)
conferencestring
Conference to filter FCS teams (e.g., 'SoCon')

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List TeamsCOLLEGE_FOOTBALL_DATA_LIST_TEAMSAcción

Tool to list college football teams. Use when you need a list of teams filtered by season year and/or conference.

Parámetros de entrada

yearinteger
Season year in YYYY format to filter teams
conferencestring
Conference abbreviation filter (e.g., SEC, B1G, ACC)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Venues and StadiumsCOLLEGE_FOOTBALL_DATA_LIST_VENUES_STADIUMSAcción

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

Parámetros de entrada

yearinteger
Season year in YYYY format to filter venues

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

NFL Draft PicksCOLLEGE_FOOTBALL_DATA_NFL_DRAFT_PICKSAcción

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

Parámetros de entrada

pickinteger
Pick number within the round
teamstring
NFL team abbreviation (e.g., 'NE')
yearintegerObligatorio
Draft year (e.g., 2025)
limitinteger
Maximum number of results to return
roundinteger
Draft round number (starting at 1)
offsetinteger
Number of results to skip for paging
schoolstring
College program name filter
overallinteger
Overall pick number
positionstring
Player position filter
conferencestring
College conference abbreviation filter

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

NFL Draft PositionsCOLLEGE_FOOTBALL_DATA_NFL_DRAFT_POSITIONSAcción

Tool to list NFL draft positions. Use when you need a standardized set of NFL positions for draft analysis.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

NFL Draft TeamsCOLLEGE_FOOTBALL_DATA_NFL_DRAFT_TEAMSAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Play-by-Play DataCOLLEGE_FOOTBALL_DATA_PLAY_BY_PLAY_DATAAcción

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

Parámetros de entrada

teamstring
Team name filter (school name or abbreviation)
weekintegerObligatorio
Week number within the season
yearintegerObligatorio
4-digit season year filter
gameIdinteger
Specific game ID filter
defensestring
Defense team filter (school name or abbreviation)
offensestring
Offense team filter (school name or abbreviation)
playTypestring
Play type filter (e.g., pass, run)
conferencestring
Conference abbreviation filter (e.g., SEC)
seasonTypestringenum
Season phase filter; 'regular' or 'postseason'
regularpostseason
defenseConferencestring
Defense conference abbreviation filter (e.g., ACC)
offenseConferencestring
Offense conference abbreviation filter (e.g., SEC)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Play Stats PlayerCOLLEGE_FOOTBALL_DATA_PLAY_STATS_PLAYERAcción

Tool to fetch player-level stats tied to individual plays. Use when you need detailed play-by-play player statistics filtered by season, week, game, or athlete.

Parámetros de entrada

teamstring
Team filter by school name or abbreviation.
weekinteger
Week number filter (1–99).
yearinteger
Season year to filter plays (e.g., 2025).
gameIdinteger
Specific game ID filter.
athleteIdinteger
Specific athlete ID filter.
seasonTypestringenum
Season type filter: 'regular', 'postseason', or 'both'.
regularpostseasonboth
statTypeIdinteger
Specific stat type ID filter.

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Play Stat TypesCOLLEGE_FOOTBALL_DATA_PLAY_STAT_TYPESAcción

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

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Player PPA by GameCOLLEGE_FOOTBALL_DATA_PPA_PLAYER_BY_GAME_ACTIONAcción

Tool to retrieve player-level PPA/EPA broken down by game. Use when you need per-game PPA/EPA metrics for players filtered by season, week, or team.

Parámetros de entrada

teamstring
Team filter by school name or abbreviation
weekinteger
Week number to filter PPA by game
yearinteger
Season year to filter PPA by game (e.g., 2025)
playerIdinteger
Player ID filter
positionstring
Position abbreviation filter (e.g., QB, RB, WR, TE)
thresholdstring
Minimum play threshold filter
excludeGarbageTimeboolean
Exclude garbage time plays from PPA calculations

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

PPA Player By SeasonCOLLEGE_FOOTBALL_DATA_PPA_PLAYER_BY_SEASONAcción

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

Parámetros de entrada

teamstring
Team abbreviation to filter by (e.g., 'LSU').
yearinteger
Season year to filter results (e.g., 2023).
playerIdinteger
Unique player ID to filter results.
positionstring
Position abbreviation to filter by (e.g., 'QB').
thresholdstring
Minimum play threshold to include in results (e.g., '25').
conferencestring
Conference abbreviation to filter by (e.g., 'SEC').
excludeGarbageTimeboolean
If true, exclude garbage time plays from calculations.

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Predict Expected Points (EP)COLLEGE_FOOTBALL_DATA_PPA_PREDICTED_POINTS_EPAcción

Tool to get expected points by down, distance, and field position. Use after selecting down (1–4) and distance to explore expected outcomes across the field.

Parámetros de entrada

downintegerObligatorio
Down filter (1-4)
distanceintegerObligatorio
Distance-to-go filter in yards

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

PPA Team By GameCOLLEGE_FOOTBALL_DATA_PPA_TEAM_BY_GAMEAcción

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

Parámetros de entrada

teamstring
Team filter by school name or abbreviation.
weekinteger
Week number filter within the season.
yearintegerObligatorio
Season year to filter PPA by game.
endDatestring
Filter games on or before this date (YYYY-MM-DD).
startDatestring
Filter games on or after this date (YYYY-MM-DD).
conferencestring
Conference abbreviation filter.
seasonTypestringenum
Season segment: 'regular' or 'postseason'.
regularpostseason

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Rankings PollsCOLLEGE_FOOTBALL_DATA_RANKINGS_POLLSAcción

Tool to retrieve weekly human/computer poll rankings. Use after specifying season year and optional week.

Parámetros de entrada

weekinteger
Optional week number of the season to retrieve rankings
yearintegerObligatorio
Season year in YYYY format to filter rankings
season_typestringenum
Optional season type filter. One of: 'regular', 'postseason', 'both', 'allstar', 'spring_regular', 'spring_postseason'
regularpostseasonbothallstarspring_regularspring_postseason

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Elo RatingsCOLLEGE_FOOTBALL_DATA_RATINGS_ELOAcción

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

Parámetros de entrada

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

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

SP+ RatingsCOLLEGE_FOOTBALL_DATA_RATINGS_SP_PLUSAcción

Tool to retrieve SP+ team ratings. Use when you need historical SP+ ratings for a specific season after confirming the season year.

Parámetros de entrada

teamstring
Team name to filter SP+ ratings when 'year' is not provided
yearinteger
Season year for which to retrieve SP+ ratings (YYYY)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

SRS RatingsCOLLEGE_FOOTBALL_DATA_RATINGS_SRSAcción

Tool to retrieve Simple Rating System (SRS) team ratings. Use when you need historical SRS values for a season, optionally filtering by team or conference.

Parámetros de entrada

teamstring
Full FBS team name to filter results
yearinteger
Season year for which to retrieve SRS ratings (YYYY)
conferencestring
Conference abbreviation to filter results

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Recruiting Group DictionaryCOLLEGE_FOOTBALL_DATA_RECRUITING_GROUP_DICTIONARYAcción

Tool to list recruiting position group aggregations. Use when you need aggregated team recruiting ratings by position group (e.g., QB, RB, WR).

Parámetros de entrada

teamstring
Full team name to filter results (e.g., 'Alabama').
endYearinteger
Inclusive end year for recruiting data aggregation; must be >= startYear.
startYearinteger
Inclusive start year for recruiting data aggregation.
conferencestring
Conference abbreviation to filter results (e.g., 'SEC').

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Recruiting Transfer PortalCOLLEGE_FOOTBALL_DATA_RECRUITING_TRANSFER_PORTALAcción

Tool to retrieve transfer portal entries for a given season. Use when you need details of players entering the transfer portal, including from/to teams, position, and recruiting ratings.

Parámetros de entrada

yearintegerObligatorio
Season year of the transfer portal dataset (YYYY)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Returning Production by TeamCOLLEGE_FOOTBALL_DATA_RETURNING_PRODUCTION_TEAMAcción

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

Parámetros de entrada

teamstring
Optional team name or abbreviation to filter results.
yearinteger
Optional season year (YYYY) to query returning production data.
conferencestring
Optional conference name to filter results.

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Season Stats PlayerCOLLEGE_FOOTBALL_DATA_SEASON_STATS_PLAYERAcción

Tool to fetch basic season stats aggregated by player and season. Use when you need overall player performance summaries for a given season.

Parámetros de entrada

teamstring
Team name filter (school name or abbreviation).
yearinteger
Season year to filter stats (e.g., 2025).
endWeekinteger
Week number to end filtering at (1-99).
categorystring
Stat category filter (e.g., 'passing', 'rushing', etc.).
startWeekinteger
Week number to start filtering from (1-99).
conferencestring
Conference abbreviation filter (e.g., 'SEC').
seasonTypestringenum
Season phase: 'regular', 'postseason', or 'both'.
regularpostseasonboth

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Season Team StatsCOLLEGE_FOOTBALL_DATA_SEASON_STATS_TEAMAcción

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

Parámetros de entrada

teamstring
Filter by school/team name, e.g., 'Alabama'
yearintegerObligatorio
Season year in YYYY format
endWeekinteger
Ending week number (must be >= startWeek)
startWeekinteger
Starting week number (1-based)
conferencestring
Filter by conference abbreviation, e.g., 'SEC'
seasonTypestringenum
Season type to include: 'regular', 'postseason', or 'both'
regularpostseasonboth

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Season Types DictionaryCOLLEGE_FOOTBALL_DATA_SEASON_TYPES_DICTIONARYAcción

Tool to list season types. Uses the season calendar endpoint to extract valid seasonType values.

Parámetros de entrada

yearinteger
Season year to query calendar for extracting season types.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Team Matchup HistoryCOLLEGE_FOOTBALL_DATA_TEAM_MATCHUP_HISTORYAcción

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

Parámetros de entrada

team1stringObligatorio
First team name (FBS) to query head-to-head history.
team2stringObligatorio
Second team name (FBS) to query head-to-head history.
maxYearinteger
Maximum season year (YYYY) to include in results.
minYearinteger
Minimum season year (YYYY) to include in results.

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Team season recordsCOLLEGE_FOOTBALL_DATA_TEAM_RECORDSAcción

Tool to fetch team season records by year with optional filters. Use after specifying the year and any optional filters (conference, team, division, seasonType, limit, offset) to retrieve records.

Parámetros de entrada

teamstring
Optional school/team name filter, e.g., 'Alabama'.
yearintegerObligatorio
Season year for which to retrieve team records (must be >= 1869).
limitinteger
Limit the number of results returned.
offsetinteger
Number of records to skip (offset) for pagination.
divisionstringenum
Optional NCAA division filter, e.g., 'fbs', 'fcs'.
fbsfcsd1d2d3
conferencestring
Optional conference abbreviation filter, e.g., 'SEC', 'ACC'.
seasonTypestringenum
Type of season to include: 'regular', 'postseason', or 'all'.
regularpostseasonall

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Team RosterCOLLEGE_FOOTBALL_DATA_TEAM_ROSTERAcción

Tool to fetch roster for a given team and season. Use when you need a team's roster for a specific year.

Parámetros de entrada

teamstringObligatorio
Team name or abbreviation (e.g., 'Alabama')
yearintegerObligatorio
Season year for the roster; must be 2009 or later

Parámetros de salida

dataobject[]Obligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not