College Football API Documentation
This is the documentation for our College Football API. To get a more comprehensive understanding of what feeds we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:
All of our API endpoints can be accessed via an HTTP GET request using your API key.
The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}
Competition Feeds
Standings, Rankings & Brackets
Available Endpoints
Subfeed
Standings, Rankings & Brackets
Returns all conference information, including season records and rankings for each team, along with logos and stadium information.
Conference Hierarchy
Returns all conference information, including season records and rankings for each team, along with logos and stadium information.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Teams, Players & Rosters
Available Endpoints
Subfeed
Teams, Players & Rosters
Full player bio and details, including injury notes, for all active players.
Teams, Players & Rosters
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.
Teams, Players & Rosters
Returns full team information: name, school, city, conference, and colors. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns all teams regardless of current status (active or inactive).
Teams, Players & Rosters
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.
Player Details - by Active
Full player bio and details, including injury notes, for all active players.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Player Profiles - by Team
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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
team
string
true
The abbreviation of the requested team.
Examples:
Examples:
SF, NYY.Team Profiles - All
Returns full team information: name, school, city, conference, and colors. Also contains basic fantasy info such as IDs as well as full stadium data. This endpoint returns all teams regardless of current status (active or inactive).
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Teams (Basic) - All
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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Venues & Officials
Stadiums
Returns all stadiums with capacity, address, latitude/longitude, city, state, and country.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Utility Endpoints
Available Endpoints
Subfeed
Utility Endpoints
Returns
true if there is at least one game being played at the time of the request or false if there are none.
GET
Betting Metadata
Utility Endpoints
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
Utility Endpoints
Returns the calendar year of the current season. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
Utility Endpoints
Returns the current season year, its start and end years, season type, week, etc.
Utility Endpoints
Returns the current type of season (e.g. REG, POST for regular or playoff).
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.
GET
Week Current
Utility Endpoints
Returns the current week number. This value usually changes on Saturday into Sunday overnight, but in the rare case of a rescheduled or special game with a non-standard gameday this could change.
Are Games In Progress
Returns
true if there is at least one game being played at the time of the request or false if there are none.Endpoint Notes
Call Interval:
5 Seconds
Return Type:
boolean
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Betting Metadata
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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEntityMetadataCollection
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Season Current
Returns the calendar year of the current season. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Season Current - Details
Returns the current season year, its start and end years, season type, week, etc.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Season Type - Current
Returns the current type of season (e.g. REG, POST for regular or playoff).
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
string
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Sportsbooks - by Active
Returns a list of all available sportsbooks with their associated unique IDs.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Week Current
Returns the current week number. This value usually changes on Saturday into Sunday overnight, but in the rare case of a rescheduled or special game with a non-standard gameday this could change.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer?
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Event Feeds
Schedules & Game Day Info
Available Endpoints
Subfeed
GET
Schedules
Schedules & Game Day Info
Returns game details including home and away teams, date and time, season type, week, and gameday info. Also includes full stadium information (capacity, location, surface) and top-line betting info (spread, moneyline, total).
Schedules & Game Day Info
Returns a lightweight schedule with home and away teams, game date and time, season type, and week. Does not include gameday details.
Schedules
Returns game details including home and away teams, date and time, season type, week, and gameday info. Also includes full stadium information (capacity, location, surface) and top-line betting info (spread, moneyline, total).
Endpoint Notes
Ideal For:
Populating calendar views, retrieving GameID’s to link to other feeds, and getting static game metadata
Not Ideal For:
Live scores and game status updates. Use Games - by Week instead.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season (with optional season type).
Examples:
Examples:
2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.Schedules (Basic)
Returns a lightweight schedule with home and away teams, game date and time, season type, and week. Does not include gameday details.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season (with optional season type).
Examples:
Examples:
2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.Scores & Game State
Available Endpoints
Subfeed
Final Only (No Game State)
Full scores and gameday info as well as all of the quarter scores and full-time score, delivered as the game ends.
Final Only (No Game State)
A slimmed-down score endpoint, giving just the quarter scores and final score, for simple applications, delivered as the game ends, called by week.
Final Only (No Game State)
A slimmed-down score endpoint, giving just the quarter scores and final score, for simple applications, delivered as the game ends, called by date.
Final Only (No Game State)
Full scores and gameday info as well as all of the quarter scores and full-time score as the game ends.
Live & Final (With Game State)
Full scores and gameday info delivered live and post-game for a given date. Live data includes down and distance, as well as game clock. Gameday info includes TV channel, attendance, etc.
Live & Final (With Game State)
Full scores and gameday info delivered live and post-game for a given gameweek. Live data includes down and distance, as well as game clock. Gameday info includes TV channel, attendance, etc.
Live & Final (With Game State)
This endpoint simply delivers quarter, clock, and total score live; no down and distance and no gameday info.
Games - by Week [Final]
This is the Final version of this endpoint. For live data, please use Games - by Week [Live & Final].
Full scores and gameday info as well as all of the quarter scores and full-time score, delivered as the game ends.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.Games (Basic) - by Week [Final]
A slimmed-down score endpoint, giving just the quarter scores and final score, for simple applications, delivered as the game ends, called by week.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.Games (Basic) by Date - [Final]
This is the Final version of this endpoint. For live data, please use Games (Basic) - by Date [Live & Final].
A slimmed-down score endpoint, giving just the quarter scores and final score, for simple applications, delivered as the game ends, called by date.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the games.
Examples:
Examples:
2021-SEP-12, 2021-NOV-28.Games by Date - [Final]
This is the Final version of this endpoint. For live data, please use Games - by Date [Live & Final].
Full scores and gameday info as well as all of the quarter scores and full-time score as the game ends.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the game(s).
Examples:
Examples:
2016-SEP-01, 2017-SEP-10.Games - by Date [Live & Final]
Full scores and gameday info delivered live and post-game for a given date. Live data includes down and distance, as well as game clock. Gameday info includes TV channel, attendance, etc.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the game(s).
Examples:
Examples:
2016-SEP-01, 2017-SEP-10.Games - by Week [Live & Final]
Retrieving up-to-the-second high-level game information, such as scores and game status.
Full scores and gameday info delivered live and post-game for a given gameweek. Live data includes down and distance, as well as game clock. Gameday info includes TV channel, attendance, etc.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.Games (Basic) - by Date [Live & Final]
This endpoint simply delivers quarter, clock, and total score live; no down and distance and no gameday info.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the game(s).
Examples:
Examples:
2016-SEP-01, 2017-SEP-10.Team & Player Stats
Available Endpoints
Subfeed
Final Only
Returns all statistics for the specified game, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Final Only
Returns all statistics for all games on the specified date, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Final Only
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.
Final Only
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.Final Only
Returns the box score statistical record for all involved players across all teams' games on a given week after each game has concluded. This will only include players that have recorded a stat.
Final Only
Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season.
Final Only
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.
Final Only
Returns game by game log of total team statistics.
Final Only
Returns the box score statistical record team-wide (aggregated from all players) for games in a given week after the game has concluded.
Final Only
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. Also includes their standing information.
Live & Final
Returns all statistics for the specified game, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final. Note that defensive player stats update 1-2 hours after the game has ended.
Live & Final
Returns all statistics for all games on the specified date, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final. Note that defensive player stats update 1-2 hours after the game has ended.
Live & Final
Full statistical information, down to the team and player stat level, delivered live during the games, called for all games on a given week of a given season. Note that defensive player stats update 1-2 hours after the game has ended.
Live & Final
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. By definition this is a live endpoint, not final. Note that defensive player stats update 1-2 hours after the game has ended.
Live & Final
Returns the box score statistical record for all involved players across a given week, updated live as the games take place. Note that defensive player stats update 1-2 hours after the game has ended. This will only include players that have recorded a stat.
Live & Final
Returns the box score statistical record team-wide (aggregated from all players) for games in a given week as the game progresses.
Box Score [Final]
This is the Final version of this endpoint. For live data, please use Box Score [Live & Final].
Returns all statistics for the specified game, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
1148 or 1149Box Scores - by Date [Final]
This is the Final version of this endpoint. For live data, please use Box Scores - by Date [Live & Final].
Returns all statistics for all games on the specified date, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the game(s).
Examples:
Examples:
2016-JAN-01, 2017-JAN-01.Box Scores - by Week [Final]
This is the Final version of this endpoint. For live data, please use Box Scores - by Week [Live & Final].
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.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2017, 2018, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
2, 3, etc.Player Game Logs - by Season
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.Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Season to get games from. Example
2019POST, 2020playerid
integer
true
Unique SportsDataIO Player ID.
Example:
50036283.numberofgames
string
true
How many games to return. Example
all, 10, 25Player Game Stats - by Week [Final]
This is the Final version of this endpoint. For live data, please use Player Game Stats - by Week [Live & Final].
Returns the box score statistical record for all involved players across all teams' games on a given week after each game has concluded. This will only include players that have recorded a stat.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.Player Season Stats
Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season (with optional season type).
Examples:
Examples:
2017, 2017POST, 2018.Player Season Stats - by Team
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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season (with optional season type).
Examples:
Examples:
2017, 2017POST, 2018.team
string
true
The abbreviation of the requested team.
Examples:
Examples:
SF, NYY.Team Game Logs - by Season
Returns game by game log of total team statistics.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET
https://api.sportsdata.io/v3/cfb/scores/json/TeamGameStatsBySeason/{season}/{teamid}/{numberofgames}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Season to get games from. Example
2019POST, 2020teamid
integer
true
Unique ID of team. Example
1 numberofgames
string
true
How many games to return. Example
all, 10, 25Team Game Stats - by Week [Final]
This is the Final version of this endpoint. For live data, please use Team Game Stats - by Week [Live & Final].
Returns the box score statistical record team-wide (aggregated from all players) for games in a given week after the game has concluded.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.Team Season Stats & Standings
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. Also includes their standing information.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season (with optional season type).
Examples:
Examples:
2017, 2017POST, 2018.Box Score [Live & Final]
Returns all statistics for the specified game, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final. Note that defensive player stats update 1-2 hours after the game has ended.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
1148 or 1149Box Scores - by Date [Live & Final]
Returns all statistics for all games on the specified date, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final. Note that defensive player stats update 1-2 hours after the game has ended.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the game(s).
Examples:
Examples:
2016-JAN-01, 2017-JAN-01.Box Scores - by Week [Live & Final]
Full statistical information, down to the team and player stat level, delivered live during the games, called for all games on a given week of a given season. Note that defensive player stats update 1-2 hours after the game has ended.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2017, 2018, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
2, 3, etc.Box Scores Delta - by Week
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. By definition this is a live endpoint, not final. Note that defensive player stats update 1-2 hours after the game has ended.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
BoxScore[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.minutes
string
true
Only returns player statistics that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are:
1 or 2.Player Game Stats - by Week [Live & Final]
Returns the box score statistical record for all involved players across a given week, updated live as the games take place. Note that defensive player stats update 1-2 hours after the game has ended. This will only include players that have recorded a stat.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.Team Game Stats - by Week [Live & Final]
Returns the box score statistical record team-wide (aggregated from all players) for games in a given week as the game progresses.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season.
Examples:
Examples:
2015, 2016, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, 3, etc.Player Feeds
Depth Charts, Lineups & Injuries
Available Endpoints
Subfeed
Depth Charts, Lineups & Injuries
Full player bio and details, including injury notes, for all active players.
Depth Charts, Lineups & Injuries
This endpoint provides all currently injured college football players, along with injury details.
Depth Charts, Lineups & Injuries
Full player bio and details, including injury notes, for all available players by team.
Player Details - by Active
Full player bio and details, including injury notes, for all active players.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Player Details - by Injured
This endpoint provides all currently injured college football players, along with injury details.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
Player Details - by Team
Full player bio and details, including injury notes, for all available players by team.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
team
string
true
The abbreviation of the requested team.
Examples:
Examples:
SF, NYY.Betting Feeds
Game Lines
Available Endpoints
Subfeed
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for games in the specified week, meaning odds for games that are in-progress. Returns only the most recent data and does not include line movement.
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for games in the specified week. A Sportsbook Group must also be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
In-Play Lines Plus
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full 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.
In-Play Lines Plus
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
In-Play Lines Plus
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. 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. 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.
Pre-Game Lines
Returns the non-full-game odds (spread, moneyline, total) for games in the specified week. Non-full-game means 1st half or 1st quarter, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
Pre-Game Lines
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.
Pre-Game Lines
Returns 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.
Pre-Game Lines Plus
Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means 1st half or 1st quarter, for example, rather than full 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.
Pre-Game Lines Plus
Returns the game odds (spread, moneyline, total) 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.
Pre-Game Lines Plus
Returns the game odds (spread, moneyline, total) 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.
Pre-Game Lines Plus
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. 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.
In-Game Odds - by Week
Returns in-play game odds (spread, moneyline, total) for games in the specified week, meaning odds for games that are in-progress. Returns only the most recent data and does not include line movement.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season, with optional season type.
Examples:
Examples:
2018, 2018POST, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, etc.In-Game Odds - by Week [Sportsbook Group]
Returns in-play game odds (spread, moneyline, total) for games in the specified week. A Sportsbook Group must also be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season, with optional season type.
Examples:
Examples:
2018, 2018POST, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, etc.sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100In-Game Odds Line Movement
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full 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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
8487 or 8657In-Game Odds Line Movement [Sportsbook Group]
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
8487 or 8657sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100In-Game Odds Line Movement with Resulting [Sportsbook Group]
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. 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. 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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfoResult[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
8487 or 8657sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Period Game Odds - by Week
Returns the non-full-game odds (spread, moneyline, total) for games in the specified week. Non-full-game means 1st half or 1st quarter, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season, with optional season type.
Examples:
Examples:
2018, 2018POST, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, etc.Pre-Game and Period Game Odds - by Week [Sportsbook Group]
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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season, with optional season type.
Examples:
Examples:
2018, 2018POST, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, etc.sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Pre-Game Odds - by Week
Retrieving the most recent pre-game odds data
Returns 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.
Endpoint Notes
Ideal For:
Receiving the most recent pre-game odds across a variety of sportsbooks
Not Ideal For:
Retrieving line movement (Use Pre-Game Odds Line Movement instead)
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season, with optional season type.
Examples:
Examples:
2018, 2018POST, etc.week
integer
true
The week of the game(s).
Examples:
Examples:
1, 2, etc.Period Game Odds Line Movement
Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means 1st half or 1st quarter, for example, rather than full 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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
8487 or 8657Pre-Game and Period Game Odds Line Movement [Sportsbook Group]
Returns the game odds (spread, moneyline, total) 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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
8487 or 8657sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Pre-Game and Period Game Odds Line Movement with Resulting [Sportsbook Group]
Returns the game odds (spread, moneyline, total) 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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfoResult[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
8487 or 8657sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Pre-Game Odds Line Movement
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. 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.
Endpoint Notes
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of an CFB game. GameIDs can be found in the Games API. Valid entries are
8487 or 8657Props
Available Endpoints
Subfeed
SportsDataIO API Historical
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
Props
Returns BettingEvents for the specified 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).
Props
Returns BettingEvents for the specified 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).
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified BettingEventID.
Props
Returns the markets and available outcomes for the specified BettingEventID. A Sportsbook Group must also be specified as a URL parameter.
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID.
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID. A Sportsbook Group must also be specified as a URL parameter.
Props
Returns Markets and available outcomes for the specified event and market type. This is 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.
Props
Returns Markets and available outcomes for the specified event and market type. A Sportsbook Group must also be specified as a URL parameter. This is 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.
Props
Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
Props
Returns player props for the specified game. A Sportsbook Group must also be specified as a URL parameter. This works the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only.
GET
Betting Market
Props Plus
Returns full line movement for the specified 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.
Props Plus
Returns full line movement for a specified BettingMarket. A Sportsbook Group must also be specified as a URL parameter. 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.
Props Plus
Returns resulting for the specified market that is supported for result. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Props Plus
Returns resulting for the specified market that is supported for results. 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 also be specified as a URL parameter.
Betting Props - by Season [Sportsbook Group] [Archive]
To ensure best performance, all betting odds older than 30 days are stored in our Historical API data warehouse. See our
Historical Data Guide
for more information.
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingMarket
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season
Examples:
Examples:
2020, 2021, etc.bettingMarketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookGrouping
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Betting Events - by Date
Returns BettingEvents for the specified 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).
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
date
string
true
The date of the game(s).
Examples:
Examples:
2020-10-17Betting Events - by Season
Returns BettingEvents for the specified 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).
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season
Examples:
Examples:
2021, 2022, etc.Betting Markets - by Event
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified BettingEventID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
Betting Markets - by Event [Sportsbook Group]
Returns the markets and available outcomes for the specified BettingEventID. A Sportsbook Group must also be specified as a URL parameter.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Betting Markets - by Game
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
Ideal For:
Receiving a high-level view of all betting markets offered for a game
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets).
Betting Markets - by Game [Sportsbook Group]
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID. A Sportsbook Group must also be specified as a URL parameter.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets).
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Betting Markets - by Market Type
Returns Markets and available outcomes for the specified event and market type. This is 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.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include:
1 for Game Lines, 2 for Player Props, 3 for Team Props, 6 for Game PropsBetting Markets - by Market Type [Sportsbook Group]
Retrieving lowest latency betting markets for a given game
Returns Markets and available outcomes for the specified event and market type. A Sportsbook Group must also be specified as a URL parameter. This is 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.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BettingMarket[]
Included Data Tables:
Ideal For:
Retrieving all betting markets for a given market type within a game
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of
available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended. Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include:
1 for Game Lines, 2 for Player Props, 3 for Team Props, 6 for Game Propssportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Betting Player Props - by Game
Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
gameId
integer
true
The unique GameID of the game in question.
Betting Player Props - by Game [Sportsbook Group]
Retrieving the lowest latency player props within a game
Returns player props for the specified game. A Sportsbook Group must also be specified as a URL parameter. This works the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
Ideal For:
Retrieving all player props for a given game
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET
https://api.sportsdata.io/v3/cfb/odds/json/BettingPlayerPropsByGameID/{gameId}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
- available
- unlisted
This parameter indicates which
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets. Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted. unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available. URL Template Parameters
Parameter Name
Type
Required
Value
gameId
integer
true
The unique GameID of the game in question.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Betting Market
Returns full line movement for the specified 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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingMarket
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
Betting Market [Sportsbook Group]
Returns full line movement for a specified BettingMarket. A Sportsbook Group must also be specified as a URL parameter. 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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingMarket
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Betting Results - by Market
Returns resulting for the specified market that is supported for result. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
BettingMarketResult
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
marketId
string
true
BettingMarketID of the market for which you would like to see resulted outcomes. Valid example ID
17819Betting Results - by Market [Sportsbook Group]
Returns resulting for the specified market that is supported for results. 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 also be specified as a URL parameter.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
BettingMarketResult
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
marketId
string
true
BettingMarketID of the market for which you would like to see resulted outcomes. Valid example ID
17819sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Futures
Available Endpoints
Subfeed
SportsDataIO API Historical
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
Futures
Returns available Futures markets for the specified season. This endpoint does not include line movement.
Futures
Returns available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
Betting Futures - by Season [Sportsbook Group] [Archive]
To ensure best performance, all betting odds older than 30 days are stored in our Historical API data warehouse. See our
Historical Data Guide
for more information.
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingMarket
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season
Examples:
Examples:
2020, 2021, etc.bettingMarketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookGrouping
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Betting Futures - by Season
Returns available Futures markets for the specified season. This endpoint does not include line movement.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season
Examples:
Examples:
2020, 2021, etc.Betting Futures - by Season [Sportsbook Group]
Returns available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
season
string
true
Year of the season
Examples:
Examples:
2020, 2021, etc.sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples:
Examples:
G1100Matchups, Trends & Splits
Available Endpoints
Subfeed
Betting Splits
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified market. This endpoint will return the movement from this market as well as the most recent.
Betting Splits
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified game. This endpoint will return the movement from this market as well as the most recent.
Matchup Stats
Returns trends data for a specified pairing of teams (team vs opponent) - Last X games. Will return data even if the teams are not set to play this season. This is intended for use with a specific game, though it will work for other comparisons if applicable.
Matchup Stats
Returns recent team trends and performance against betting lines in recent sets of games - Last X games.
Betting Splits - by Betting Market
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified market. This endpoint will return the movement from this market as well as the most recent.
Endpoint Notes
Call Interval:
Return Type:
BettingMarketSplit
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
marketId
string
true
The MarketId of the desired market for which to pull splits.
Betting Splits - by Game
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified game. This endpoint will return the movement from this market as well as the most recent.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameBettingSplit
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
gameid
integer
true
The ID of the game for which you want to receive splits for. Example
11778Betting Trends - by Matchup
Returns trends data for a specified pairing of teams (team vs opponent) - Last X games. Will return data even if the teams are not set to play this season. This is intended for use with a specific game, though it will work for other comparisons if applicable.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
MatchupTrends
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
team
string
true
The abbreviation of the requested team.
Examples:
Examples:
MIA, ND, PITT, etc.opponent
string
true
The abbreviation of the requested opponent.
Examples:
Examples:
MIA, ND, PITT, etc.Betting Trends - by Team
Returns recent team trends and performance against betting lines in recent sets of games - Last X games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamTrends
Included Data Tables:
The SportsDataIO API Free Trial only provides access to the UEFA Champions League
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
(Competition ID: 3)If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
team
string
true
The abbreviation of the requested team.
Examples:
Examples:
MIA, ND, PITT, etc.