Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

Daily Change Log

Utilize the NBA Daily Change Log feed to track daily changes to the API without depleting your call limits.

The Daily Change Log updates you on significant changes like schedule adjustments, game results, player updates (such as name or number changes), and team modifications.

⏱️

Update Frequency

TTL / Cache: 300 seconds

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

Daily Change Log Scenarios


Updates to Schedules

To use the Daily Change Log feed for monitoring changes to match schedules:

  1. Identify the Change Type: Updates to scheduling information are displayed using the schedule node.
  2. Pull Detailed Data: Use game IDs to retrieve specifics on the schedule update.
  3. Verify Changes: After pulling the detailed data from the relevant feeds, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.

Post Game Updates and Revisions

The table below outlines scenarios and use cases for utilizing the Daily Change Log for applications that offer live game updates. This log provides updates and stat revisions for recent games.

DataUse Case
Play-by-PlayTrack changes in play details such as new plays added or corrections to existing play records.
Game SummaryMonitor updates in player and team statistics or post-game corrections.
Game BoxscoreMonitor adjustments in game summary data, including final scores or statistical errors being rectified.

To use the Daily Change Log feed for monitoring changes to recent games:

  1. Identify Change Types: First, review the Daily Change Log to identify the types of changes reported. These could be related to games, players, or teams. Each entry in the log will list relevant IDs (game, player, or team ID), depending on the type of change.

  2. Use IDs to Retrieve Specifics:

    • Game Changes: If the ID is found within the "results" node, it typically indicates a change in game results. This ID is a game ID.
    • Player and Team Changes: Similarly, IDs associated with players or teams indicate changes relevant to these entities, such as updates to player information or team rosters.
  3. Pull Detailed Data: Use the identified IDs to pull detailed information from the relevant feed. For example:

    • Play-by-Play Feed: If a game ID is mentioned, you can pull this feed to check for any new plays added or modifications to existing plays.
    • Game Statistics Feed: Use the game ID to retrieve updated player statistics and team performance metrics to see what specific data was altered.
    • Game Boxscore Feed: Pull this feed using the game ID to review any updates to the game summary, including scores and other significant game statistics.
  4. Verify Changes: After pulling the detailed data from the relevant feeds, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.



Changes to Standings and Rankings

The Daily Change Log can be a helpful tool for tracking potential adjustments to standings and rankings within the NBA (though rare). For example, if a game statistic is revised due to a correction or a late reporting of results, the change log will include an entry for the update in its results node.

Steps:

  1. Identify Change Type: When you encounter an ID within the results node, it signifies that some data associated with the game has been updated. This doesn't necessarily mean the final score has changed, but rather that various game-related details have been modified.

  2. Pull Detailed Data: Use the game IDs to pull information from the Postgame Standings and Rankings feeds.

  3. Verify Changes: After pulling the detailed data from the Postgame Standings and Rankings feeds, compare the newly retrieved data against previously stored data to verify changes to the standings and update your records accordingly.

Note: While standings and rankings data typically remains stable once games are concluded and results are recorded, rare changes can still occur, such as adjustments following a review of play outcomes or corrections of data errors. You can continue monitoring the Daily Change Log to catch any updates that could impact standings, even though such adjustments are infrequent.



Roster Updates

The table below outlines scenarios and use cases for utilizing the Daily Change Log based on team roster and player updates.

Steps to monitor roster updates:

  1. Identify Change Types: First, review the Daily Change Log to identify the types of changes reported. These could be related to games, players, or teams. Each entry in the log will list relevant IDs (game, player, or team ID), depending on the type of change.

  2. Use IDs to Retrieve Specifics: IDs associated with players or teams indicate changes relevant to these entities, such as updates to team rosters.

  3. Pull Detailed Data: Use the identified IDs to pull detailed information from the Team Profile feed.

  4. Verify Changes: After pulling the data, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.



Revisions to Seasonal Statistics and Splits

The Daily Change Log is useful for monitoring adjustments to NBA seasonal statistics and splits. For instance, if a game statistic that affects seasonal totals and splits is corrected, the log will record this update in its results node.

Steps:

  1. Identify Change Type: Spot any game IDs within the results node to signify changes in game-related data or statistics.
  2. Retrieve Detailed Data: Use the identified game IDs to pull additional details from relevant feeds such as Game Summary, Play-by-Play, or Game Boxscore, is recommended for its direct impact on seasonal statistics and splits.
  3. Access Seasonal Statistics or Splits Feeds: Use the team ID from the detailed data to retrieve information from the seasonal statistics feed or one of the available split feeds.
  4. Verify Changes: Compare the newly retrieved data with previously stored records to confirm changes in statistics. Use the player ID to access the Player Profile feed for deeper analysis of player-specific updates.