API Access
NIGHT MODE
DAY MODE
This is the "beta" version of our API.
We are in the process of adding other endpoints to complement those listed below.
If you have any questions/suggestions feel free to email us.
My API Key: No Token!
To get access to the API, you must become a Scratch Plus member.
Overview
The data golf API is set of simple endpoints/urls that allow you to programmatically retrieve our data.
The goal is to provide a more efficient way for you to interact with and integrate our data into your models/applications.
The API can be divided into four general categories:
The API can be divided into four general categories:
1. General Use — updated field lists, tee times, DFS salaries.
2. Model Predictions — historical, pre-tournament, and live predictions from our baseline and course-specific models.
3. Betting Tools — live odds data streaming out of our Outright and Match-Up & 3-Ball betting tools.
4. Historical Odds — historical opening and closing lines from outright/finish position and matchup markets offered at various sportsbooks.
5. Historical Raw Data — not available... maybe in the future.
Authentication
We have made authentication as simple as possible. Just add your API key as a parameter to the query string of every request you make to our endpoints.
Here is an example url:
https://feeds.datagolf.com/example-api-endpoint?example_param=10&key=API_TOKEN
If you're having trouble getting started, email us and we'll help you out.
ENDPOINTS
General Use
Player List & IDs
Returns the list of players who have played on a "major tour" since 2018, or are playing on a major tour this week.
IDs, country, amateur status included.
Endpoint: https://feeds.datagolf.com/get-player-list?file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/get-player-list?file_format=json&key=API_T...
Preview:
Event Legend & IDs
Returns the list of tournaments (and corresponding IDs) that are available in the API.
Use this endpoint to fill the event_id and year query parameters in the Archived Predictions, Historical Outrights, and Historical Matchups & 3-Balls endpoints.
Endpoint: https://feeds.datagolf.com/get-event-list?tour=[ tour ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/get-event-list?tour=pga&file_format=json&key=API_T...
Preview:
Field Updates
Up-to-the-minute field updates on WDs, Monday Qualifiers, tee times, and fantasy salaries for PGA Tour, European Tour, and Korn Ferry Tour events. Includes data golf IDs and tour-specific IDs for each player in the field.
Data corresponds to Field Updates page.
Endpoint: https://feeds.datagolf.com/field-updates?tour=[ tour ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, kft
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/field-updates?tour=pga&file_format=json&key=API_T...
Preview:
Model Predictions
Data Golf Rankings
Returns the top 500 players in the current DG rankings, along with each player's skill estimate and respective OWGR rank.
Data corresponds to Data Golf Rankings page.
Endpoint: https://feeds.datagolf.com/preds/get-dg-rankings?file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/get-dg-rankings?file_format=json&key=API_T...
Preview:
Pre-Tournament Predictions
Returns full-field probabilistic forecasts for the upcoming tournament on PGA, European, and Korn Ferry Tours from both our baseline and baseline + course history & fit models. Probabilities provided for various finish positions (make cut, top 20, top 5, win, etc.).
Data corresponds to Pre-Tournament Predictions page.
Endpoint: https://feeds.datagolf.com/preds/pre-tournament?tour=[ tour ]&add_position=[ add_position ]&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, kft, opp (opposite field PGA TOUR event)
add_position optional
Specifies an additional position to include finish probabilities. Defaults are win, top 5, top 10, top 20, make cut.
1, 2, 3 .... 48, 49, 50
odds_format optional
Specifies the odds format.
percent (default), american, decimal, fraction
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/pre-tournament?tour=pga&add_position=17&odds_format=decimal&file_format=json&key=API_T...
Preview:
Pre-Tournament Predictions Archive
Historical archive of our PGA Tour pre-tournament predictions.
Data corresponds to Predictions Archive page.
Endpoint: https://feeds.datagolf.com/preds/pre-tournament-archive?event_id=[ event_id ]&year=[ year ]&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
event_id optional
Specifies the event.
event IDs can be found through this endpoint (if no event ID is provided, the most recent event is returned)
year optional
Specifies the calendar year (not season) of the event.
2020, 2021 (default)
odds_format optional
Specifies the odds format.
percent (default), american, decimal, fraction
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/pre-tournament-archive?event_id=14&year=2020&odds_format=american&file_format=json&key=API_T...
Preview:
Live Model Predictions
Returns live (updating at 5 minute intervals) finish probabilities for ongoing PGA and European Tour tournaments.
Data corresponds to Live Predictive Model page.
Endpoint: https://feeds.datagolf.com/preds/in-play?tour=[ tour ]&dead_heat=[ dead_heat ]&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, opp (opposite field PGA TOUR event)
dead_heat optional
Adjusts odds for dead-heat rules.
no (default), yes
odds_format optional
Specifies the odds format.
percent (default), american, decimal, fraction
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/in-play?tour=euro&dead_heat=no&odds_format=percent&file_format=json&key=API_T...
Preview:
Player Skill Decompositions
Returns a detailed breakdown of every player's strokes-gained prediction for upcoming PGA and European Tour tournaments.
Data corresponds to Player Skill Decomposition page.
Endpoint: https://feeds.datagolf.com/preds/player-decompositions?tour=[ tour ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, opp (opposite field PGA TOUR event)
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/player-decompositions?tour=pga&file_format=json&key=API_T...
Preview:
Live Strokes-Gained
Returns a live strokes-gained breakdown for every player during PGA Tour tournaments.
Data corresponds to Live Strokes-Gained page.
Endpoint: https://feeds.datagolf.com/preds/live-strokes-gained?sg=[ sg ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
sg optional
Specifies the strokes-gained "view".
raw (default), relative (returns strokes-gained values relative to our prediction)
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/live-strokes-gained?sg=raw&file_format=json&key=API_T...
Preview:
Betting Tools
Outright (Finish Position) Odds
Returns the most recent win, top 5, top 10, top 20, make/miss cut, and first round leader odds offered at 11 sportsbooks alongside the corresponding predictions from our model.
To view a list of sportsbooks currently being tracked, visit this page.
Data corresponds to Finish Position Betting Tool page.
Endpoint: https://feeds.datagolf.com/betting-tools/outrights?tour=[ tour ]&market=[ market ]
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, kft, opp (opposite field PGA TOUR event)
market required
Specifies the match-up market.
win, top_5, top_10, top_20, mc, make_cut, frl
odds_format optional
Specifies the odds format.
percent, american, decimal (default), fraction
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/betting-tools/outrights?tour=pga&market=win&odds_format=decimal&file_format=json&key=API_T...
Preview:
Match-Up & 3-Ball Odds
Returns the most recent tournament match-up, round match-up, and 3-ball odds offered at 8 sportsbooks alongside the corresponding prediction from our model.
To view a list of sportsbooks currently being tracked, visit this page.
Data corresponds to 3 Ball & Matchups Betting Tool page.
Endpoint: https://feeds.datagolf.com/betting-tools/matchups?tour=[ tour ]&market=[ market ]
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, opp (opposite field PGA TOUR event)
market required
Specifies the match-up market.
tournament_matchups, round_matchups, 3_balls
odds_format optional
Specifies the odds format.
percent, american, decimal (default), fraction
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/betting-tools/matchups?tour=pga&market=3_balls&odds_format=decimal&file_format=json&key=API_T...
Preview:
Historical Betting Odds
Historical Outrights
Returns opening and closing lines in various markets (win, top 5, make cut, etc.) at 11 sportsbooks. Bet outcomes also included.
To view the available date ranges for each sportsbook, visit this page.
Data corresponds to Finish Position Betting Tool page.
Endpoint: https://feeds.datagolf.com/historical-odds/outrights?tour=[ tour ]&event_id=[ event_id ]&year=[ year ]&market=[ market ]&book=[ book ]
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro
event_id optional
Specifies the event.
event IDs can be found through this endpoint (if no event ID is provided, the most recent event is returned). Use "all" to return every event for the given year.
year optional
Specifies the calendar year (not season) of the event.
2019, 2020, 2021 (default)
market required
Specifies the market/finish position.
win, top_5, top_10, top_20, make_cut, mc
book required
Specifies the sportsbook.
bet365, betcris, betmgm, betway, bovada, corale, draftkings, fanduel, pinnacle, skybet, sportsbook, unibet, williamhill
odds_format optional
Specifies the odds format.
percent, american, decimal (default), fraction
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/historical-odds/outrights?tour=pga&event_id=14&year=2020&market=win&book=pinnacle
&odds_format=decimal&file_format=json&key=API_T...
&odds_format=decimal&file_format=json&key=API_T...
Preview:
Historical Match-Ups & 3-Balls
Returns opening and closing lines for tournament match-ups, round match-ups, and 3-balls at 12 sportsbooks. Bet outcomes also included.
To view the available date ranges for each sportsbook, visit this page.
Data corresponds to 3 Ball & Matchups Betting Tool page.
Endpoint: https://feeds.datagolf.com/historical-odds/matchups?tour=[ tour ]&event_id=[ event_id ]&year=[ year ]&book=[ book ]
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro
event_id optional
Specifies the event.
event IDs can be found through this endpoint (if no event ID is provided, the most recent event is returned). Use "all" to return every event for the given year.
year optional
Specifies the calendar year (not season) of the event.
2019, 2020, 2021 (default)
book required
Specifies the sportsbook.
5dimes, bet365, betcris, betmgm, betonline, bovada, draftkings, fanduel, pinnacle, sportsbook, williamhill, unibet
odds_format optional
Specifies the odds format.
percent, american, decimal (default), fraction
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/historical-odds/matchups?tour=pga&event_id=14&year=2020&book=drafkings
&odds_format=decimal&file_format=json&key=API_T...
&odds_format=decimal&file_format=json&key=API_T...
Preview: