# College Football Data AI integration on Definable

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

## What this connects

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

Vendor: https://collegefootballdata.com

## Tools available

**56** tools available. First 12:

- `COLLEGE_FOOTBALL_DATA_ADVANCED_BOX_SCORE` — Advanced Box Score — Retrieves advanced analytics for a single college football game including: - Team metrics: PPA (Predicted Points Added), success rates, rushing efficiency, havoc rates, scoring opportunities - Player metrics: Usage rates by quarter and play type, individual PPA breakdowns - Game info: Teams, scores, win probabilities, excitement index Requires a valid gameId from Get Games and Results action. Returns detailed breakdown by quarter.
- `COLLEGE_FOOTBALL_DATA_ADVANCED_GAME_STATS` — Advanced Game Stats — Tool to retrieve advanced team metrics at the game level. Use when detailed offensive and defensive metrics (success rates, explosiveness, havoc) are needed.
- `COLLEGE_FOOTBALL_DATA_ADVANCED_SEASON_STATS_TEAM` — Advanced Season Stats by Team — Retrieve advanced season-level team statistics including PPA (Predicted Points Added), success rates, explosiveness, havoc metrics, and rushing/passing efficiency breakdowns. Use this for in-depth team performance analysis beyond basic stats. At least one of 'year' or 'team' must be provided.
- `COLLEGE_FOOTBALL_DATA_BETTING_LINES` — Betting Lines — Tool to fetch betting lines and totals by game and provider. Use when you need current or historical betting line data filtered by specific criteria.
- `COLLEGE_FOOTBALL_DATA_COMPOSITE_TEAM_TALENT` — Composite Team Talent — Fetches 247Sports composite team talent rankings for a given season. Returns a list of all FBS teams ranked by their composite talent score, which is based on aggregate recruit ratings. Higher scores indicate rosters with more highly-rated recruits.
- `COLLEGE_FOOTBALL_DATA_CONFERENCE_MEMBERSHIPS_HISTORY` — Conference Memberships — Tool to retrieve current conference memberships for college football teams. Returns which teams belong to which conference, optionally filtered by conference. Use to find all teams in a specific conference or to see the current conference landscape.
- `COLLEGE_FOOTBALL_DATA_DIVISIONS_BY_CONFERENCE` — Divisions by Conference — Tool to list FBS/FCS conference divisions with active years and metadata. Use after specifying an optional season year to filter active divisions.
- `COLLEGE_FOOTBALL_DATA_GET_CONFERENCE_SP` — Get Conference SP+ Ratings — Retrieve aggregated historical conference SP+ (Success Rate + Points Per Play) ratings for college football conferences. Use this to get conference-level offensive, defensive, and special teams metrics aggregated from all teams in each conference. Filter by year to get specific season data, or by conference name to get historical ratings for a specific conference.
- `COLLEGE_FOOTBALL_DATA_GET_DRIVE_DATA` — Get Drive Data — Retrieves college football drive-level data including offensive/defensive teams, yards gained, drive results (TD, PUNT, INT, etc.), time elapsed, and scoring information. Use to analyze drive efficiency, red zone performance, or game flow. Requires year; optionally filter by week, team, conference, or season type (regular/postseason).
- `COLLEGE_FOOTBALL_DATA_GET_FIELD_GOAL_EXPECTED_POINTS` — Get Field Goal Expected Points — Retrieves field goal expected points values for various field positions and distances. Returns static model data showing expected points for field goal attempts based on distance. Useful for analyzing field goal decision-making and expected value calculations.
- `COLLEGE_FOOTBALL_DATA_GET_FPI` — FPI Ratings — Retrieves historical Football Power Index (FPI) ratings for college football teams. FPI is ESPN's measure that predicts team strength and game outcomes. Use this to get team ratings, efficiency metrics, and resume rankings. Specify a year to get all teams' ratings for that season, or a team name to get historical ratings, or both for a specific team-season combination.
- `COLLEGE_FOOTBALL_DATA_GET_GAME_HAVOC_STATS` — Get Game Havoc Stats — Tool to retrieve havoc statistics aggregated by game. Use when you need game-level havoc metrics including DB havoc rate, front seven havoc rate, and total havoc events for offense and defense.

## Auth

Auth schemes: `API_KEY`.

## How agents use College Football Data

Inside a Definable workflow, College Football Data is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → College Football Data** — the Researcher (GPT-5.5) pulls context from College Football Data (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → College Football Data** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into College Football Data (create record, post message, draft email).
- **Designer / Engineer → Distributor → College Football Data** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via College Football Data (attach file, open PR comment, post status).

The Verifier checks every College Football Data call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- analytics — https://definable.ai/apps/category/analytics/

## Related

- HTML page: https://definable.ai/apps/college_football_data/
- Same category (analytics): https://definable.ai/apps/category/analytics/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt
