Skip to main content

Golf API Documentation

This is the documentation for our Golf 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}

  • JSON
  • XML

Competition Feeds

Standings, Rankings & Brackets

Available Endpoints
Subfeed
GET Rankings
Standings, Rankings & Brackets
Returns golfer rankings from the Official World Golf Ranking for the specified season.

Rankings

Returns golfer rankings from the Official World Golf Ranking for the specified season.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2016, 2017.

Teams, Players & Rosters

Available Endpoints
Subfeed
GET Player
Teams, Players & Rosters
Returns biographical information such as weight, PGA debut, birthday, birth city, birth state, birth country, and college for the specified golfer.
Teams, Players & Rosters
Returns all golfers with biographical information such as weight, PGA debut, birthday, birth city, birth state, birth country, and college.

Player

Returns biographical information such as weight, PGA debut, birthday, birth city, birth state, birth country, and college for the specified golfer.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
playerid
integer
true
Unique FantasyData Player ID. Example:40000019.

Player Profiles - All

Returns all golfers with biographical information such as weight, PGA debut, birthday, birth city, birth state, birth country, and college.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Venues & Officials

Available Endpoints
Subfeed
GET Courses
Venues & Officials
Returns golf courses with information such as par, total yards, city, state, country, time zone, and format of the tournament being played there.

Courses

