This article is a short summary about all public available and machine readable data of the NFL.
A good entry for this is the following URL:
The root node contains metadata about the current week. This information will be used also for other calls below.
- Season: Year, when the season stared
- Season Type: In what part of season we are (PRE or REG)
- Week: The play week within the season and season type
But more interesting are the games. Here you find information about the game itself (like start date/time and the team names).
But for the teams you can also use the visitor and home team node (contains abbreviation, full name, nick name and city state):
Also interesting is the place where the game is:
But we want scores. So let’s have a look at that. It contains nearly all you might be interested in: Current play clock and game phase, yard line info, red zone indicator and all scores in summary (including the points for each quarter and how many timeouts are available).
This is a huge amount of information. And this data is live!
If you need just a short overview about the scores you might be also using this one instead:
Here it is also possible to receive information about historical scores. Just replace the Season-Year, Season Type and Week.
The tag names are shorten here but should be self explaining. E.g. “hs” is home score.
Big Play Videos
Yes also the Big Play videos are available via the NFL feed API:
It contains also the metadata about the current game week. But we continue here with the metadata about the Big Play itself:
Here the interesting information is the type (if it’s scoring or not) and the clock tine information. Also a short description is provided.
The next block in the JSON here is the game schedule as explained above.
But we want videos, right?
This is a lot of data including a preview screenshot in multiple resolutions.
Here you find the video in multiple bitrates (quality levels) for downloading as a single MP4 file. If you want to stream the video directly you should use the Video Playback URL instead. This is a HLS video feed that contains all available resolutions, Here the player picks automatically the correct video resolution.
At the end you find informations about the players that were involved in this Big Play:
Game Live Data
The following URL contains the game id (can be loaded using one of the APIs above).
This API gives you a lot of information about the game stats (including passing-, receiving- and rushing yards, fumbles and much more).
Also all drives (yes really all drives!) including its plays are also included als you might know it from the NFL.com website:
If you are just interested in the major drives you should have a look a the summary:
Since all URLs posted here are used by the NFL website itself there is no guarantee that they will not change within the future.
Thank you for this NFL Information. Can you please share how I access the data via a Dot Net Program? (C#)
I’m very familiar with C#, I’m just not familiar with how to format the request.
The requests above are only simple HTTP requests (GET requests). As far as I know is that there’s no definition file. So you must parse the JSON or XML response manually.
Thanks for this great post, really appreciated.!
Do you have any thoughts or documentation around, what the Descriptions are for the StatsID’s?
Thanks. I don’t have any documentation for this. This are just the results of my reverse engineering action. 🙂
http://www.nfl.com/feeds-rs?_wadl for the full schema of the api.
You can also check out my python package that uses some older feeds (nflgame-redux). I am currently in the process of refactoring into python 3 and picking up some new apis.
What is the feed for live real-time score. ?
Like team playing
Game status (warmup, game, final)
That is the most close to live/real-time as possible?
Thanks for sharing.
I have seen your api detail with happiness.
but can you explain me how to extract m3u8 vidoe urls for currnent day using your api?
Please let me know.
Can you provide me with a way to display multiple week scores. This is the way to display week 2.
What if I want Weeks 1-2. Or even all the Weeks 1-17?
Unfortunately the nfl score feed has been deprecated so it cannot be used anymore
I believe the subdomain changed for schedule and score xml. The one posted here no longer works, but this link is working:
However, the link to the live game data, http://www.nfl.com/liveupdate/game-center/2018102107/2018102107_gtd.json, seems to have changed as well and I have not been able to locate the new link.
If you have any information about the live game data link please let me know.
Thanks for sharing the new URL for the scorestrip. It seems that the NFL is securing their content behind the official API endpoint https://api.nfl.com/
But you need to contact therefore the NFL directly to get access to it.
The url to the schedule and score summary is available here:
The Game Live Data link no longer seems to work. If you happen to find the new link can you please share.
Thanks for sharing the new URL.
It looks like the NFL changed their entire API for 2021 season!? They seem to also have changed game ids and do not follow the yyyymmdd format anymore. Tonights Hall of Fame game on Aug 05 2021 has the following id: 55a03807-ca11-11eb-95ba-867d1cb04213
Is it accessible via a different url? I’m looking for basic info like team matchups and current scores, not play-by-play.