Introduction
Sportradar’s NFL API offers a comprehensive suite of game and seasonal stats. Whether you are looking for the fastest gameday updates, your favorite player’s season stats, or in-depth subjective statistics, 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. All NFL games – including preseason – feature full play-by-play coverage.
Primary feeds will return schedules, standings, team/player data, and real-time scores.
Additional feeds provide a host of complementary stats, including:
- Team rosters
- Depth charts
- Weekly injuries
- Seasonal statistics
- Subjective statistics
- Draft information
Real-time customers are also offered four delivery Push Feeds to enhance speed.
Authentication is required for all API calls.
See our NFL Integration Guide
Explore our NFL Integration Guide for detailed, step-by-step guidance on how to build applications using our NFL API.
API Map
To best utilize the NFL 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.
Daily Transactions – Provides information for all transactions added or edited during the league-defined day.
Draft Summary – Provides pre-draft pick order with live pick selections during the draft. Displays information on draft rounds, picks, teams, and prospects for a given draft year.
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 extensive team and player level game statistics for each team.
League Hierarchy – Provides top-level information for each team, including conference and division distinction, venue information, and team colors.
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, draft information, and seasonal statistics.
Postgame Standings – Provides standings information for each team, updated postgame.
Prospects – Provides a list of upcoming or historical draft prospects for a given year.
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 and season type.
Seasons – Provides a list of all available seasons, including preseasons and postseasons.
Team Draft Summary – Provides pre-draft pick order with live pick selections during the draft for a given team.
Team Profile – Provides franchise team information, as well as a roster of active players.
Team Roster – Provides franchise team information, as well as the complete roster of players.
Teams – Provides a complete list of active teams in the NFL API database.
Top Prospects – Provides a list of the top prospects for a given year.
Trades – Provides summary details of all in-draft trades.
Weekly Depth Charts – Provides depth chart information for each team for a given week.
Weekly Injuries – Provides a list of injured players for each team for a given week, including practice status.
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 Draft Picks – Provides pre-draft pick order with real-time (push enabled) pick selections during the draft.
Push Draft Trades - Provides summary details of all in-draft trades in real-time.
Push Events - Provides detailed, real-time information on every live game event.
Push Pulse - Provides real-time messages about on-field activity before, during, and after a play. (Available for Realtime access only)
Push Statistics - Provides detailed, real-time game stats at the team and player level for all live games.
Data Retrieval Samples
To find the team a player was drafted by:
- Call the season or weekly schedule and find a Game Id that they played in
- Call the Game Roster using the Game Id to get the Player Id
- Call the Player Profile and locate the Player Draft Team Alias.
The Alias maps to the team that drafted the player.
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
Every NFL game is covered at our highest level, full coverage. This includes real-time play-by-play and game statistics.
Preseason Coverage Note:
API data latency will vary compared to regular season games. Preseason games often serve as a testing ground, resulting in changes and adjustments to data collection methods. As a result, data updates may not be as timely or consistent as the regular season.
Integration Links
Integration Guide
Set up an account, learn the NFL API basics, study our game workflows, tackle in-depth integration scenarios, and more by visiting our NFL v7 Integration Guide!
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our NFL 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 NFL API XSD schema.
Simulations
Click here for a detailed breakdown on our available simulations.
Data Entry Workflow
See below for a daily breakdown of data updates for the NFL API.
Sunday
- Pregame transactions (Before Kickoff)
- Inactive players entered (90 minutes prior to each game)
- Player participation (1 hour after completion of the game)
- Games stats validated and moved to
closedstatus (1 hour after completion of the game) - Depth charts for Monday night game (1am ET)
- Update rankings (1am ET)
- Seasonal stats validation (all day)
- Transactions (All Day)*
Monday
- Inactive players entered (90 minutes prior to each game)
- Player participation (1 hour after completion of the game)
- Games stats validated and moved to
closedstatus (1 hour after completion of the game) - Injury updates for Thursday night game (11pm ET)
- Update rankings (1am ET)
- TV broadcast info updated for upcoming games (End of Day)
- Seasonal stats validation (all day)
- Transactions (All Day)*
Tuesday
- Injury updates for Thursday night game (11pm ET)
- Seasonal stats validation (all day)
- Transactions (All Day)*
Wednesday
- Injury report for Thursday night game (9pm ET)
- Thursday night game moved to
createdstatus (9pm ET) - Injury updates for Sunday games (11pm ET)
- Weekly stats changes (Evening)
- Depth charts for Thursday night game (1am ET)
- Seasonal stats validation (all day)
- Transactions (All Day)*
Thursday
- Inactive players entered (90 minutes prior to each game)
- Player participation (1 hour after completion of the game)
- Games stats validated and moved to
closedstatus (1 hour after completion of the game) - Injury updates for Sunday and Monday games (11pm ET)
- Update rankings (1am ET)
- Seasonal stat validation (All Day)
- Transactions (All Day)*
Friday
- Injury report for Sunday games (9pm ET)
- Sunday games moved to
createdstatus (9pm ET) - Injury updates for Monday night game (11pm ET)
- Depth charts for Sunday games (1am ET)
- Seasonal stat validation (All Day)
- Transactions (All Day)*
Saturday
- Injury report for Monday night game (9pm ET)
- Monday night game moved to
createdstatus (9pm ET) - Seasonal stats validation (all day)
- Transactions (All Day)*
* We monitor and update transactions throughout the day, using a combination of official and reliable sources.
Off Season
- Major trades and free agent signings are handled when deemed official by the league
- After the draft weekend, all team rosters will be updated by the end of the week
Important Dates
- The NFL schedule typically becomes available in May. It will be present in the API within two hours after it is announced.
For further questions, see our NFL API FAQ or reach out to our Support team.