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 six 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, stats, strokes-gained, and tee time data from 22 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.
6. Historical DFS Data — historical fantasy points in DraftKings and FanDuel main slate competitions.
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:

            
Tour Schedules
Current season schedules for the primary tours (PGA, DP World, Korn Ferry, LIV Golf). Includes event names/ids, course names/ids, and location (city/country and latitude, longitude coordinates) data.
Endpoint: https://feeds.datagolf.com/get-schedule?tour=[ tour ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
all (default), pga, euro, kft, alt (or liv)
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/get-schedule?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, opp, alt
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), alt
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, 2022, 2023 (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:

            
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), alt
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:

            
Player Skill Ratings
Returns our estimate and rank for each skill for all players with sufficient Shotlink measured rounds (at least 30 rounds in the last year or 50 in the last 2 years).
Data corresponds to Skill Ratings page.
Endpoint: https://feeds.datagolf.com/preds/skill-ratings?display=[ display ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
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/skill-ratings?display=value&file_format=json&key=API_T...
Preview:

            
Detailed Approach Skill
Returns detailed player-level approach performance stats (strokes-gained per shot, proximity, GIR, good shot rate, poor shot avoidance rate) across various yardage/lie buckets.
Data corresponds to Approach Skill page.
Endpoint: https://feeds.datagolf.com/preds/approach-skill?period=[ period ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
period optional
Specifies time period.
l24 (last 24 months) (default), l12 (last 12 months), ytd (year to date)
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/approach-skill?period=l12&file_format=json&key=API_T...
Preview:

            
Fantasy Projection Defaults [ NEW ]
Returns our default fantasy projections for main, showdown, late showdown, weekend, and captain mode contests at Draftkings, Fanduel, and Yahoo. Currently, Fanduel and Yahoo projections are only provided for main contests.
Data corresponds to Fantasy Projections page (with default settings applied).
Endpoint: https://feeds.datagolf.com/preds/fantasy-projection-defaults?tour=[ tour ]&site=[ site ]&slate=[ slate ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour optional
Specifies the tour.
pga (default), euro, opp (opposite field PGA TOUR event), alt
site optional
Specifies the site.
draftkings (default), fanduel, yahoo
slate optional
Specifies the slate (non-main slates only available for site=draftkings).
main (default), showdown, showdown_late, weekend, captain
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/fantasy-projection-defaults?tour=pga&site=draftkings&slate=main&file_format=json&key=API_T...
Preview:

            
LIVE MODEL ENDPOINTS
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), kft, alt
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:

            
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_bs, 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:

            
Live Hole Scoring Distributions [ NEW ]
Returns live hole scoring averages and distrubutions (birdies, pars, bogeys, etc.) broken down by tee time wave.
Data corresponds to Live Predictive Model page (hole-by-hole stats subheader).
Endpoint: https://feeds.datagolf.com/preds/live-hole-stats?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), kft, alt
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/preds/live-hole-stats?tour=euro&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), alt
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), alt
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, alt
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, Stats & Strokes Gained
Returns round-level scoring, traditional stats, strokes-gained, and tee time data across 22 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, liv, mex
event_id required
Specifies the event.
event IDs can be found through this endpoint. Use "all" to return every event for the given year and tour
year required
Specifies the calendar year (not season) of the event.
2017, 2018, 2019, 2020, 2021, 2022, 2023
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, alt
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, alt
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, 2022, 2023 (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, betonline, betway, bovada, caesars, corale, circa, 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, alt
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, 2022, 2023 (default)
book required
Specifies the sportsbook.
5dimes, bet365, betcris, betmgm, betonline, bovada, caesars, circa, 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:

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

            
DFS Points & Salaries
Returns salaries and ownerships alongside event-level finish, hole, and bonus scoring for PGA and European Tour events.
Data corresponds to DFS Archive page.
Endpoint: https://feeds.datagolf.com/historical-dfs-data/points?tour=[ tour ]&site=[ site ]&event_id=[ event_id ]&year=[ year ]&file_format=[ file_format ]&key=API_T...
PARAMETER
DESCRIPTION
OPTIONS
tour required
Specifies the tour.
pga, euro
site optional
Specifies the site.
draftkings (default), fanduel
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, 2022, 2023
file_format optional
Specifies the file format.
json (default), csv
Example
Endpoint: https://feeds.datagolf.com/historical-dfs-data/points?tour=pga&site=draftkings&event_id=535&year=2021&file_format=json&key=API_T...
Preview: