API Access
NIGHT MODE
DAY MODE
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 five 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 Raw Data — round-level scoring and strokes-gained data from 20 global tours, all connected under one player ID system.
5. Historical Odds — historical opening and closing lines from outright/finish position and matchup markets offered at various sportsbooks.
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:

            
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
Comma-separated list of additional positions to include in output. 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,23&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 [ DEPRECATED ] use Live Tournament Stats going forward
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:

            
Live Tournament Stats
Returns live strokes-gained and traditional stats for every player during PGA Tour tournaments.
Data corresponds to Live Tournament Stats page.
Endpoint: https://feeds.datagolf.com/preds/live-tournament-stats?stats=[ stats ]&round=[ round ]&display=[ display ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
stats optional
Comma-separated list of statistics to be returned.
sg_putt, sg_arg, sg_app, sg_ott, sg_t2g, sg_total, distance, accuracy, gir, prox_fw, prox_rgh, scrambling
round optional
Specifies the round.
event_avg, 1, 2, 3, 4
display optional
Specifies how stats are displayed.
value (default), rank
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/live-tournament-stats?stats=sg_ott,distance,accuracy,sg_app,gir,prox_fw,sg_putt,scrambling
&round=event_avg&display=value&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...
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...
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:

            
Match-Up & 3-Ball Data Golf Odds — All Pairings
Returns Data Golf matchup / 3-ball odds for every pairing in the next round of current PGA Tour and European Tour events.
Endpoint: https://feeds.datagolf.com/betting-tools/matchups-all-pairings?tour=[ tour ]&odds_format=[ odds_format ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, opp
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-all-pairings?tour=pga&odds_format=decimal&file_format=json&key=API_T...
Preview:

            
Historical Raw Data
Historical Raw Data Event IDs
Returns the list of tournaments (and corresponding IDs) that are available through the historical raw data API endpoint. Use this endpoint to fill the event_id and year query parameters in the Round Scoring & Strokes Gained endpoint.
Endpoint: https://feeds.datagolf.com/historical-raw-data/event-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/historical-raw-data/event-list?file_format=json&key=API_T...
Preview:

            
Round Scoring & Strokes Gained
Returns round-level scoring and strokes gained data across 20 global tours.
Data corresponds to Raw Data Archive page. For variable/field definitions, general notes, and changelog click here.
Endpoint: https://feeds.datagolf.com/historical-raw-data/rounds?tour=[ tour ]&event_id=[ event_id ]&year=[ year ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour required
Specifies the tour. Hover over tour codes in table here to see full tour names.
pga, euro, kft, cha, jpn, anz, alp, champ, kor, ngl, bet, chn, afr, pgt, pgti, atvt, atgt, sam, ept, can
event_id required
Specifies the event.
event IDs can be found through this endpoint.
year required
Specifies the calendar year (not season) of the event.
2017, 2018, 2019, 2020, 2021
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/historical-raw-data/rounds?tour=pga&event_id=535&year=2021&file_format=json&key=API_T...
Preview:

            
Historical Betting Odds
Historical Odds Data Event IDs
Returns the list of tournaments (and corresponding IDs) that are available through the historical odds/predictions endpoints. 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/historical-odds/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/historical-odds/event-list?tour=pga&file_format=json&key=API_T...
Preview:

            
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 Outright Odds Archive 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...
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...
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 Matchup Odds Archive 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...
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...
Preview: