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: