NFL Coverage
Here is a summary of SportsDataIO's extensive NFL coverage. Read on to learn about the vast number of feeds we offer and don't hesitate to contact us if you have any questions.
See a summary of coverage across all leagues here: SportsDataIO coverage matrix (PDF)
Competition Feeds
Standings, Rankings & Brackets
Standings records for the league, conference and division, including both regular season and playoffs.
- Standings records for the league and each division include Wins/Losses, Winning %, Winning Streak, etc.
- Additional splits include Points For, Points Against, Net Points and Conference/Division Rank.
Teams, Players & Rosters
Roster of active players and coaches for each team plus profile info about each team and player.
- Team and Coaches includes active lists and profile information such as as name, conference/division, team colors (hexadecimal format) and home stadium.
- Player Profile details include data fields such as name, height/weight, home town, college, pro debut, and experience.
Endpoint
Return Type
Call Interval
Team[]
4 Hours
Full team information: team name and city, conference and division, colors, coaching and scheme info. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns the teams currently active in the league.
Team[]
4 Hours
Full team information: team name and city, conference and division, colors, coaching and scheme info. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns all teams regardless of current active status.
Team[]
4 Hours
Full team information: team name and city, conference and division, colors, coaching and scheme info. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns the active teams for a given season.
TeamBasic[]
5 Minutes
The most basic top-line team information, such as team name and city, conference and division, stadium ID, coach info, and team colors. Returns all teams regardless of current active status.
PlayerBasic[]
15 Minutes
Roster information for a given team. Player profiles include basic biographical information, position, college, and current team (if attached to a team.) Specify a team tricode parameter to receive all players currently on that team.
PlayerBasic[]
15 Minutes
Player profiles include basic biographical information, position, college, and current team (if attached to a team.) This returns all players.
PlayerBasic[]
15 Minutes
Player profiles include basic biographical information, position, college, and current team (if attached to a team.) This returns all free agents not currently attached to a team.
PlayerBasic[]
1 Minute
Player profiles include basic biographical information, position, college, and current team (if attached to a team.) Specify a year parameter to receive all player profiles from that rookie draft year.
Developer Section
Venues & Officials
List of all active stadiums (home and neutral) plus officiating crews.
- Stadium profiles include things like name, location, lat/long coordinates, altitude, seating capacity, playing surface & type (outdoor, dome, retractable dome).
- Officials info includes things like Referee Name, Experience, Number, and Position.
- The NFL announces referees at approximately 2:00 pm ET on the Tuesday leading up to the upcoming week.
Endpoint
Return Type
Call Interval
GET
Referees
Referee[]
1 Hour
Returns referees with name, numbers, position (e.g. FJ for Field Judge), college, and years of experience.
Developer Section
Utility Endpoints
Utility Endpoints are activated for all customers to allow them to build the back-end connections needed for their relational database and be informed about relevant information throughout the season.
- Timeframe utility endpoints include things like current and previous season, current and previous week, etc.
- Status utility endpoints include things like if games are currently in progress or not.
- Sports betting utility endpoints includes things like sportsbook IDs, betting market type IDs, etc.
Endpoint
Return Type
Call Interval
Sportsbook[]
1 Hour
Returns a list for mapping SportsbookID to the Sportsbook name.
GET
Betting Metadata
BettingEntityMetadataCollection
15 Minutes
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
GET
Season - Current
integer?
5 Minutes
Year of the current NFL season. This value changes at the start of the new NFL league year. NFL seasons run across two calendar years; the league year is the one in which it starts, not ends (that is, a season starting in 2023 and ending in 2024 will have the league year of 2023.)
integer?
5 Minutes
Year of the most recently completed NFL season. This value changes immediately after the Super Bowl. NFL seasons run across two calendar years; the league year is the one in which it starts, not ends (that is, a season starting in 2023 and ending in 2024 will have the league year of 2023.)
integer?
5 Minutes
Year of the current NFL season, if we are in the mid-season. If we are in the off-season, then year of the next upcoming season. This value changes immediately after the Super Bowl. NFL seasons run across two calendar years; the league year is the one in which it starts, not ends (that is, a season starting in 2023 and ending in 2024 will have the league year of 2023.)
GET
Timeframes
Timeframe[]
3 Minutes
Timeframes for the NFL refer to current weeks, season status etc.
GET
Week - Current
integer?
5 Minutes
Number of the current week of the NFL season. This value usually changes on Tuesday nights or Wednesday mornings at midnight ET but in the rare case of a rescheduled or overseas game with a non-standard gameday this could change.
integer?
5 Minutes
Number of the last completed week of the NFL season. This value usually changes on Tuesday nights or Wednesday mornings at midnight ET but in the rare case of a rescheduled or overseas game with a non-standard gameday this could change.
GET
Week - Upcoming
integer?
5 Minutes
Number of the next upcoming week of the NFL season. This value usually changes on Tuesday nights or Wednesday mornings at midnight ET but in the rare case of a rescheduled or overseas game with a non-standard gameday this could change.
boolean
5 Seconds
Returns
true if there is at least one game being played at the time of the request or false if there are none.
Developer Section
Event Feeds
Schedules & Game Day Info
Schedules are updated when initially released by the organizers and kept up-to-date throughout the year in case of changes.
- Schedule records includes teams, date & time and status: Scheduled, InProgress, Final, Suspended, Delayed, Postponed, Canceled.
- Game day info includes things like game status, VenueID, kick off time, TV Channel, 10 day weather forecast, teams playing.
Endpoint
Return Type
Call Interval
GET
Schedules
Schedule[]
3 Minutes
Home and away teams, date and time, season type and week etc. are included. Also includes gameday information. This includes full stadium information (capacity, lat/long, surface etc.), top-line betting information (spread, moneyline, total), weather conditions, and broadcast information.
ScheduleBasic[]
3 Minutes
A lightweight schedule endpoint without gameday information. Home and away teams, the date and time of the game, and season type, week etc. are included. Ideal for the most basic information required to build a schedule.
Developer Section
Scores & Game State
Scores and Game State are updated live during all games, along with the final score being provided after the game is completed and verified.
- Score includes the score for every quarter plus the final score for both teams.
- Game State includes things like Score, Quarter, Time Remaining, Possession, Down, Distance, Yard Line, Red Zone info and more.
Final Only (No Game State)
- Scores delivered as "Final Only" will deliver the final quarter scores and final scores of both teams once the game is completed and verified.
- Game State is only available through live in-game updates, and therefore is not included for customers only taking "Final Only" delivery.
Endpoint
Return Type
Call Interval
Score[]
1 Minute
Full scores and gameday info, including weather, referee, infotainment odds, as well as all of the quarter scores and full-time score.
ScoreBasic[]
1 Minute
A slimmed-down score endpoint, giving just the quarter scores and final score, for simple applications.
Score[]
1 Minute
Full scores and gameday info, including weather, referee, infotainment odds, as well as all of the quarter scores and full-time score.
Score[]
5 Minutes
Full scores and gameday info, including weather, referee, infotainment odds, as well as all of the quarter scores and full-time score.
Developer Section
Live & Final (With Game State)
- Scores delivered as "Live & Final" includes live updates throughout the game, plus a final score of the game once it is completed and verified.
- Game State delivered as "Live & Final" includes live game state info throughout the game, updated alongside the live score updates.
- Game State includes things like Score, Quarter, Time Remaining, Possession, Down and Distance, Yard Line, and Red Zone info.
Endpoint
Return Type
Call Interval
ScoreBasic[]
5 Seconds
This endpoint simply delivers the game clock and quarter and total scores live; no down and distance and no gameday info such as weather.
Score[]
5 Minutes
Full scores and gameday info delivered live and post-game. Live data includes down and distance, as well as game clock. Gameday info includes referee, weather, TV channel etc.
Score[]
5 Seconds
Full scores and gameday info delivered live and post-game. Live data includes down and distance, as well as game clock. Gameday info includes referee, weather, TV channel etc.
Score[]
5 Seconds
Full scores and gameday info delivered live and post-game. Live data includes down and distance, as well as game clock. Gameday info includes referee, weather, TV channel etc.
Developer Section
Team & Player Stats
Team and Player Stats are managed on a game by game basis as well as season long totals. Stats are updated in season for every game, along with detailed Box Score level information for each particular game.
- See our TeamGame and TeamSeason Data Dictionary tables for a full list of available Team Stats.
- See our PlayerGame and PlayerSeason Data Dictionary tables for a full list of available Player Stats.
Final Only
- Team & Player Stats delivered as "Final Only" include a final box score of all team and player stats once it is completed and verified.
- Team & Player Season Stats delivered as "Final" once games are completed and verified.
Endpoint
Return Type
Call Interval
PlayerGameRedZone[]
15 Minutes
Delivers all offensive stats within the 5-yard line of the defensive team for all players in a given season or week.
PlayerGameRedZone[]
15 Minutes
Delivers all offensive stats within the 10-yard line of the defensive team for all players in a given season or week.
PlayerSeasonRedZone[]
15 Minutes
Delivers all offensive stats within the 5-yard line of the defensive team for all players in a given season (i.e. the season total, not each individual game record.)
PlayerSeasonRedZone[]
15 Minutes
Delivers all offensive stats within the 10-yard line of the defensive team for all players in a given season (i.e. the season total, not each individual game record.)
PlayerGame[]
1 Hour
Specify a season, a player, and number of games (either an integer or
all) to see all of their box score logs. Refreshed after their most recent game is complete.
TeamGame[]
1 Hour
Specify a season, a player, and number of games (either an integer or
all) to see all of their box score logs. Refreshed after their most recent game is complete.
TeamSeason[]
5 Minutes
Returns all season-long stats (i.e. the season total, not each individual game record) for all teams (aggregated from all players) for a given season.
PlayerGameRedZone[]
15 Minutes
Delivers all offensive stats within the red zone (within the 20-yard line of the defensive team) for all players in a given season or week.
PlayerSeasonRedZone[]
15 Minutes
Delivers all offensive stats within the red zone (within the 20-yard line of the defensive team) for all players in a given season (i.e. the season total, not each individual game record.)
PlayerSeason[]
15 Minutes
Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season.
PlayerSeason[]
15 Minutes
Returns all season-long stats (i.e. the season total, not each individual game record) for a given team's players in a given season.
PlayerSeasonThirdDown[]
15 Minutes
Returns all season-long stats (i.e. the season total, not each individual game record) for all players on the third down for a given season.
BoxScoreV3
1 Minute
Full statistical information for a specified game, down to the team and player stat level, delivered after the game is complete.
BoxScoreV3[]
1 Minute
Full statistical information for a specified game week for each game that took place, down to the team and player stat level, delivered after the game is complete.
PlayerGame[]
5 Minutes
Returns the box score statistical record for all involved players in a given team's game in a given week after the game has concluded.
PlayerGame[]
5 Minutes
Returns the box score statistical record for all involved players across all teams' games in a given week after the game has concluded.
TeamGame[]
5 Minutes
Returns the box score statistical record team-wide (aggregated from all players) for a given team's game in a given week after the game has concluded.
BoxScoreV3
1 Minute
Full statistical information for a given team's game in a specified season and week, down to the team and player stat level, delivered after the game is complete.
Developer Section
Live & Final
- Team & Player Game Stats delivered as "Live & Final" include live updates throughout the game, plus a final box score of all team and player stats once it is completed and verified.
- Team & Player Season Stats delivered as "Final" once games are completed and verified.
Endpoint
Return Type
Call Interval
BoxScoreV3
1 Minute
Full statistical information for a specified game, down to the team and player stat level, delivered live during the game, called per individual game.
BoxScoreV3
1 Minute
Full statistical information for a specified game, down to the team and player stat level, delivered live during the game, called for a given team's game in a given week and season.
BoxScoreV3[]
3 Seconds
This method returns all box scores for a given season and week, but only returns player stats that have changed in the last X minutes as specified in your API call. You can also filter by type of player stats to include, such as traditional fantasy players, IDP players or all players. by definition this is a live endpoint, not final.
PlayerGame[]
5 Minutes
Returns the box score statistical record for all involved players across a given team's game in a given week, updated live as the game takes place.
PlayerGame[]
5 Minutes
Returns the box score statistical record for all involved players across a given week, updated live as the game takes place.
PlayerGame[]
5 Seconds
This method returns all player scores for a given season and week, but only returns player stats that have changed in the last X minutes as specified in your API call. Ideal for live applications.
PlayerGame[]
5 Seconds
This method returns all player game stats, but only returns player stats that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
TeamGame[]
5 Minutes
Returns the box score statistical record team-wide (aggregated from all players) for a given team's game in a given week, during the game and with final stats after it ends.
Developer Section
Play by Play
Play by Play feeds includes a description of every play that is made throughout the game, players involved, and the result.
- Coverage includes a breakdown of every play including a description of the play, the players that were involved, the stats earned by involved players on the play, the result of the play and starting/ending Game State info (e.g. Down & Distance at start and end of the play).
Final Only
- Play by Play Feeds delivered as "Final Only" include a final box score of all team and player stats once it is completed and verified.
Endpoint
Return Type
Call Interval
PlayByPlay
1 Minute
Each invididual play, its type and outcome, complete with player and team stats down to the play level, delivered final (after the game ends), called by team.
PlayByPlay
1 Minute
Each invididual play, its type and outcome, complete with player and team stats down to the play level, delivered final (after the game ends), called by team.
Developer Section
Live & Final
- Play by Play Feeds delivered as "Live & Final" include live updates throughout the game, plus a final list of all plays once the game is completed and verified.
Endpoint
Return Type
Call Interval
PlayByPlay
1 Minute
Each invididual play, its type and outcome, complete with player and team stats down to the play level, delivered live in real-time, called by game.
PlayByPlay
1 Minute
Each invididual play, its type and outcome, complete with player and team stats down to the play level, delivered live in real-time, called by team.
PlayByPlay[]
3 Seconds
This method returns all play-by-plays for a given season and week, but only returnsplays that have changed in the last X minutes as specified in your API call. by definition this is a live endpoint, not final.
Developer Section
Player Feeds
Depth Charts, Lineups & Injuries
NFL Depth Charts and Player Injuries are tracked daily beginning in the Preseason through the duration of the Regular Season, Playoffs, and Super Bowl. Depth Charts and Player Injuries include things like Depth Chart Position, Depth Chart Order, injury status, injured body part, and others.
Depth Charts, Lineups & Injuries
Endpoint
Return Type
Call Interval
GET
Injuries - All
Injury[]
5 Minutes
A list of all injured players and a description of their injuries.
Injury[]
5 Minutes
A list of all injured players on a specified team and a description of their injuries.
Player[]
1 Hour
Full player bio and details, including injury notes, for all NFL players in our database.
Player[]
1 Hour
Full player bio and details, including injury notes, for all available NFL free agents unattached to a team.
PlayerDetail[]
1 Hour
Full player bio and details, including injury notes, for all available NFL players by team.
Player[]
1 Minute
Full player bio and details, including injury notes, for all available NFL players by a specified draft year.
Player[]
1 Minute
This endpoint provides all currently injured NFL players, along with injury details.
TeamDepthChart[]
5 Minutes
Depth charts for all active players NFL teams split by offensive, defensive, and special teams position groupings.
Transaction[]
1 Minute
Includes a list of transactions for a given date, with type (e.g. trade, injury listing, assignment) and a brief note.
TeamDepthChart[]
5 Minutes
Depth charts for all players in all NFL teams split by offensive, defensive, and special teams position groupings.
Developer Section
Betting Feeds
Game Lines
Game lines (spread, moneyline, totals) available as both pre-match and in-play, including timestamps for opening price, all line movement changes, and closing price, with optional resulting available as an add-on.
- Odds are made available when sportsbooks publish opening lines, typically starting Tuesday of each game week.
- Includes full-game odds markets plus partial game lines such as halves and quarters.
- Additional SportsDataIO Consensus Line" also available as an aggregate of all currently available market prices
Pre-Game Lines
- Includes full-game odds markets plus partial game lines such as halves and quarters.
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Does not include resulting of game line markets.
Endpoint
Return Type
Call Interval
GameInfo[]
1 Minute
Returns the non-full-game odds (spread, moneyline, total) for games in a given week and season. Non-full-game means 1st-half or 1st-quarter, for example, rather than full game. Only returns the most recently seen odds, not inclusive of line movement.
GameInfo[]
30 Seconds
Returns the full-game core odds for games in a given week & season. This means moneyline, spread, and total. Only returns the most recently seen odds, not-including line movement.
GameInfo[]
30 Seconds
Returns the full-game and non-full-game odds (spread, moneyline, total) for games in a given week and season. Only returns the most recently seen odds, not inclusive of line movement. A Sportsbook Group must be specified as a URL parameter.
Developer Section
Pre-Game Lines Plus
- Includes full-game odds markets plus partial game lines such as halves and quarters.
- Includes all line movement for pre game odds markets
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Pre-game full game odds and partial game odds results are available 5-10 minutes following the conclusion of each game once all stats are verified.
- See our Aggregated Odds resulting guide for more.
Endpoint
Return Type
Call Interval
GameInfo[]
15 Minutes
Returns the non-full-game odds (spread, moneyline, total) for games in a given week and season. Non-full-game means 1st-half or 1st-quarter, for example, rather than full game. Only returns the most recently seen odds, not inclusive of line movement.
GameInfo[]
15 Minutes
Returns the full-game core odds for a given ScoreID. This means moneyline, spread, and total. Only returns the most recently seen odds, not-including line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfoResult[]
15 Minutes
Returns the game odds ( for games in a given week and season. In this endpoint both full-game and partial-game odds are included.
This also includes Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
A Sportsbook Group must be specified as a URL parameter.
This also includes Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
A Sportsbook Group must be specified as a URL parameter.
GameInfo[]
15 Minutes
Returns the game odds (for games in a given week and season. In this endpoint both full-game and partial-game odds are included. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
Developer Section
In-Play Lines
- In-play betting markets, including spread, moneyline, and totals are available immediately following the start of each game as the sportsbooks make them available.
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Does not include resulting of game line markets.
Endpoint
Return Type
Call Interval
GameInfo[]
5 Seconds
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress. A Sportsbook Group must be specified as a URL parameter.
GameInfo[]
5 Seconds
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
Developer Section
In-Play Lines Plus
- In-play betting markets, including spread, moneyline, and totals are available immediately following the start of each game as the sportsbooks make them available.
- Includes all line movement for In-play betting markets
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- In-play game odds results are available 5-10 minutes following the conclusion of each game once all stats are verified.
Endpoint
Return Type
Call Interval
GameInfoResult[]
15 Minutes
Provides in-play odds line movement data for a given game. This means odds for games which are in-progress. Serves full line movement and is intended for showing the trend over a game rather than the most up-to-the second lines.
GameInfo[]
15 Minutes
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
GameInfo[]
15 Minutes
Returns in-play game odds (spread, moneyline, total) for games in a given week and season. Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Developer Section
Props
Includes Player, Game, and Team Props available as both pre-match including timestamps for opening price, all line movement changes, and closing price, with optional resulting available as an add-on.
- Odds are made available when sportsbooks publish opening lines, typically the Tuesday of the week of upcoming games.
Props
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
- Does not include resulting of prop markets.
Endpoint
Return Type
Call Interval
BettingMarket[]
10 Minutes
Returns the markets and available outcomes for a given BettingEventID. A Sportsbook Group must be specified as a URL parameter.
BettingMarket[]
10 Minutes
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID. A Sportsbook Group must be specified as a URL parameter.
BettingMarket[]
1 Minute
Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint. A Sportsbook Group must be specified as a URL parameter.
BettingMarket[]
1 Minute
This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint. A Sportsbook Group must be specified as a URL parameter.
BettingEvent[]
5 Minutes
The list of current BettingEvents for the given date, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
BettingEvent[]
1 Hour
The list of current BettingEvents for the given season, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
BettingMarket[]
10 Minutes
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given BettingEventID.
BettingMarket[]
1 Minute
Returns Markets and available outcomes for a given event and market type requested. A lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
BettingMarket[]
10 Minutes
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID.
BettingMarket[]
1 Minute
This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint.
Developer Section
Props Plus
- See our NFL integration guide for all available Props odds markets with resulting.
- Pre-game props results are available 10-15 minutes following the conclusion of each game once all stats are verified.
- Line movement is available for all Prop betting markets
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
Endpoint
Return Type
Call Interval
GET
Betting Market
BettingMarket
15 Minutes
Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines.
BettingMarketResult
15 Minutes
Provide a market ID that supports resulting (i.e. has a ResultType) and this endpoint will return a result: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
BettingMarket
15 Minutes
Returns full line movement for a given BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and not for the most up-to-the-second lines.
A Sportsbook Group must be specified as a URL parameter.
A Sportsbook Group must be specified as a URL parameter.
BettingMarketResult
15 Minutes
Provide a market ID that supports resulting (i.e. has a ResultType) and this endpoint will return a result: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. A Sportsbook Group must be specified as a URL parameter.
Developer Section
Futures
Team, Player, and Season futures such as win totals, MVP, Superbowl Winner and many others are available are available at the start of each season and include timestamps for opening price, all line movement changes, and closing price, with new markets added as the season progresses.
- Odds are made available when sportsbooks publish opening lines, typically starting in the off season after schedules are released all the way through the conclusion of the Superbowl and into the NFL Draft.
- Odds markets are available from 20+ sports books including a consensus line for each type of odds market.
Endpoint
Return Type
Call Interval
BettingEvent[]
1 Hour
Returns available Futures markets for the given season. Does not include line movement. A Sportsbook Group must be specified as a URL parameter.
BettingEvent[]
1 Hour
Returns available Futures markets for the given season. Does not include line movement.
Developer Section
Matchups, Trends & Splits
Betting Splits provide the percentage of bets placed on either side of the line and the percentage of the money wagered on either side of the line. Matchups and Trends leverage our vast historical database to calculate all the traditional information found on a betting match up page.
- Matchups, Trends & Splits are generated and updated on a daily basis.
Matchup Stats
- We provide betting trends by matchup between two teams, showing historical and recent results for the teams in question, including standings, split standings, and other trends.
- Include team trends from the last 3/5/10 games - wins/loss/ties, history against the spread, average score, and opponent score.
Endpoint
Return Type
Call Interval
MatchupTrends
15 Minutes
Returns trends data for a given pairing of teams. Will return data even if the teams are not set to play this season. Intended for use on a specific game, though it will work for other comparisons if applicable.
TeamTrends
15 Minutes
Describes recent team trends and performance against betting data in recent sets of games.
Developer Section
Betting Splits
- Pre-Match betting splits are available for Money Line, Spread, and Total for all available games where data is published.
- Betting Splits are a representation of bets and dollars made on published lines, this data typically becomes available after the lines have been published and wagers have been made and the wager information has been collected.
Endpoint
Return Type
Call Interval
BettingMarketSplit
15 Minutes
List of Money and Bet Percentage splits for each outcome type available in this market. This specific endpoint will return the movement from this market as well as the most recent.
GameBettingSplit
15 Minutes
List of Money and Bet Percentage splits for each market and their respective outcome types available in this game. This specific endpoint will return current splits for each available market and no line movement.
Developer Section
Fantasy Feeds
Projections
SportsDataIO's proprietary predictive models generate fantasy projections for all players across the league, and our Fantasy Scoring Engine calculates live and final fantasy points for many different scoring systems.
- SportsDataIO Supports 2 different projection models (BAKER and Legacy). Each of these projection models take different methods to derive static and fantasy based projections.
- Includes season long and individual game projections.
Legacy Projections
- Legacy Projections leverage Machine Learning (No Simulations): A data-driven model using historical match ups and statistics to feed machine learning that predicts the average outcome for a game, team, or player.
- Includes season long and individual game projections.
- On the day of games, NFL projections for players are customized specifically to that week's game by 2 pm EST each game week and will be updated every 15 minutes until kick off.
- Season-long projections are available around the middle to end of June, after OTA's.
Endpoint
Return Type
Call Interval
FantasyDefenseGameProjection[]
5 Minutes
SportsDataIO's proprietary projections, including DFS salary information, for all fantasy defense teams. Called by season and week. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
FantasyDefenseSeasonProjection[]
5 Minutes
SportsDataIO's proprietary projections, including average draft position, for all fantasy defense teams for the season. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
PlayerGameProjection[]
5 Minutes
SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, for a given game, called by team.
PlayerGameProjection[]
5 Minutes
SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by week.
PlayerSeasonProjection[]
5 Minutes
SportsDataIO's proprietary projections on a season-long basis, including Average Draft Position (ADP), for fantasy players, for a given season.
PlayerSeasonProjection[]
5 Minutes
SportsDataIO's proprietary projections on a season-long basis, including ADP, for fantasy players, for a given season and team.
Developer Section
IDP Projections
- Individual Defensive Player projection include things such as projected defensive statistics aligned with the Box Score results for defensive players in the NFL.
- IDP season-long projections become available each June for the upcoming season.
- IDP game projections become available on Tuesday's before each week's games and are updated throughout the week as news occurs.
Endpoint
Return Type
Call Interval
PlayerGameProjection[]
5 Minutes
Individual Defensive Player (IDP stats, including DFS salary information and injuries, for fantasy players, called by team.
PlayerGameProjection[]
5 Minutes
Individual Defensive Player (IDP stats, including DFS salary information and injuries, for fantasy players, called by week.
Developer Section
Ownership Projections
- Include daily fantasy roster share and ownership percentages aligned to slate contests published by operators.
- The initial projections are published about 48 hours prior to the start of games on Sunday.
- Ownership projections are updated hourly and include a "last update" field so you'll be able to see when the values have changed.
Endpoint
Return Type
Call Interval
DfsSlateWithOwnershipProjection
15 Minutes
Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
DfsSlateWithOwnershipProjection[]
15 Minutes
Returns DFS Slates which have not yet started for which we have DFS Ownership projections.
PlayerOwnership[]
1 Hour
Projected fantasy ownership of all players for a given season.
Developer Section
Salaries, Stats & Points
Daily Fantasy Sports Salary information include the published salary values for all players within a given DFS slate contest that is published by the operators. Fantasy point calculations include total fantasy points per player with a statistical breakdown as it compared to the Box Score player stats results.
- DFS operators include - FanDuel, DraftKings, and Yahoo.
Salaries & Slates
- Contest Slates includes the contest slate published by the operator, which Game ID(s) are available for this contest slate and the Player ID(s) that are eligible to participate. Includes additional information such as number of roster slots, salary cap (if applicable), number of games included, if it's multi-day or not, etc.
- DFS Salaries & Slates become available once we receive them from the various DFS operators.
Endpoint
Return Type
Call Interval
DfsSlate[]
15 Minutes
Returns DFS slates, including eligible games, positions, captain mode, players and salaries, for a given date.
DfsSlate[]
15 Minutes
Returns DFS slates, including eligible games, positions, captain mode, players and salaries, for a given week.
Developer Section
Points & Stats
- Include fantasy point calculations which can be tracked in real time or post game during the season for select sports.
- See our proprietary scoring model for SportsDataIO's NFL fantasy points calculation.
Endpoint
Return Type
Call Interval
FantasyDefenseGame[]
5 Minutes
Returns stats and fantasy points for a given game for the fantasy defense team (not IDP.)
FantasyDefenseGame
5 Minutes
Returns stats and fantasy points for a given team's game for the fantasy defense team (not IDP.)
FantasyDefenseSeason[]
15 Minutes
Returns stats and fantasy points for a given season for the fantasy defense team (not IDP.)
FantasyDefenseSeason
15 Minutes
Returns stats and fantasy points for a given team and season for the fantasy defense team (not IDP.)
FantasyGame[]
5 Minutes
Returns a simple list of fantasy points and stats for each player for a given week.
Developer Section
News & Images
Player News & Notes
Player News & Notes provides short-form blurbs about relevant player news throughout the league, updated both in-season and during the off-season, provided by RotoBaller.
- News Blurbs contain approximately 200 words, and no image.
Rotoballer News
- Tags for each story may include: Top Headlines, Breaking News, Injury, Sit/Start, Waiver Wire, Risers, Fallers, Lineups, Transactions, Free Agents, Prospects/Rookies, Game Recap, Matchup Outlook.
- News data can be called at the player or team level, for generic league level news see our previews, recaps, and breaking news data source.
- Premium News is provided by Rotoballer and provide all the latest stories.
- News endpoints are also provided by Rotoballer. These offer just 0-1 stories per day during active news cycles, ideal for testing.
Endpoint
Return Type
Call Interval
GET
Premium News
News[]
3 Minutes
RotoBaller's Premium News feed, with the latest updated stories in greater detail.
News[]
3 Minutes
RotoBaller's Premium News feed, with the latest updated stories in greater detail called by date.
News[]
3 Minutes
RotoBaller's Premium News feed, with the latest updated stories in greater detail called by team.
Developer Section
Previews, Recaps & Breaking News
SportsDataIO provides bespoke news feeds and a variety of levels of news coverage to fit your specific needs:
- Editorial Wire Service: This includes more than 30,000 long-form content pieces in total across all leagues (previews, recaps, breaking news) with an associated image attached to each article. Please contact us to learn more about how we can connect you with news wire articles.
- Custom News: For bespoke articles created to fit your project, please contact us.
- AI-generated news: For procedurally-generated news based on data inputs, please contact us.
Player Headshots
Headshots are officially licensed in partnership with multiple licensed image providers and are updated leading up to the start of each season to capture new players and rookies being added as those images become available.
- All of our headshots are cropped 1200x1200 pixels with 300 resolution.
- Headshots are the property of the photographers that take them and the publishers that make them available, and as such we work with major providers to ensure that we have the best in licensed headshots.