The College Football Data connector lets your AI agent act in each user's College Football Data account. Each user connects their own College Football Data access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 60 · 0 · 060 read0 write0 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the College Football Data connection
In AgentKit > Connections, create a College Football Data connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'collegefootballdata'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize College Football Data:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'collegefootballdata_user_info_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "collegefootballdata"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize College Football Data:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="collegefootballdata_user_info_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their College Football Data credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcollegefootballdata_adjusted_team_stats_listGet opponent-adjusted team statistics by season (WEPA): EPA per play, success rate and rushing and passing splits adjusted for schedule.Read-onlyList Opponent-Adjusted Team Stats
Get opponent-adjusted team statistics by season (WEPA): EPA per play, success rate and rushing and passing splits adjusted for schedule. Returns a list of records with year, teamId, team, conference, epa, epaAllowed, successRate, successRateAllowed, rushing, rushingAllowed. Use this to compare teams after accounting for opponent strength. Use collegefootballdata_team_advanced_stats_list for unadjusted metrics.
Inputs
conferencestring- Conference name or abbreviation. Example: B1G
teamstring- Team name. Example: Michigan
yearinteger- Season year. Example: 2024
collegefootballdata_betting_lines_listGet betting lines (spread, over/under, moneyline) from sportsbooks for games, with results.Read-onlyList Betting Lines
Get betting lines (spread, over/under, moneyline) from sportsbooks for games, with results. Returns a list of records with id, season, seasonType, week, startDate, homeTeamId, homeTeam, homeConference, homeClassification, homeScore. Use this for game odds. Pass gameId, or year with week, team or conference. Use collegefootballdata_team_ats_records_list for ATS records.
Inputs
awaystring- Away team name. Example: Ohio State
conferencestring- Conference of either team. Example: B1G
game_idinteger- Game ID. Example: 401520281
homestring- Home team name. Example: Michigan
providerstring- Betting line provider. Example: ESPN Bet
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name on either side of the game. Example: Michigan
weekinteger- Week number. Example: 5
yearinteger- Season year. Required unless gameId is specified. Example: 2024
collegefootballdata_calendar_getGet the week-by-week calendar for a season, with each week's start and end dates.Read-onlyGet Season Calendar
Get the week-by-week calendar for a season, with each week's start and end dates. Returns a list of records with season, week, seasonType, startDate, endDate, firstGameStart, lastGameStart. Use this to map dates to week numbers before calling week-filtered tools.
Inputs
yearintegerrequired- Season year. Example: 2024
collegefootballdata_cfp_bracket_getGet the complete College Football Playoff bracket for a season, with seeds, matchups and results.Read-onlyGet CFP Bracket
Get the complete College Football Playoff bracket for a season, with seeds, matchups and results. Returns season, competition, format, teamCount, status, participants, rounds, champion. Use this for the playoff bracket. Use collegefootballdata_poll_rankings_list with poll=cfp for CFP rankings.
Inputs
yearintegerrequired- Season year. Example: 2024
collegefootballdata_coach_profile_getGet one coach's profile with canonical identity and career totals.Read-onlyGet Coach Profile
Get one coach's profile with canonical identity and career totals. Returns id, firstName, lastName, displayName, currentTeam, career, birthDate, almaMater, graduationYear, wikidataId. Use this when you have a coach ID. Use collegefootballdata_coaches_list to find coaches by name.
Inputs
coach_idintegerrequired- Coach ID. Example: 1234
collegefootballdata_coaches_listList head coaches with their season-by-season records, filtered by name, team or year range.Read-onlyList Coaches
List head coaches with their season-by-season records, filtered by name, team or year range. Returns a list of records with id, firstName, lastName, hireDate, seasons. Use this to find coaches and their records. Use collegefootballdata_coach_profile_get for one coach's career totals.
Inputs
first_namestring- Coach first name. Example: Kirby
last_namestring- Coach last name. Example: Smart
max_yearinteger- Latest season year to include. Example: 2024
min_yearinteger- Earliest season year to include. Example: 2010
teamstring- Team name. Example: Michigan
yearinteger- Season year. Example: 2024
collegefootballdata_conferences_listList conferences with name, abbreviation, classification and member counts.Read-onlyList Conferences
List conferences with name, abbreviation, classification and member counts. Returns a list of records with id, name, shortName, abbreviation, classification, memberCount. Use this to get the conference abbreviations other tools filter on.
Inputs
classificationstring- Conference classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii yearinteger- Season year used to calculate membership. Example: 2024
collegefootballdata_draft_picks_listList NFL Draft picks with round, pick, NFL team, college team, position and grades.Read-onlyList NFL Draft Picks
List NFL Draft picks with round, pick, NFL team, college team, position and grades. Returns a list of records with collegeAthleteId, nflAthleteId, collegeId, collegeTeam, collegeConference, nflTeamId, nflTeam, year, overall, round. Use this to see which college players were drafted.
Inputs
conferencestring- College conference name or abbreviation. Example: B1G
positionstring- Position category. Example: QB
schoolstring- College team name. Example: Michigan
teamstring- NFL team name. Example: Michigan
yearinteger- Draft year. Example: 2024
collegefootballdata_drives_listList drives for a season, with start and end field position, plays, yards, time and result.Read-onlyList Drives
List drives for a season, with start and end field position, plays, yards, time and result. Returns a list of records with offense, offenseConference, defense, defenseConference, gameId, id, driveNumber, scoring, startPeriod, startYardline. Use this for drive-level analysis. Use collegefootballdata_plays_list for individual plays.
Inputs
yearintegerrequired- Season year. Example: 2024
classificationstring- Division classification of either team. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference of either team. Example: B1G
defensestring- Defensive team name. Example: Ohio State
defense_conferencestring- Defensive team conference. Example: example
offensestring- Offensive team name. Example: Michigan
offense_conferencestring- Offensive team conference. Example: example
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name on either side of the drive. Example: Michigan
weekinteger- Week number. Example: 5
collegefootballdata_elo_ratings_listGet Elo team ratings by season, optionally as of a given week.Read-onlyList Elo Ratings
Get Elo team ratings by season, optionally as of a given week. Returns a list of records with year, team, conference, elo. Use this for Elo ratings. Use collegefootballdata_sp_ratings_list for SP+.
Inputs
conferencestring- Conference name or abbreviation. Example: B1G
preseasonboolean- Return initial ratings from each team's opening regular-season game. Missing opening ratings are omitted. Cannot be combined with week; seasonType must be regular or both when specified. Defaults to false. Example: false
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Example: Michigan
weekinteger- Week number. Defaults to the latest available week in the season. Example: 5
yearinteger- Season year. Example: 2024
collegefootballdata_fbs_teams_listList Football Bowl Subdivision (FBS) teams for a season.Read-onlyList FBS Teams
List Football Bowl Subdivision (FBS) teams for a season. Returns a list of records with id, school, mascot, abbreviation, alternateNames, conference, division, classification, color, alternateColor. Use this when you only need FBS teams. Use collegefootballdata_teams_list for all divisions.
Inputs
yearinteger- Season year. Example: 2024
collegefootballdata_fpi_ratings_listGet ESPN Football Power Index (FPI) team ratings by season, with efficiency and resume rankings.Read-onlyList FPI Ratings
Get ESPN Football Power Index (FPI) team ratings by season, with efficiency and resume rankings. Returns a list of records with year, team, conference, fpi, resumeRanks, efficiencies. Use this for FPI. Use collegefootballdata_sp_ratings_list for SP+.
Inputs
conferencestring- Conference name or abbreviation. Example: B1G
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_game_advanced_box_score_getGet the advanced box score for one game, with efficiency, explosiveness, havoc, field position and player usage.Read-onlyGet Advanced Box Score
Get the advanced box score for one game, with efficiency, explosiveness, havoc, field position and player usage. Returns gameInfo, teams, players. Use this for deep analysis of one game. Returns 404 for games without play-by-play data. Get the game ID from collegefootballdata_games_list.
Inputs
idintegerrequired- Game ID. Example: 401520281
collegefootballdata_game_advanced_stats_listGet advanced team statistics by game: success rate, explosiveness, PPA and line metrics, for offense and defense.Read-onlyList Game Advanced Stats
Get advanced team statistics by game: success rate, explosiveness, PPA and line metrics, for offense and defense. Returns a list of records with gameId, season, seasonType, week, team, opponent, offense, defense. Use this for game-level efficiency. Use collegefootballdata_team_advanced_stats_list for season aggregates.
Inputs
exclude_garbage_timeboolean- Excludes garbage-time plays when true. Defaults to false. Example: true
opponentstring- Opponent team name. Example: Ohio State
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Required unless year is specified. Example: Michigan
weeknumber- Week number. Example: 5
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_game_havoc_stats_listGet team havoc rates by game: tackles for loss, passes defended and forced fumbles as a share of plays.Read-onlyList Game Havoc Stats
Get team havoc rates by game: tackles for loss, passes defended and forced fumbles as a share of plays. Returns a list of records with gameId, season, seasonType, week, team, conference, opponent, opponentConference, offense, defense. Use this to measure defensive disruption per game.
Inputs
opponentstring- Opponent team name. Example: Ohio State
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Required unless year is specified. Example: Michigan
weeknumber- Week number. Example: 5
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_game_media_listList TV, radio and streaming broadcast information for games in a season.Read-onlyList Game Media
List TV, radio and streaming broadcast information for games in a season. Returns a list of records with id, season, week, seasonType, startTime, isStartTimeTBD, homeTeam, homeConference, awayTeam, awayConference. Use this to find where a game is broadcast. Use collegefootballdata_games_list for scores.
Inputs
yearintegerrequired- Season year. Example: 2024
classificationstring- Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. Example: B1G
media_typestring- Media type. One of: tv, radio, web, ppv, mobile. Example: tvone of
tvradiowebppvmobile season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Example: Michigan
weekinteger- Week number. Example: 5
collegefootballdata_game_player_stats_listGet player box score statistics for games in a week, for a team, or for one game.Read-onlyList Game Player Stats
Get player box score statistics for games in a week, for a team, or for one game. Returns a list of records with id, teams. Use this for per-player box scores. Pass id, or year with week, team or conference. Use collegefootballdata_player_season_stats_list for season totals.
Inputs
categorystring- Player statistical category. Example: passing
classificationstring- Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. One of week, team, or conference is required when filtering by year. Example: B1G
idinteger- Game ID. When specified, returns statistics for that game. Example: 401520281
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. One of week, team, or conference is required when filtering by year. Example: Michigan
weekinteger- Week number. One of week, team, or conference is required when filtering by year. Example: 5
yearinteger- Season year. Required unless id is specified. Example: 2024
collegefootballdata_game_ppa_listGet team Predicted Points Added (PPA) per play by game, for offense and defense.Read-onlyList Game PPA
Get team Predicted Points Added (PPA) per play by game, for offense and defense. Returns a list of records with gameId, season, week, seasonType, team, conference, opponent, offense, defense. Use this for game-level team PPA. Use collegefootballdata_team_ppa_list for season aggregates.
Inputs
yearintegerrequired- Season year. Example: 2024
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference abbreviation. Example: B1G
exclude_garbage_timeboolean- Excludes garbage-time plays when true. Example: true
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Example: Michigan
weekinteger- Week number. Example: 5
collegefootballdata_game_preview_getGet the pregame comparison for one game: team metrics side by side and the key players.Read-onlyGet Game Preview
Get the pregame comparison for one game: team metrics side by side and the key players. Returns assembledAt, game, availability, reason, analysis. Use this before a game to compare the two teams. Get the game ID from collegefootballdata_schedule_get or collegefootballdata_games_list.
Inputs
game_idintegerrequired- Game ID. Example: 401520281
collegefootballdata_game_team_stats_listGet team box score statistics for games in a week, for a team, or for one game.Read-onlyList Game Team Stats
Get team box score statistics for games in a week, for a team, or for one game. Returns a list of records with id, teams. Use this for team box scores. Pass id, or year with week, team or conference. Use collegefootballdata_game_player_stats_list for player box scores.
Inputs
classificationstring- Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. One of week, team, or conference is required when filtering by year. Example: B1G
idinteger- Game ID. When specified, returns statistics for that game. Example: 401520281
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. One of week, team, or conference is required when filtering by year. Example: Michigan
weekinteger- Week number. One of week, team, or conference is required when filtering by year. Example: 5
yearinteger- Season year. Required unless id is specified. Example: 2024
collegefootballdata_games_listList college football games for a season, week, team or conference, or get one game by ID.Read-onlyList Games
List college football games for a season, week, team or conference, or get one game by ID. Returns a list of records with id, season, week, seasonType, startDate, startTimeTBD, completed, neutralSite, conferenceGame, attendance. Use this to find game IDs and final scores. Use collegefootballdata_game_team_stats_list or collegefootballdata_game_player_stats_list for box scores. Pass year unless you pass id.
Inputs
awaystring- Away team name. Example: Ohio State
classificationstring- Division classification. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii competitionstring- Playoff competition. One of: cfp. Example: cfpone of
cfp conferencestring- Conference of either team. Example: B1G
homestring- Home team name. Example: Michigan
idinteger- Game ID. When specified, returns data for that game. Example: 401520281
roundstring- Playoff round. Requires competition. One of: first_round, quarterfinal, semifinal, championship. Example: first_roundone of
first_roundquarterfinalsemifinalchampionship season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name on either side of the game. Example: Michigan
weekinteger- Week number. Example: 5
yearinteger- Season year. Required unless id is specified. Example: 2024
collegefootballdata_play_stat_types_listList the play statistic types (for example Completion, Rush, Sack) with their IDs.Read-onlyList Play Stat Types
List the play statistic types (for example Completion, Rush, Sack) with their IDs. Returns a list of records with id, name. Use this to get statTypeId values for collegefootballdata_play_stats_list.
Inputs
This tool takes no inputs.
collegefootballdata_play_stats_listList player-to-play statistic associations, such as who made a tackle or reception, limited to 2,000 records.Read-onlyList Play Stats
List player-to-play statistic associations, such as who made a tackle or reception, limited to 2,000 records. Returns a list of records with gameId, season, week, team, conference, opponent, teamScore, opponentScore, driveId, playId. Use this to attribute plays to players. Narrow by gameId, team or athleteId. Use collegefootballdata_play_stat_types_list for stat type IDs.
Inputs
athlete_idinteger- Athlete ID. Example: 4432577
conferencestring- Conference name or abbreviation. Example: B1G
game_idinteger- Game ID. Example: 401520281
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason stat_type_idinteger- Play stat type ID. Example: 1
teamstring- Team name. Example: Michigan
weekinteger- Week number. Example: 5
yearinteger- Season year. Example: 2024
collegefootballdata_play_types_listList every play type with its ID, text and abbreviation.Read-onlyList Play Types
List every play type with its ID, text and abbreviation. Returns a list of records with id, text, abbreviation. Use this to get the playType ID for collegefootballdata_plays_list.
Inputs
This tool takes no inputs.
collegefootballdata_player_game_ppa_listGet player Predicted Points Added (PPA) by game.Read-onlyList Player Game PPA
Get player Predicted Points Added (PPA) by game. Returns a list of records with season, week, seasonType, id, name, position, team, opponent, averagePPA. Use this for one player's game-by-game value. Use collegefootballdata_player_season_ppa_list for season totals.
Inputs
yearintegerrequired- Season year. Example: 2024
exclude_garbage_timeboolean- Excludes garbage-time plays when true. Example: true
player_idstring- Player ID. Example: 4432577
positionstring- Player position abbreviation. Example: QB
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Required unless week is specified. Example: Michigan
thresholdnumber- Minimum number of plays. Example: 0
weekinteger- Week number. Required unless team is specified. Example: 5
collegefootballdata_player_passing_season_listGet player passing statistics by season, including completion percentage over expected (CPOE).Read-onlyList Player Passing by Season
Get player passing statistics by season, including completion percentage over expected (CPOE). Returns a list of records with attempts, completions, incompletions, interceptions, completionRate, airYardsAttemptsAvailable, totalAirYards, averageDepthOfTarget, totalYardsAttemptsAvailable, totalYards. Use this to compare quarterbacks. Use collegefootballdata_player_rushing_season_list for rushing.
Inputs
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. Example: B1G
passer_idstring- Passer athlete ID. Required unless year is specified. Example: 4432577
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Example: Michigan
yearinteger- Season year. Required unless passerId is specified. Example: 2024
collegefootballdata_player_rushing_season_listGet player rushing statistics by season, with direction and attribution metrics.Read-onlyList Player Rushing by Season
Get player rushing statistics by season, with direction and attribution metrics. Returns a list of records with attempts, rushingYardsAvailable, totalRushingYards, yardsPerCarry, individualAttempts, unattributedAttempts, sacks, kneels, teamRushes, multiCarrierAttempts. Use this to compare rushers. Use collegefootballdata_player_passing_season_list for passing.
Inputs
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. Example: B1G
rusher_idstring- Rusher athlete ID. Required unless year is specified. Example: 4432577
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Example: Michigan
yearinteger- Season year. Required unless rusherId is specified. Example: 2024
collegefootballdata_player_season_overview_getGet one player's season overview, combining box score stats, usage and predicted points added.Read-onlyGet Player Season Overview
Get one player's season overview, combining box score stats, usage and predicted points added. Returns season, id, name, position, team, conference, games, boxScoreStats, usage, ppa. Use this for a full summary of one player. Get the player ID from collegefootballdata_players_search.
Inputs
player_idintegerrequired- Player ID. Example: 4432577
yearintegerrequired- Season year. Example: 2024
collegefootballdata_player_season_ppa_listGet player Predicted Points Added (PPA) aggregated by season.Read-onlyList Player Season PPA
Get player Predicted Points Added (PPA) aggregated by season. Returns a list of records with season, id, name, position, team, conference, averagePPA, totalPPA. Use this to rank players by value over a season. Use collegefootballdata_player_game_ppa_list for single games.
Inputs
conferencestring- Conference abbreviation. Example: B1G
exclude_garbage_timeboolean- Excludes garbage-time plays when true. Example: true
player_idstring- Player ID. Required unless year is specified. Example: 4432577
positionstring- Player position abbreviation. Example: QB
teamstring- Team name. Example: Michigan
thresholdnumber- Minimum number of plays. Example: 0
yearinteger- Season year. Required unless playerId is specified. Example: 2024
collegefootballdata_player_season_stats_listGet player statistics aggregated by season, optionally for a team, conference, category or week range.Read-onlyList Player Season Stats
Get player statistics aggregated by season, optionally for a team, conference, category or week range. Returns a list of records with season, playerId, player, position, team, conference, category, statType, stat. Use this for season totals per player. Use collegefootballdata_game_player_stats_list for single games.
Inputs
yearintegerrequired- Season year. Example: 2024
categorystring- Statistical category. Example: passing
conferencestring- Conference name or abbreviation. Example: B1G
end_weekinteger- Latest week to include. Example: 12
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason start_weekinteger- Earliest week to include. Example: 1
teamstring- Team name. Example: Michigan
collegefootballdata_player_usage_listGet player usage rates for a season, overall and by down and play type.Read-onlyList Player Usage
Get player usage rates for a season, overall and by down and play type. Returns a list of records with season, id, name, position, team, conference, usage. Use this to see how much each player is involved in the offense. Use collegefootballdata_player_season_overview_get for one player's full season.
Inputs
yearintegerrequired- Season year. Example: 2024
conferencestring- Conference abbreviation. Example: B1G
exclude_garbage_timeboolean- Excludes garbage-time plays when true. Defaults to false. Example: true
player_idinteger- Player ID. Example: 4432577
positionstring- Player position abbreviation. Example: QB
teamstring- Team name. Example: Michigan
collegefootballdata_players_searchSearch players by name, returning up to 100 matches.Read-onlySearch Players
Search players by name, returning up to 100 matches. Returns a list of records with id, team, name, firstName, lastName, weight, height, jersey, position, hometown. Use this to find a player ID by name. Narrow with year, team or position.
Inputs
search_termstringrequired- Full or partial player name. Example: Jalen Milroe
positionstring- Player position abbreviation. Example: QB
teamstring- Team name. Example: Michigan
yearinteger- Season year. Example: 2024
collegefootballdata_plays_listList play-by-play data for a season week, optionally for a team, offense, defense or play type.Read-onlyList Plays
List play-by-play data for a season week, optionally for a team, offense, defense or play type. Returns a list of records with id, driveId, gameId, driveNumber, playNumber, offense, offenseConference, offenseScore, defense, home. Use this for play-level analysis. Year and week are required. Use collegefootballdata_play_types_list to get play type IDs.
Inputs
weekintegerrequired- Week number. Example: 5
yearintegerrequired- Season year. Example: 2024
classificationstring- Division classification of either team. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference of either team. Example: B1G
defensestring- Defensive team name. Example: Ohio State
defense_conferencestring- Defensive team conference. Example: example
offensestring- Offensive team name. Example: Michigan
offense_conferencestring- Offensive team conference. Example: example
play_typestring- Play type abbreviation. Example: 5
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name on either side of the play. Example: Michigan
collegefootballdata_poll_rankings_listGet poll rankings (AP, Coaches, CFP and others) for a season, by week.Read-onlyList Poll Rankings
Get poll rankings (AP, Coaches, CFP and others) for a season, by week. Returns a list of records with season, seasonType, week, polls. Use this for Top 25 polls. Pass poll=cfp with latest or final for the College Football Playoff rankings.
Inputs
yearintegerrequired- Season year. Example: 2024
finalboolean- Returns the CFP snapshot marked as final when true. Requires poll=cfp and cannot be combined with latest. Example: false
latestboolean- Returns the latest CFP snapshot when true, preferring the snapshot marked as final. Requires poll=cfp and cannot be combined with final. Example: false
pollstring- Poll name. One of: cfp. Example: cfpone of
cfp season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason weeknumber- Poll week. Example: 5
collegefootballdata_predicted_points_getGet expected points for each yard line at a given down and distance.Read-onlyGet Predicted Points
Get expected points for each yard line at a given down and distance. Returns a list of records with yardLine, predictedPoints. Use this to value a game situation. Down and distance are required.
Inputs
distanceintegerrequired- Distance to gain, in yards. Example: 10
downintegerrequired- Down number. Example: 1
collegefootballdata_pregame_win_probabilities_listGet pregame win probabilities for games, with the spread they are based on.Read-onlyList Pregame Win Probabilities
Get pregame win probabilities for games, with the spread they are based on. Returns a list of records with season, seasonType, week, gameId, homeTeam, awayTeam, spread, homeWinProbability. Use this before games. Use collegefootballdata_win_probability_get for in-game probabilities.
Inputs
season_typestring- Season type. One of: regular, postseason, both, allstar, spring_regular, spring_postseason. Example: regularone of
regularpostseasonbothallstarspring_regularspring_postseason teamstring- Team name. Example: Michigan
weekinteger- Week number. Example: 5
yearinteger- Season year. Example: 2024
collegefootballdata_records_listGet team win-loss records by season, split into total, conference, home, away and postseason.Read-onlyList Team Records
Get team win-loss records by season, split into total, conference, home, away and postseason. Returns a list of records with year, teamId, team, classification, conference, division, expectedWins, total, conferenceGames, homeGames. Use this for standings and records. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.
Inputs
conferencestring- Conference name or abbreviation. Example: B1G
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_recruiting_position_groups_listGet recruiting ratings aggregated by team and position group over a year range.Read-onlyList Recruiting Position Groups
Get recruiting ratings aggregated by team and position group over a year range. Returns a list of records with team, conference, positionGroup, averageRating, totalRating, commits, averageStars. Use this to see where a team recruits best.
Inputs
conferencestring- Conference name or abbreviation. Example: B1G
end_yearinteger- Latest recruiting class year. Defaults to the current year. Example: 2024
recruit_typestring- Recruit classification. Defaults to HighSchool. One of: JUCO, PrepSchool, HighSchool. Example: HighSchoolone of
JUCOPrepSchoolHighSchool start_yearinteger- Earliest recruiting class year. Defaults to 2000. Example: 2018
teamstring- Team name. Example: Michigan
collegefootballdata_recruiting_team_rankings_listGet team recruiting class rankings and points by year.Read-onlyList Recruiting Team Rankings
Get team recruiting class rankings and points by year. Returns a list of records with year, rank, team, points. Use this to compare recruiting classes. Use collegefootballdata_recruits_list for individual players.
Inputs
teamstring- Team name. Example: Michigan
yearinteger- Recruiting class year. Example: 2024
collegefootballdata_recruits_listList player recruiting rankings with stars, rating, position, school and hometown.Read-onlyList Recruits
List player recruiting rankings with stars, rating, position, school and hometown. Returns a list of records with id, athleteId, recruitType, year, ranking, name, school, committedTo, position, height. Use this for individual recruits. Use collegefootballdata_recruiting_team_rankings_list for class rankings.
Inputs
classificationstring- Recruit classification. Defaults to HighSchool. One of: JUCO, PrepSchool, HighSchool. Example: JUCOone of
JUCOPrepSchoolHighSchool positionstring- Position category. Example: QB
statestring- State or province abbreviation. Example: TX
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Recruiting class year. Required unless team is specified. Example: 2024
collegefootballdata_returning_production_listGet returning production by team for a season: the share of last season's production that returns.Read-onlyList Returning Production
Get returning production by team for a season: the share of last season's production that returns. Returns a list of records with season, team, conference, totalPPA, totalPassingPPA, totalReceivingPPA, totalRushingPPA, percentPPA, percentPassingPPA, percentReceivingPPA. Use this for offseason outlooks. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.
Inputs
conferencestring- Conference name or abbreviation. Example: B1G
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_roster_getGet a team's roster for a season, with each player's ID, name, position, jersey, height, weight, year and hometown.Read-onlyGet Team Roster
Get a team's roster for a season, with each player's ID, name, position, jersey, height, weight, year and hometown. Returns a list of records with id, firstName, lastName, team, height, weight, jersey, year, position, homeCity. Use this to get player IDs and roster details. Use collegefootballdata_players_search to find a player by name.
Inputs
classificationstring- Division classification: fbs or fcs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii teamstring- Team name. Example: Michigan
yearinteger- Season year. Defaults to 2025. Example: 2024
collegefootballdata_schedule_getGet the games for the current or next week, or for a requested season and week.Read-onlyGet Game Schedule
Get the games for the current or next week, or for a requested season and week. Returns assembledAt, selection, filters, window, followingWindow, games. Use this for upcoming or this week's games. Use collegefootballdata_games_list for historical games with filters.
Inputs
classificationstring- Division of either participant. Defaults to fbs. One of: fbs, fcs. Example: fbsone of
fbsfcs conferencestring- Conference abbreviation of either participant. Example: B1G
season_typestring- Season type. Requires year and week. One of: regular, postseason. Example: regularone of
regularpostseason weekinteger- Week number. Requires year and seasonType. Example: 5
yearinteger- Season year. Requires seasonType and week. Example: 2024
collegefootballdata_scoreboard_getGet the current scoreboard: live and recent games with scores, status, betting lines and weather.Read-onlyGet Scoreboard
Get the current scoreboard: live and recent games with scores, status, betting lines and weather. Returns a list of records with id, startDate, startTimeTBD, tv, neutralSite, conferenceGame, status, period, clock, situation. Use this for what is happening now. Use collegefootballdata_games_list for past seasons.
Inputs
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. Example: B1G
collegefootballdata_sp_conference_ratings_listGet conference-level SP+ ratings by season.Read-onlyList Conference SP+ Ratings
Get conference-level SP+ ratings by season. Returns a list of records with year, conference, rating, secondOrderWins, sos, offense, defense, specialTeams. Use this to compare conferences. Use collegefootballdata_sp_ratings_list for teams.
Inputs
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. Example: B1G
yearinteger- Season year. Example: 2024
collegefootballdata_sp_ratings_listGet SP+ team ratings by season, with offense, defense and special teams components.Read-onlyList SP+ Ratings
Get SP+ team ratings by season, with offense, defense and special teams components. Returns a list of records with year, team, conference, rating, ranking, secondOrderWins, sos, offense, defense, specialTeams. Use this for SP+ ratings. Use collegefootballdata_srs_ratings_list, collegefootballdata_elo_ratings_list or collegefootballdata_fpi_ratings_list for other systems.
Inputs
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_srs_ratings_listGet Simple Rating System (SRS) team ratings by season.Read-onlyList SRS Ratings
Get Simple Rating System (SRS) team ratings by season. Returns a list of records with year, team, conference, division, rating, ranking. Use this for SRS. Use collegefootballdata_sp_ratings_list for SP+.
Inputs
conferencestring- Conference name or abbreviation. Example: B1G
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_stat_categories_listList the team statistical categories.Read-onlyList Stat Categories
List the team statistical categories. Returns a list. Use this to see which categories collegefootballdata_team_season_stats_list returns.
Inputs
This tool takes no inputs.
collegefootballdata_team_advanced_stats_listGet advanced team statistics by season: success rate, explosiveness, PPA, havoc and field position, for offense and defense.Read-onlyList Team Advanced Season Stats
Get advanced team statistics by season: success rate, explosiveness, PPA, havoc and field position, for offense and defense. Returns a list of records with season, team, conference, offense, defense. Use this for efficiency analysis over a season. Use collegefootballdata_game_advanced_stats_list for single games.
Inputs
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii end_weekinteger- Latest week to include. Example: 12
exclude_garbage_timeboolean- Excludes garbage-time plays when true. Defaults to false. Example: true
start_weekinteger- Earliest week to include. Example: 1
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_team_ats_records_listGet each team's record against the betting spread (ATS) for a season.Read-onlyList ATS Records
Get each team's record against the betting spread (ATS) for a season. Returns a list of records with year, teamId, team, conference, games, atsWins, atsLosses, atsPushes, avgCoverMargin. Use this for betting performance. Use collegefootballdata_betting_lines_list for individual game lines.
Inputs
yearintegerrequired- Season year. Example: 2024
conferencestring- Conference name or abbreviation. Example: B1G
teamstring- Team name. Example: Michigan
collegefootballdata_team_matchup_getGet the head-to-head history between two teams: each team's wins, ties and every game played.Read-onlyGet Team Matchup
Get the head-to-head history between two teams: each team's wins, ties and every game played. Returns team1, team2, startYear, endYear, team1Wins, team2Wins, ties, games. Use this for rivalry history. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.
Inputs
team1stringrequired- First team name. Example: Michigan
team2stringrequired- Second team name. Example: Ohio State
max_yearinteger- Latest season year to include. Example: 2024
min_yearinteger- Earliest season year to include. Example: 2010
collegefootballdata_team_ppa_listGet team Predicted Points Added (PPA) per play by season, for offense and defense.Read-onlyList Team PPA
Get team Predicted Points Added (PPA) per play by season, for offense and defense. Returns a list of records with season, conference, team, offense, defense. Use this for season-level PPA. Use collegefootballdata_game_ppa_list for single games.
Inputs
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference abbreviation. Example: B1G
exclude_garbage_timeboolean- Excludes garbage-time plays when true. Example: true
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_team_season_overview_getGet a full-season overview of one team, including postseason games and garbage-time splits.Read-onlyGet Team Season Overview
Get a full-season overview of one team, including postseason games and garbage-time splits. Returns advanced, players, passing, rushing, statRankings, record, ratings, season, teamId, team. Use this for a one-call summary of a team's season. Use collegefootballdata_teams_list for team names and collegefootballdata_conferences_list for conference abbreviations.
Inputs
teamstringrequired- Team name. Example: Michigan
yearintegerrequired- Season year. Example: 2024
collegefootballdata_team_season_stats_listGet team statistics aggregated by season, optionally for a team, conference or week range.Read-onlyList Team Season Stats
Get team statistics aggregated by season, optionally for a team, conference or week range. Returns a list of records with season, team, conference, statName, statValue. Use this for team season totals. Use collegefootballdata_team_advanced_stats_list for efficiency metrics.
Inputs
classificationstring- Division classification. Defaults to fbs. One of: fbs, fcs, ii, ii/iii, iii. Example: fbsone of
fbsfcsiiii/iiiiii conferencestring- Conference name or abbreviation. Example: B1G
end_weekinteger- Latest week to include. Example: 12
start_weekinteger- Earliest week to include. Example: 1
teamstring- Team name. Required unless year is specified. Example: Michigan
yearinteger- Season year. Required unless team is specified. Example: 2024
collegefootballdata_team_talent_listGet the 247Sports Team Talent Composite rating of every team for a season.Read-onlyList Team Talent
Get the 247Sports Team Talent Composite rating of every team for a season. Returns a list of records with year, team, talent. Use this to compare roster talent. Use collegefootballdata_recruiting_team_rankings_list for recruiting classes.
Inputs
yearintegerrequired- Season year. Example: 2024
collegefootballdata_teams_listList college football teams with school name, mascot, abbreviation, conference, colors, logos and venue.Read-onlyList Teams
List college football teams with school name, mascot, abbreviation, conference, colors, logos and venue. Returns a list of records with id, school, mascot, abbreviation, alternateNames, conference, division, classification, color, alternateColor. Use this to get exact team names for other tools. Use collegefootballdata_fbs_teams_list for FBS teams only.
Inputs
conferencestring- Conference abbreviation. Example: B1G
yearinteger- Season year for historical conference affiliations. Example: 2024
collegefootballdata_transfer_portal_listList transfer portal entries for a season, with origin, destination, position, rating and eligibility.Read-onlyList Transfer Portal
List transfer portal entries for a season, with origin, destination, position, rating and eligibility. Returns a list of records with season, firstName, lastName, position, origin, destination, transferDate, rating, stars, eligibility. Use this to track transfers. The year is the season the transfer takes effect.
Inputs
yearintegerrequired- Season year. Example: 2024
collegefootballdata_user_info_getGet the authenticated user's Patreon level and remaining monthly API calls.Read-onlyGet API Key Info
Get the authenticated user's Patreon level and remaining monthly API calls. Returns patronLevel, tierName, monthlyLimit, remainingCalls, usedCalls, resetAt, sharedPool, products, features. Use this to check how many calls the key has left. Each tool call uses one.
Inputs
This tool takes no inputs.
collegefootballdata_venues_listList college football stadiums with capacity, surface, location, elevation and dome status.Read-onlyList Venues
List college football stadiums with capacity, surface, location, elevation and dome status. Returns a list of records with id, name, city, state, zip, countryCode, timezone, latitude, longitude, elevation. Use this for venue details. Takes no filters.
Inputs
This tool takes no inputs.
collegefootballdata_win_probability_getGet the play-by-play win probability chart for one game.Read-onlyGet Win Probability
Get the play-by-play win probability chart for one game. Returns a list of records with gameId, playId, playText, homeId, home, awayId, away, spread, homeBall, homeScore. Use this to see how a game swung. Get the game ID from collegefootballdata_games_list. Use collegefootballdata_pregame_win_probabilities_list for pregame odds.
Inputs
game_idintegerrequired- Game ID. Example: 401520281
No tools match.