Update Frequencies and Content Refresh

Description

This article details the life cycle of SportsDataIO's data and when you can expect new data to be updated.

Subject

This article is also available at sportsdata.io.

SPORTS DATA

Standings

Standings are updated every 10-15 minutes. We recommend syncing standings every 10-15 minutes.

Teams, Stadiums, Coaches & Referees

Teams

Basic team information, such as name and home stadium/arena, does not change often, but we update it in real time whenever a change does take place. Accordingly, we recommend calling Team endpoints hourly or daily, depending on your application’s needs.

Stadiums & Arenas

Basic stadium information, such as name and capacity, does not change often, but we update it in real time whenever a change does take place. Accordingly, we recommend calling Stadium endpoints hourly or daily, depending on your application’s needs.

Coaches

Endpoints with coaches’ biographical data are updated throughout the season and off-season for each sport, to allow for new coaches and changes of information. Due to a relatively low number of changes, we recommend syncing the schedules daily or hourly, depending on your needs.

Referees

Endpoints with referee data are updated throughout the season and off-season for each sport, to allow for new refs/umps and changes of information. Due to a relatively low number of changes, we recommend syncing the schedules daily or hourly, depending on your needs.

Schedules & Game Day Information

For all sports, schedules are typically loaded within 24 hours of being released, and much quicker for the major leagues such as the NFL. After that, they are updated on a real-time basis.

We recommend syncing the schedules daily or hourly, depending on your needs. For certain soccer leagues, where kick-off times are likely to change in the weeks leading up to a game, hourly is better.

Scores, Box Scores & Game State

For all sports except PGA and NASCAR: scores & box scores are updated live as events progress.
Common update speeds are within 20-30 seconds of the cable & OTA broadcast, and 20-30 seconds ahead of the online streaming broadcast (although these numbers can vary).
PGA & NASCAR are the exceptions, where the coverage will typically be 10-15 minutes behind between the cable & OTA broadcasts.
For non-real-time data: we recommend syncing scores (for today & yesterday) every few minutes.
For real-time data: If you have a real-time API subscription with live scoring, you can sync scores & box scores every 3-5 seconds.
- Technically, you can sync more often than 3-5 seconds, but our API caches all content for a minimum of 3 seconds, so it will not give you better performance to sync more often than 3-5 seconds.

Play-By-Play

Play-by-play coverage begins with the coin toss (if applicable) or first play of the game, and is updated on a real-time basis thereafter.
Common update speeds are within 20-30 seconds of the cable & OTA broadcast, and 20-30 seconds ahead of the online streaming broadcast (although these numbers can vary).
For real-time data: If you have a real-time API subscription with live scoring, you can sync scores & box scores every 3-5 seconds.
- Technically, you can sync more often than 3-5 seconds, but our API caches all content for a minimum of 3 seconds, so it will not give you better performance to sync more often than 3-5 seconds.

Player & Team Stats

Individual team and player stats on an in-game basis are provided via Box Scores.
Player and team season aggregated stats are updated every 10-15 minutes for the Big Six sports (NFL, NBA, MLB, NHL, CFB, CBB.)
For other leagues, expect stats to be updated every 2-3 hours.
Aggregated season-long stats are not updated in-game, but are added to after a game has ended.

NFL

Snap Counts are available the morning after the game in question.
Advanced metrics are available the Wednesday following the week of games. A few advanced metrics will be added after Wednesday as they are tracked from the All-22 film and take a bit longer. Note that Week 1 Advanced Metrics may come in slightly later than Wednesday due to the busy nature of Week 1.

Rosters & Profiles

Rosters

Roster information is updated in real-time throughout the year for all applicable sports and should be synced every hour.

Profiles

Player profile information is updated in real-time throughout the year for all applicable sports and should be synced every hour.

Injuries

Injury information is updated in real-time throughout the year for all applicable sports and should be synced every 5 minutes, or less often if your application doesn’t require real-time information.

More Information: Process Guide - Injuries

Depth Charts

Depth chart information is updated in real-time throughout the year for all applicable sports and should be synced every 5 minutes, or less often if your application doesn’t require real-time information.

More Information: Process Guide - Depth Charts

BETTING DATA

Live Odds

We pull odds as quickly as possible from the applicable sportsbooks upon their release, with latency ranging from 5 seconds to 5 minutes, depending on the sport, time of year, time of day, and book in question.
Game odds are updated every few seconds, as sportsbooks can push updated odds at any time. We recommend syncing odds every 5-10 seconds, depending on your needs.

Pre Game Odds

We pull odds as quickly as possible from the applicable sportsbooks upon their release, with latency ranging from 5 seconds to 5 minutes, depending on the sport, time of year, time of day, and book in question.
Game odds are updated every few seconds, as sportsbooks can push updated odds at any time. We recommend syncing odds every 5-10 seconds, depending on your needs.

Props

We pull odds as quickly as possible from the applicable sportsbooks upon their release, with latency ranging from 5 seconds to 5 minutes, depending on the sport, time of year, time of day, and book in question.
Game odds are updated every few seconds, as sportsbooks can push updated odds at any time. We recommend syncing odds every 5-10 seconds, depending on your needs.

Futures

We pull odds as quickly as possible from the applicable sportsbooks upon their release, with latency ranging from 5 seconds to 5 minutes, depending on the sport, time of year, time of day, and book in question.
Game odds are updated every few seconds, as sportsbooks can push updated odds at any time. We recommend syncing odds every 5-10 seconds, depending on your needs.

Predictions

Predictions are updated when new inputs (e.g. player injuries, roster changes) come into play. We thus recommend syncing every 10 minutes.

Settlement & Verification

We recommend using our Box Scores endpoints for result verification.
We recommend calling these endpoints according to the values in the relevant endpoint, but as time is of the essence in bet settlement, calling at minimum intervals is recommended, so every 3-5 seconds.

Odds Resulting

We recommend using our Betting Metadata and Betting Results by Market endpoints.
We pull odds results as quickly as possible from the applicable sportsbooks upon their release, with latency ranging from 5 seconds to 5 minutes, depending on the sport, time of year, time of day, and book in question.
These should be called approximately every 15 minutes.

FANTASY DATA

Projections

Projected player stats are generated 7-10 days before game time, and they are updated every 10-15 minutes throughout the day. We recommend syncing projected stats as often as every 5 minutes.

Salaries & Slates

DFS Slate and Salary information is updated directly from the operators every 15-20 minutes.
We recommend syncing DFS information every 10-15 minutes.

NEWS & IMAGES

News

Our various news feeds are updated throughout the day, with updates coming much more frequently just prior to and during the season for the given sport.
We recommend syncing news feeds every 5-10 minutes around the clock.

Images

We have headshots for the leading sports, including the Big Four, college football, college basketball, PGA, and certain soccer leagues.
We recommend syncing headshots URLs every 24 hours. The headshots themselves are hosted on an AWS S3 Bucket, which can be hot-linked to, or developers can write a script to download the images and upload them to their destination of choice.
For action shots, please contact us.