College Football Coverage
Here is a summary of SportsDataIO's extensive College Football coverage. Read on to learn about the vast number of feeds we offer and don't hesitate to contact us if you have any questions.
See a summary of coverage across all leagues here: SportsDataIO coverage matrix (PDF)
Competition Feeds
Standings, Rankings & Brackets
Standings records for the league, conference and division, including both regular season and playoffs.
- Standings for each team include total wins/losses, conference wins/losses, AP Poll and Coaches' Poll rankings.
- Only Current season Standings are available for College Football.
Endpoint
Return Type
Call Interval
Conference[]
4 Hours
A list of all conferences and their associated teams. Standings can be found here for each conference.
Developer Section
Teams, Players & Rosters
Team rosters and player profiles are tracked in real time starting about 60 days prior to the beginning of each season and after that transfer portal closes, all the way through the end of each season.
- Team feeds includes profile information such as as name, conference, and team colors (hexadecimal format) and home stadium.
- Player Profile details include data fields such as name, position, class (senior, redshirt freshman, etc) jersey, height/weight, high school, and home town.
Endpoint
Return Type
Call Interval
Team[]
4 Hours
Full team information: team name, school and city, conference and division, and colors. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns all teams regardless of current active status.
PlayerBasic[]
5 Minutes
Roster information for a given team. Player profiles include basic biographical information, position, college, and current team (if attached to a team.) Specify a team tricode parameter to receive all players currently on that team.
TeamBasic[]
5 Minutes
The most basic top-line team information, such as team name and city, conference and division, stadium ID, coach info, and team colors. Returns all teams regardless of current active status.
PlayerBasic[]
1 Hour
Full player bio and details, including injury notes, for all active players.
Developer Section
Venues & Officials
A list of all active stadiums for the regular season and bowl games.
- Stadium profiles include things like name, location, lat/long coordinates, altitude, seating capacity.
- All neutral venue schedule games will have VenueID in our Stadiums endpoint unique to College Football.
Utility Endpoints
Utility Endpoints are activated for all customers to allow them to build the back-end connections needed for their relational database and be informed about relevant information throughout the season.
- Timeframe utility endpoints include things like current and previous season, current and previous week, etc.
- Status utility endpoints include things like if games are currently in progress or not.
- Sports betting utility endpoints includes things like sportsbook IDs, betting market type IDs, etc.
Endpoint
Return Type
Call Interval
Sportsbook[]
1 Hour
A list of all available sportsbooks with their associated unique IDs.
GET
Betting Metadata
BettingEntityMetadataCollection
15 Minutes
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
Season
5 Minutes
The current season year, its start and end years, season type, week etc.
string
5 Minutes
The current type of season (e.g. REG, POST for regular or playoff.)
GET
Season Current
integer
5 Minutes
Year of the current season. This value changes at the start of the new league year. For leagues that run over two years, this is the year the season starts, not ends.
GET
Week Current
integer?
5 Minutes
Number of the current week of the season. This value usually changes on Saturday into Sunday overnight, but in the rare case of a rescheduled or special game with a non-standard gameday this could change.
boolean
5 Seconds
Returns
true if there is at least one game being played at the time of the request or false if there are none.
Developer Section
Event Feeds
Schedules & Game Day Info
Schedules are updated when initially released by the NCAA about a year in advance and kept up-to-date throughout the season, plus additional game day info.
- Schedule records includes teams, date & time and status: Scheduled, InProgress, Final, Suspended, Delayed, Postponed, Canceled.
- Game day info includes things like game status, VenueID, kick off time, TV Channel, teams playing.
Endpoint
Return Type
Call Interval
GET
Schedules
Game[]
5 Minutes
Home and away teams, date and time, season type and week etc. are included. Also includes gameday information. This includes full stadium information (capacity, lat/long, surface etc.), top-line betting information (spread, moneyline, total), weather conditions, and broadcast information.
ScheduleBasic[]
5 Minutes
A lightweight schedule endpoint without gameday information. Home and away teams, the date and time of the game, and season type, week etc. are included. Ideal for the most basic information required to build a schedule.
Developer Section
Scores & Game State
Scores and Game State are updated live during all games, along with the final score being provided after the game is completed and verified.
- Score includes the score for every quarter plus the final score for both teams.
- Game State includes things like score current period, time remaining, possession, down & distance, if the ball is in the red zone, and if the game is in overtime.
Final Only (No Game State)
- Scores delivered as "Final Only" will deliver the final half and OT scores and final scores of both teams once the game is completed and verified.
- Game State is only available through live in-game updates, and therefore is not included for customers only taking "Final Only" delivery.
Endpoint
Return Type
Call Interval
Game[]
5 Seconds
Full scores and gameday info, including weather, referee, infotainment odds, as well as all of the quarter scores and full-time score as the game ends.
ScoreBasic[]
5 Seconds
A slimmed-down score endpoint, giving just the quarter scores and final score, for simple applications, delivered as the game ends, called by date.
ScoreBasic[]
5 Seconds
A slimmed-down score endpoint, giving just the quarter scores and final score, for simple applications, delivered as the game ends, called by week.
Game[]
5 Seconds
Full scores and gameday info, including weather, referee, infotainment odds, as well as all of the quarter scores and full-time score, delivered as the game ends.
Developer Section
Live & Final (With Game State)
- Scores delivered as "Live & Final" includes live updates throughout the game, plus a final score of the game once it is completed and verified.
- Game State delivered as "Live & Final" includes live game state info throughout the game, updated alongside the live score updates.
- Game State includes things like Score, half, time remaining, down and distance, and possession
Endpoint
Return Type
Call Interval
ScoreBasic[]
1 Minute
This endpoint simply delivers quarter, clock, and total score live; no down and distance and no gameday info such as weather.
Game[]
5 Seconds
Full scores and gameday info delivered live and post-game for a given date. Live data includes down and distance, as well as game clock. Gameday info includes referee, weather, TV channel etc.
Game[]
5 Seconds
Full scores and gameday info delivered live and post-game for a given gameweek. Live data includes down and distance, as well as game clock. Gameday info includes referee, weather, TV channel etc.
Developer Section
Team & Player Stats
Team and Player Stats are managed on a game by game basis as well as season long totals. Stats are updated in season for every game, along with detailed Box Score level information for each particular game.
- See our TeamGame and TeamSeason Data Dictionary tables for a full list of available Team Stats.
- See our PlayerGame and PlayerSeason Data Dictionary tables for a full list of available Player Stats.
Final Only
- Team & Player Stats delivered as "Final Only" include a final box score of all team and player stats once it is completed and verified.
- Team & Player Season Stats delivered as "Final" once games are completed and verified.
Endpoint
Return Type
Call Interval
PlayerGame[]
1 Hour
Specify a season, a player, and number of games (either an integer or
all) to see all of their box score logs. Refreshed after their most recent game is complete.
TeamGame[]
1 Hour
Game by game log of total team statistics.
PlayerSeason[]
15 Minutes
Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season.
PlayerSeason[]
15 Minutes
Returns all season-long stats (i.e. the season total, not each individual game record) for a given team's players in a given season.
TeamSeason[]
5 Minutes
Returns all season-long stats (i.e. the season total, not each individual game record) for all teams (aggregated from all players) for a given season. Also includes their standing information.
PlayerGame[]
5 Minutes
Returns the box score statistical record for all involved players across all teams' games on a given week after each game has concluded.
TeamGame[]
5 Minutes
Returns the box score statistical record team-wide (aggregated from all players) for games in a given week after the game has concluded.
BoxScore[]
1 Minute
Full statistical information for a specified game, down to the team and player stat level, delivered after the game is complete.
BoxScore[]
1 Minute
Full statistical information for a specified date, down to the team and player stat level, delivered after the game is complete.
BoxScore[]
1 Minute
Full statistical information for a specified game week for each game that took place, down to the team and player stat level, delivered after the game is complete.
Developer Section
Live & Final
- Team & Player Game Stats delivered as "Live & Final" include live updates throughout the game, plus a final box score of all team and player stats once it is completed and verified.
- Note that defensive player stats update 1-2 hours after the game has ended.
- Team & Player Season Stats delivered as "Final" once games are completed and verified.
Endpoint
Return Type
Call Interval
TeamGame[]
5 Minutes
Returns the box score statistical record team-wide (aggregated from all players) for a all teams' games in a given week, both live and post-game.
PlayerGame[]
5 Minutes
Returns the box score statistical record for all involved players across a given week, updated live as the games take place. Note that defensive player stats update 1-2 hours after the game has ended.
BoxScore[]
1 Minute
Full statistical information for a specified game, down to the team and player stat level, delivered live during the game, called per individual game. Note that defensive player stats update 1-2 hours after the game has ended.
BoxScore[]
1 Minute
Full statistical information for a specified game, down to the team and player stat level, delivered live during the games, called for all games on a given date. Note that defensive player stats update 1-2 hours after the game has ended.
BoxScore[]
1 Minute
Full statistical information, down to the team and player stat level, delivered live during the games, called for all games on a given week of a given season. Note that defensive player stats update 1-2 hours after the game has ended.
BoxScore[]
5 Seconds
This method returns all box scores for a given season and week, but only returns player stats that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final. Note that defensive player stats update 1-2 hours after the game has ended.
Developer Section
Player Feeds
Depth Charts, Lineups & Injuries
SportsDataIO monitors official injury wires for each FBS team and conference, as well as trusted media sources, to determine the latest injury status of each NCAA Division I football player. While official sources are always preferred, credible media reports are also used to ensure we are up to date.
- Injury details include things like InjuryStatus, InjuryBodyPart, InjuryStartDate, and InjuryNotes.
Depth Charts, Lineups & Injuries
Endpoint
Return Type
Call Interval
Player[]
1 Hour
Full player bio and details, including injury notes, for all active players.
Player[]
1 Hour
Full player bio and details, including injury notes, for all available players by team.
Player[]
3 Minutes
This endpoint provides all currently injured college football players, along with injury details.
Developer Section
Betting Feeds
Game Lines
Game lines (spread, moneyline, totals) available as both pre-match and in-play, including timestamps for opening price, all line movement changes, and closing price, with optional resulting available as an add-on.
- Odds are made available when sportsbooks publish opening lines, typically starting Sunday of each game week.
- Includes full-game odds markets plus partial game lines such as halves and quarters.
Pre-Game Lines
- Includes full-game odds markets plus partial game lines such as halves and quarters.
- Does not include resulting of game line markets.
Endpoint
Return Type
Call Interval
GameInfo[]
1 Minute
Returns the non-full-game odds (spread, moneyline, total) for games in a given week and season. Non-full-game means 1st-half or 1st-quarter, for example, rather than full game. Only returns the most recently seen odds, not inclusive of line movement.
GameInfo[]
30 Seconds
Returns full game odds (spread, moneyline, total) for games in a given week and season. Only returns the most recently seen odds, not inclusive of line movement.
GameInfo[]
30 Seconds
Returns the full-game and non-full-game odds (spread, moneyline, total) for games in a given week and season. Only returns the most recently seen odds, not inclusive of line movement. A Sportsbook Group must be specified as a URL parameter.
Developer Section
Pre-Game Lines Plus
- Includes full-game odds markets plus partial game lines such as halves.
- Includes all line movement for pre game odds markets.
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Pre-game full game odds and partial game odds results are available 5-10 minutes following the conclusion of each game once all stats are verified.
- See our Aggregated Odds resulting guide for more.
Endpoint
Return Type
Call Interval
GameInfo[]
15 Minutes
Returns the non-full-game odds (spread, moneyline, total) for games in a given week and season. Non-full-game means 1st-half or 1st-quarter, for example, rather than full game. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfo[]
15 Minutes
Returns the non-full-game odds (spread, moneyline, total) for games in a given week and season. Non-full-game means 1st-half or 1st-quarter, for example, rather than full game. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfo[]
15 Minutes
Returns the game odds ( for games in a given week and season. In this endpoint both full-game and partial-game odds are included. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
GameInfoResult[]
15 Minutes
Returns the game odds ( for games in a given week and season. In this endpoint both full-game and partial-game odds are included. This also includes Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
Developer Section
In-Play Lines
- In-play betting markets, including spread, moneyline, and totals are available immediately following the start of each game as the sportsbooks make them available.
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Does not include resulting of game line markets.
Endpoint
Return Type
Call Interval
GameInfo[]
5 Seconds
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress. A Sportsbook Group must be specified as a URL parameter.
GameInfo[]
5 Seconds
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
Developer Section
In-Play Lines Plus
- In-play betting markets, including spread, moneyline, and totals are available immediately following the start of each game as the sportsbooks make them available.
- Includes all line movement for In-play betting markets
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- In-play game odds results are available 5-10 minutes following the conclusion of each game once all stats are verified.
Endpoint
Return Type
Call Interval
GameInfoResult[]
15 Minutes
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. This also includes Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
GameInfo[]
15 Minutes
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
GameInfo[]
15 Minutes
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Developer Section
Props
Includes Player, Game, and Team Props available as both pre-match including timestamps for opening price, all line movement changes, and closing price, with optional resulting available as an add-on.
- Odds are made available when sportsbooks publish opening lines, typically the Sunday or Monday of the week of upcoming games, depending on the matchup.
Props
Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Does not include resulting of prop markets.
Interested in Historical Odds? See our Historical Odds guide for how to access these.
Endpoint
Return Type
Call Interval
BettingMarket[]
10 Minutes
Returns the markets and available outcomes for a given BettingEventID. A Sportsbook Group must be specified as a URL parameter.
BettingMarket[]
10 Minutes
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID. A Sportsbook Group must be specified as a URL parameter.
BettingMarket[]
1 Minute
Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint. A Sportsbook Group must be specified as a URL parameter.
BettingMarket[]
10 Minutes
This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint. A Sportsbook Group must be specified as a URL parameter.
BettingEvent[]
15 Minutes
The list of current BettingEvents for the given date, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
BettingEvent[]
1 Hour
The list of current BettingEvents for the given season, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
BettingMarket[]
10 Minutes
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
BettingMarket[]
10 Minutes
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID.
BettingMarket[]
1 Minute
Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
BettingMarket[]
10 Minutes
This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint.
Developer Section
Props Plus
- See our CFB integration guide for all available Props odds markets with resulting.
- Pre-game props results are available 10-15 minutes following the conclusion of each game once all stats are verified.
- Line movement is available for all Prop betting markets
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
Endpoint
Return Type
Call Interval
GET
Betting Market
BettingMarket
15 Minutes
Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines.
BettingMarketResult
30 Seconds
Provide a market ID that supports resulting (i.e. has a ResultType) and this endpoint will return a result: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
BettingMarket
1 Hour
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
BettingMarket
15 Minutes
Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines. A Sportsbook Group must be specified as a URL parameter.
BettingMarketResult
30 Seconds
Provide a market ID that supports resulting (i.e. has a ResultType) and this endpoint will return a result: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. A Sportsbook Group must be specified as a URL parameter.
Developer Section
Futures
Team, Player, and Season futures such as win totals, Heisman, College Playoff Winner and many others are available are available at the start of each season and include timestamps for opening price, all line movement changes, and closing price, with new markets added as the season progresses.
- Odds are made available when sportsbooks publish opening lines, typically starting in the off season after schedules are released all the way through the conclusion of the College Football Playoff.
- Odds markets are available from 20+ sports books including a concensus line for each type of odds market.
Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Does not include resulting of prop markets.
Interested in Historical Odds? See our Historical Odds guide for how to access these.
Endpoint
Return Type
Call Interval
BettingMarket
1 Hour
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
BettingEvent[]
1 Hour
Returns available Futures markets for the given season. Does not include line movement. A Sportsbook Group must be specified as a URL parameter.
BettingEvent[]
1 Hour
Returns available Futures markets for the given season. Does not include line movement.
Developer Section
Matchups, Trends & Splits
Betting Splits provide the percentage of bets placed on either side of the line and the percentage of the money wagered on either side of the line. Matchups and Trends leverage our vast historical database to calculate all the traditional information found on a betting match up page.
- Matchups, Trends & Splits are generated and updated on a daily basis.
Matchup Stats
- We provide betting trends by matchup between two teams, showing historical and recent results for the teams in question, including standings, split standings, and other trends.
- Include team trends from the last 3/5/10 games - wins/loss/ties, history against the spread, average score, and opponent score.
Endpoint
Return Type
Call Interval
MatchupTrends
5 Minutes
Returns trends data for a given pairing of teams. Will return data even if the teams are not set to play this season. Intended for use on a specific game, though it will work for other comparisons if applicable.
TeamTrends
5 Minutes
Describes recent team trends and performance against betting data in recent sets of games.
Developer Section
Betting Splits
- Pre-Match betting splits are available for Money Line, Spread, and Total for all available games where data is published.
- Betting Splits are a representation of bets and dollars made on published lines, this data typically becomes available after the lines have been published and wagers have been made and the wager information has been collected.
Endpoint
Return Type
Call Interval
BettingMarketSplit
List of Money and Bet Percentage splits for each outcome type available in this market. This specific endpoint will return the movement from this market as well as the most recent.
GameBettingSplit
15 Minutes
List of Money and Bet Percentage splits for each market and their respective outcome types available in this game. This specific endpoint will return current splits for each available market and no line movement.
Developer Section
News & Images
Previews, Recaps & Breaking News
SportsDataIO provides bespoke news feeds and a variety of levels of news coverage to fit your specific needs:
- Editorial Wire Service: This includes more than 30,000 long-form content pieces in total across all leagues (previews, recaps, breaking news) with an associated image attached to each article. Please contact us to learn more about how we can connect you with news wire articles.
- Custom News: For bespoke articles created to fit your project, please contact us.
- AI-generated news: For procedurally-generated news based on data inputs, please contact us.
Player Headshots
Headshots are officially licensed in partnership with multiple licensed image providers and are updated leading up to the start of each season to capture new players and rookies being added as those images become available.
- All of our headshots are cropped 1200x1200 pixels with 300 resolution.
- Headshots are the property of the photographers that take them and the publishers that make them available, and as such we work with major providers to ensure that we have the best in licensed headshots.