NFL Daily Change Log provides IDs and timestamps for teams, players, game statistics, schedules, and results that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Update FrequencyTTL / Cache:
- 15 minutes for current day
- 1 hour for current month
- 4 hours for current year
- 12 hours for past years
Data Updates:
- Entries populate live for changes to teams, players, game statistics, schedules, and standings.
- Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC
Recommended Pull (Non-Live): Pull every ten minutes or less, depending on your use case.
Recommended Pull (Live): Not applicable
Monitoring Data ChangesLearn how to use the Daily Change Log to track updates without exhausting your API quota in our Monitoring Data Changes integration scenario.
Data Points
Change Log
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
start_time | changelog | dateTime | Start time of the daily change log ex. 2022-09-25T09:00:00+00:00 |
end_time | changelog | dateTime | End time of the daily change log ex. 2022-09-26T08:59:58+00:00 |
last_modified | games - schedule - game | dateTime | Timestamp of a change to a game's scheduling information ex. 2022-09-25T23:00:45+00:00 |
last_modified | games - results - game | dateTime | Timestamp of a change to a game's results ex. 2022-09-25T23:00:45+00:00 |
last_modified | profiles - players - player | dateTime | Timestamp of a change to a player ex. 2022-09-25T22:54:34+00:00 |
last_modified | profiles - teams - team | dateTime | Timestamp of a change to a team profile ex. 2022-09-25T21:32:05+00:00 |
League
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | league | String | Alias of a league ex. NFL |
id | league | GUID | Unique ID of a league ex. 3c6d318a-6164-4290-9bbc-bf9bb21cc4b8 |
name | league | String | Name of a league ex. National Football League |
Games & Results
The games element contains two child elements, schedule and results. A game appearing under schedule indicates a change to that game's scheduling information; a game appearing under results indicates a change to that game's results. Both use the same attributes.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | game | GUID | Unique ID of a game ex. 056b4eb7-64ce-4858-bae7-f3701d8eb753 |
season_id | game | GUID | Unique ID of the season the game belongs to ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1 |
sr_id | game | String | Unique Sportradar ID of a game ex. sr:match:33623325 |
last_modified | game | dateTime | Timestamp of the change to the game ex. 2022-09-25T23:00:45+00:00 |
Deleted Games
The deleted_games element is a sibling of changelog (not nested within it) and appears only when one or more games were removed from the schedule during the change log window. Each game entry lists a removed game by ID only.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | deleted_games - game | GUID | Unique ID of a game that was removed from the schedule ex. 056b4eb7-64ce-4858-bae7-f3701d8eb753 |
Player Profiles
A player appearing under profiles - players indicates that player's profile changed during the change log window.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | player | GUID | Unique ID of a player ex. fcfa9d4b-3e09-46ac-b4b6-77d70a5f304c |
full_name | player | String | Full name of a player ex. Marcus Johnson |
last_modified | player | dateTime | Timestamp of the change to the player ex. 2022-09-25T22:54:34+00:00 |
Team Profiles
A team appearing under profiles - teams indicates that team's profile changed during the change log window.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | team | GUID | Unique ID of a team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
alias | team | String | Team alias ex. MIN (Minnesota) |
market | team | String | Team market name ex. Minnesota |
name | team | String | Team name ex. Vikings |
sr_id | team | String | Unique Sportradar ID of a team ex. sr:competitor:4324 |
last_modified | team | dateTime | Timestamp of the change to the team ex. 2022-09-25T21:32:05+00:00 |