Introduction
Sportradar’s NCAA Football API offers a comprehensive suite of game and seasonal stats. Whether looking for the fastest gameday updates or your favorite player’s season stats, Sportradar has you covered.
All game data feeds update in real-time as games are played and are compiled via expert Sportradar in-house operators. 100% of Division 1 games are covered, including realtime play-by-play for all FBS games.
Primary feeds return schedules, standings, team and player data, and real-time scores.
Additional feeds provide a host of complementary stats, including:
- Player profiles
- Team rosters
- Top 25 rankings
- Seasonal statistics
Real-time customers are also offered two delivery Push Feeds to enhance speed.
Authentication is required for all API calls.
See our NCAAFB Integration Guide
Explore our NCAAFB Integration Guide for detailed, step-by-step guidance on how to build applications using our NCAA Football API.
API Map
To best utilize the NCAA FB API v7, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
Primary and additional feeds only require dates or human-readable parameters, while other feeds require a global unique identifier (GUID) to identify the game, team, or player that the feed will describe. The primary feeds provide GUIDs for games and teams, while games and teams provide GUIDS for players.
Endpoint Descriptions
Current Season Schedule – Provides schedule information for the current season, including venue and broadcast info, and scoring results by quarter.
Current Week Schedule – Provides schedule information for the current week, including venue and broadcast info, and scoring results by quarter.
Daily Change Log – Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
Game Boxscore – Provides game scoring information for each team, including complete play-by-play information for all scoring drives.
Game Roster – Provides complete game roster information for each team, including game status and player profile data.
Game Statistics – Provides team and player level game statistics for each team.
League Hierarchy – Provides top-level information for each team, including conference and sub-division distinction, and venue information.
Play-by-Play – Provides a live play-by-play timeline, including possession and location information as well as all team and player statistics earned on each play.
Player Profile – Provides player biographical information and seasonal statistics.
Postgame Standings – Provides standings information for each FBS and FCS team.
Rankings (By Week) – Provides the top 25 Rankings (Polls) for a given year and week.
Rankings (Current Week) – Provides the current top 25 Rankings (Polls).
Season Schedule – Provides complete schedule information for a given season, including venue and broadcast info, and scoring results by quarter.
Seasonal Statistics – Provides complete team and player seasonal statistics for a given season.
Seasons – Provides a list of all available seasons.
Team Roster – Provides a complete roster of players for a given team.
Teams – Provides a complete list of active teams in the NCAA Football API database.
Tournament List – Provides a summarized list of all tournaments scheduled for the given season.
Tournament Schedule – Provides the date, time, location, and other event details for every matchup taking place in a given tournament.
Tournament Summary – Provides tournament information including location, status, start date, end date, and participants.
Weekly Schedule – Provides complete schedule information for a given week of the season, including venue, weather conditions, broadcast info, and scoring results by quarter.
Push Events – Provides detailed, real-time information on every live game event.
Push Statistics – Provides detailed, real-time game stats at the team and player level for all live games.
Data Retrieval Sample
To find a teams number of defensive sacks:
- Call the season or weekly schedule and find the desired Team Id
- Call the Seasonal Statistics using the Team Id
- Locate the Team Defense Sacks.
The teams number of defensive sacks is displayed.
Coverage Levels
We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible. The coverage level for games are listed in the schedule feeds.
Extended Boxscore - For any game involving two FCS (Division-IAA) teams or a matchup between one FCS and one non Division-I team, we will provide scores and time remaining, in a timely manner, as the game progresses. We will provide team and player level data for the game by the close of business night of.
Full - We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team and player level data in near real time. Full coverage is available for any game involving an FBS (Division I-A) team and is available via a reliable video broadcast.
Coverage levels may be adjusted up to the scheduled start time at the discretion of our data entry managers for such reasons as resource availability or possible broadcast and technical difficulties.
Recommended Endpoints per Coverage Level
Due to the differences between available coverage levels, we recommend using specific game centric feeds based on the coverage level.
| Feeds | Full | |||
|---|---|---|---|---|
| Pre-Game | In Progress | Post Game | ||
| Boxscore | X | X | X | |
| Game Roster | X | X | X | |
| Game Statistics | X | X | ||
| Game Summary | X | X | ||
| Play-By-Play | X | |||
All FCS Playoff games will be covered via our Full coverage level.
Integration Links
Integration Guide
Set up an account, learn the NCAA Football API basics, study our game workflows, tackle in-depth integration scenarios, and more by visiting our NCAAFB v7 Integration Guide!
Postman Links
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our NCAA Men's Football API collection.
Feel free to follow and/or fork any collections to receive updates.
Schema Download
Open the zip file below to access our entire NCAA Football API XSD schema.
Simulations
Click here for a detailed breakdown on our available simulations.
Data Entry Workflow
Monday
- Assign coverage levels for games (End of Day) Levels subject to change
- Review schedule for current week's games (End of Day)
- TV broadcast information updated for games (End of Day)
- Games stats validated and moved to
closedstatus (150 minutes after completion of the game) - Seasonal stats validation (All Day)
Tuesday
- College Football Playoff Rankings created for the week's games (9pm CT - beginning in week 10)
- Games stats validated and moved to
closedstatus (150 minutes after game goes final) - Current week’s games moved to
createdstatus (End of Day) - Seasonal stats validation (All Day)
Wednesday
- Games stats validated and moved to
closedstatus (150 minutes after game goes final) - Seasonal stats validation (All Day)
Important Dates
- The NCAA football schedule typically becomes available by June.