Returns golf courses with information such as par, total yards, city, state, country, time zone, and format of the tournament being played there.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Courses[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Utility Endpoints

Available Endpoints
Subfeed
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.
Utility Endpoints
Returns the calendar year of the current season with the start and end date.
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.

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
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Season Current

Returns the calendar year of the current season with the start and end date.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Season
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Sportsbooks - by Active

Returns a list of all available sportsbooks with their associated unique IDs.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Sportsbook[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Event Feeds

Schedules & Game Day Info

Available Endpoints
Subfeed
Schedules & Game Day Info
Returns a full schedule of tournaments for the specified season. Includes tournament information such as start and end date, start time, venue, par, total yards, purse, city, state, country, time zone, and format of the tournament.
GET Schedules
Schedules & Game Day Info
Returns a full schedule of tournaments going back to 2014. Includes tournament information such as start and end date, start time, venue, par, total yards, purse, city, state, country, time zone, and format of the tournament.

Schedule - by Season

Returns a full schedule of tournaments for the specified season. Includes tournament information such as start and end date, start time, venue, par, total yards, purse, city, state, country, time zone, and format of the tournament.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Tournament[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2016, 2017.

Schedules

Returns a full schedule of tournaments going back to 2014. Includes tournament information such as start and end date, start time, venue, par, total yards, purse, city, state, country, time zone, and format of the tournament.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Tournament[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Scores & Game State

Available Endpoints
Subfeed
Final Only (No Game State)
Returns scores (including round scores) for each golfer that played in the specified tournament. All of which are delivered at the conclusion of the tournament.
Live & Final (With Game State)
Returns scores (including round scores) for each golfer that is playing or has played in the specified tournament. All of which delivered during and after the tournament.

Scores - by Tournament [Final]

This is the Final version of this endpoint. For live data, please use Scores - by Tournament [Live & Final].
Returns scores (including round scores) for each golfer that played in the specified tournament. All of which are delivered at the conclusion of the tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TournamentRound[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Scores - by Tournament [Live & Final]

Returns scores (including round scores) for each golfer that is playing or has played in the specified tournament. All of which delivered during and after the tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TournamentRound[]
Included Data Tables:
Ideal For:
Retrieving total round scores for each golfer
Not Ideal For:
Retrieving full stats (Use Leaderboard [Live & Final] instead.)
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Team & Player Stats

Available Endpoints
Subfeed
Final Only
Returns the leaderboard for the specified tournament. Includes limited tournament and golfer information. All of which is delivered at the conclusion of the tournament.
Final Only
Returns the final leaderboard for the specified tournament.
Final Only
Returns final hole-by-hole scores for each player in a specified tournament.
Final Only
Returns season-long stats for players in the specified season. Includes world golf ranking, total points, points lost, and points gained.
Live & Final
Returns the leaderboard for the specified tournament. Includes limited tournament and golfer information
Live & Final
Returns the leaderboard for the specified tournament. Includes limited tournament and golfer information, which is delivered during and after the tournament.
Live & Final
Returns live and final hole-by-hole scores for each player in a specified tournament.

Leaderboard (Basic) [Final]

This is the Final version of this endpoint. For live data, please use Leaderboard (Basic).
Returns the leaderboard for the specified tournament. Includes limited tournament and golfer information. All of which is delivered at the conclusion of the tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
LeaderboardBasic
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Leaderboard [Final]

This is the Final version of this endpoint. For live data, please use Leaderboard [Live & Final].
Returns the final leaderboard for the specified tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Leaderboard
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Player Hole Scores - by Tournament [Final]

This is the Final version of this endpoint. For live data, please use Player Hole Scores - by Tournament [Live & Final].
Returns final hole-by-hole scores for each player in a specified tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerTournamentBasic[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Player Season Stats

Returns season-long stats for players in the specified season. Includes world golf ranking, total points, points lost, and points gained.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2016, 2017.

Leaderboard (Basic)

Returns the leaderboard for the specified tournament. Includes limited tournament and golfer information
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
LeaderboardBasic
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Leaderboard [Live & Final]

Returns the leaderboard for the specified tournament. Includes limited tournament and golfer information, which is delivered during and after the tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Leaderboard
Ideal For:
Retrieving full stats and hole-by-hole scores for each golfer
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Player Hole Scores - by Tournament [Live & Final]

Returns live and final hole-by-hole scores for each player in a specified tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerTournamentBasic[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Betting Feeds

Game Lines

Available Endpoints
Subfeed
In-Play Lines
Returns live in-tournament odds for players, updating continuously throughout the tournament without showing line movement.
In-Play Lines
Returns in-tournament odds with historical line movement, updating continuously throughout the tournament. Cached at a slower rate than the standard In-Play Tournament Odds endpoint.
Pre-Game Lines
Returns pre-tournament odds for players, updating continuously until the tournament begins. Does not include historical line movement.
Pre-Game Lines
Returns pre-tournament odds with historical line movement, updating continuously until the tournament begins. Cached at a slower rate than the standard Tournament Odds endpoint. Called by Sportsbook Group.

In-Play Tournament Odds

Returns live in-tournament odds for players, updating continuously throughout the tournament without showing line movement.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
TournamentOdds
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

In-Play Tournament Odds Line Movement

Returns in-tournament odds with historical line movement, updating continuously throughout the tournament. Cached at a slower rate than the standard In-Play Tournament Odds endpoint.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TournamentOdds
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Tournament Odds

Returns pre-tournament odds for players, updating continuously until the tournament begins. Does not include historical line movement.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
TournamentOdds
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

Tournament Odds [Sportsbook Group]

Returns pre-tournament odds with historical line movement, updating continuously until the tournament begins. Cached at a slower rate than the standard Tournament Odds endpoint. Called by Sportsbook Group.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
TournamentOdds
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Props

Available Endpoints
Subfeed
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 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 a given event and market type. A Sportsbook Group must also be specified as a URL parameter. NOTE: 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 the markets of all available types (e.g. Player Props) and available outcomes for the specified tournament.
Props
Returns the markets of all available types (e.g. Player Props) and available outcomes for the specified tournament. A Sportsbook Group must be specified as a URL parameter.
Props
Returns golfer props available in the specified tournament. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
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.

Betting 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[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the tournament(s). Can be any of the dates for the span of a tournament (i.e. Thursday through Sunday).
Examples: 2020-10-17

Betting 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[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season
Examples: 2020, 2021, 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[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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 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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
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[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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 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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
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: G1100

Betting 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[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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 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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).

Betting Markets - by Market Type [Sportsbook Group]

"Returns markets and available outcomes for a given event and market type. A Sportsbook Group must also be specified as a URL parameter. NOTE: 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[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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 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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
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: G1100

Betting Markets - by Tournament

Returns the markets of all available types (e.g. Player Props) and available outcomes for the specified tournament.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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 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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of the desired tournament for which to pull all betting markets (includes outcomes/bets).

Betting Markets - by Tournament [Sportsbook Group]

Returns the markets of all available types (e.g. Player Props) and available outcomes for the specified tournament. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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 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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of the desired tournament for which to pull all betting markets (includes outcomes/bets).
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Player Props - by Tournament [Sportsbook Group]

Returns golfer props available in the specified tournament. 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[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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 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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of the desired tournament for which to pull all betting markets (includes outcomes/bets).
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting 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
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
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
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
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: G1100

Fantasy Feeds

Projections

Available Endpoints
Subfeed
Legacy Projections
Returns projected golfer stats for the specified tournament.
Ownership Projections
Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
Ownership Projections
Returns DFS Slates which have not yet started for which we have DFS Ownership projections.

Player Projected Stats - by Tournament

Returns projected golfer stats for the specified tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerTournamentProjection[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 78, 79, 80, etc.

DFS Slate Ownership Projections - by Slate

Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlateWithOwnershipProjection
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
slateId
integer
true
SlateID of the DFS Slate you wish to get ownership projections for. Will have an empty SlateOwnershipProjections if this slate was not projected

DFS Slate Ownership Projections - Upcoming

Returns DFS Slates which have not yet started for which we have DFS Ownership projections.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlateWithOwnershipProjection[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Salaries, Stats & Points

Available Endpoints
Subfeed
Points & Stats
Returns fantasy points scored by golfers in the specified tournament.
Salaries & Slates
Returns DFS slates for the specified tournament.

Fantasy Points - by Tournament

Returns fantasy points scored by golfers in the specified tournament.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
FantasyTournament
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 78, 79, 80, etc.

DFS Slates - by Tournament

Returns DFS slates for the specified tournament.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlate[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
tournamentid
integer
true
The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are 58, 61, etc.

News & Images

Player News & Notes

Available Endpoints
Subfeed
Rotoballer News
Returns RotoBallers premium news feed (stories in greater detail), ordered by date/time.
Rotoballer News
Returns RotoBallers premium news feed (stories in greater detail) for specified date.

Premium News

Returns RotoBallers premium news feed (stories in greater detail), ordered by date/time.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
News[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Premium News - by Date

Returns RotoBallers premium news feed (stories in greater detail) for specified date.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
News[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the news.
Examples: 2021-JAN-06, 2021-JAN-31.

Player Headshots

Available Endpoints
Subfeed
GET Headshots
Player Headshots
Returns headshots for players. For more information click here.

Headshots

Returns headshots for players. For more information click here.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Headshot[]
Included Data Tables:
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (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
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Contact Us