API Access
The Data Golf API is a set of simple endpoints only live data allows you to programmatically retrieve data. The goal is to provide a more efficient way for you to interact with and integrate our data into your own applications.
My API Key: No Token! To get access to the API, you must become a Scratch Plus member.
Overview
The API can be divided into six general categories:
- General Use — Player fixtures, tour schedules, and live field updates used to map DG IDs across tours.
- Model Predictions — Pre-tournament finish probabilities, DG rankings, and per-player skill decompositions.
- Live Model — In-tournament win probabilities and live strokes-gained, refreshed every 5 minutes.
- Betting Tools — Aggregated sportsbook odds for outrights, matchups, 3-balls, and tournament props.
- Historical Raw Data — Round-level scoring, strokes-gained, and shot-level data back to 1983 across 22 tours.
- Historical Betting Odds — Archived opening and closing sportsbook lines for outright, matchup, and prop markets.
- Historical DFS Data — DFS points earned and player salaries from DraftKings, FanDuel, and Yahoo across past events.
Authentication
We have made authentication as simple as possible: just add key as a parameter to the query string of every request you make to our API. Here is an example url:
https://feeds.datagolf.com/preds/pre-tournament?tour=pga&odds_format=percent&file_format=json&key=API_TOKEN
If you are having trouble getting started, email datagolf@datagolf.com and we will be glad to help.
General Use
GET
/get-player-listPlayer List & IDs — Master list of all players with unified DG IDs used across every endpoint.Parameters
file_formatstring"json" (default) or "csv"GET
/get-scheduleTour Schedules — Current and upcoming schedule for all supported tours, including course and purse data.Parameters
tourstring"pga" | "euro" | "kft" | "liv" | "all"file_formatstring"json" or "csv"GET
/field-updatesField Updates — Live field, tee times, start holes, and withdrawals for the current event.Parameters
tourstring"pga" | "euro" | "kft" | "liv"file_formatstring"json" or "csv"Model Predictions
GET
/preds/get-dg-rankingsDG Rankings — Current DG rankings and skill index estimates for all ranked players.Parameters
file_formatstring"json" or "csv"GET
/preds/pre-tournamentPre-Tournament Predictions — Finish probabilities (win, top-5/10/20, make cut) for every player in the field.Parameters
tourstring"pga" | "euro" | "kft" | "liv"add_positionstringOptional extra finish position, e.g. "top_2"odds_formatstring"percent" | "american" | "decimal"file_formatstring"json" or "csv"GET
/preds/player-decompositionsPlayer Decompositions — Baseline skill + course-fit adjustments per player for the current event.Parameters
tourstring"pga" | "euro" | "kft"file_formatstring"json" or "csv"Live Model
GET
/preds/in-playLive Predictions — Live finish probabilities updated approximately every 5 minutes during play.Parameters
tourstring"pga" | "euro" | "kft" | "liv"odds_formatstring"percent" | "american" | "decimal"file_formatstring"json" or "csv"GET
/preds/live-tournament-statsLive Tournament Stats — Live strokes-gained and traditional stats (GIR, driving distance, etc.) for the full field.Parameters
tourstring"pga" | "euro" | "kft"roundstring"event_avg" | "1" | "2" | "3" | "4"statstring"sg_putt" | "sg_arg" | "sg_app" | "sg_ott" | "sg_total" | "distance" | "accuracy"file_formatstring"json" or "csv"Betting Tools
GET
/betting-tools/outrightsOutright Odds — Opening and live outright odds from 8–12 major sportsbooks with model-implied fair values.Parameters
tourstring"pga" | "euro" | "kft" | "liv"marketstring"win" | "top5" | "top10" | "top20" | "mc"odds_formatstring"percent" | "american" | "decimal"file_formatstring"json" or "csv"GET
/betting-tools/matchupsMatchups & 3-Balls — Matchup and 3-ball odds with model edge versus each book.Parameters
tourstring"pga" | "euro" | "kft"marketstring"round_matchups" | "tournament_matchups" | "3_balls"odds_formatstring"percent" | "american" | "decimal"file_formatstring"json" or "csv"GET
/betting-tools/tournament-propsTournament Props — Prop markets including nationality, first-round leaders, and hole-in-one odds.Parameters
tourstring"pga" | "euro"odds_formatstring"percent" | "american" | "decimal"file_formatstring"json" or "csv"Historical Raw Data
GET
/historical-raw-data/roundsRound Scoring & SG — Round-level scoring and strokes-gained (where available) from 1983 to present across 22 tours.Parameters
tourstring"pga" | "euro" | "kft" | "liv" | "all"event_idstringOptional — filter to a single event.yearstringOptional — filter by calendar year.file_formatstring"json" or "csv"GET
/historical-raw-data/event-listEvent List — Complete catalogue of archived events with IDs, dates, courses, and tour codes.Parameters
tourstring"pga" | "euro" | "kft" | "liv" | "all"file_formatstring"json" or "csv"Historical Betting Odds
GET
/historical-odds/outrightsHistorical Outright Odds — Opening and closing outright odds from major books, by event and market.Parameters
tourstring"pga" | "euro" | "kft"marketstring"win" | "top5" | "top10" | "top20" | "mc"bookstringOptional — filter to a single sportsbook.odds_formatstring"percent" | "american" | "decimal"file_formatstring"json" or "csv"GET
/historical-odds/matchupsHistorical Matchup Odds — Archived tournament and round matchup lines from supported sportsbooks.Parameters
tourstring"pga" | "euro" | "kft"marketstring"round_matchups" | "tournament_matchups"odds_formatstring"percent" | "american" | "decimal"file_formatstring"json" or "csv"Historical DFS Data
GET
/historical-dfs-data/pointsDFS Points — Per-player DFS fantasy points for DraftKings, FanDuel, and Yahoo by event and round.Parameters
tourstring"pga" | "euro"sitestring"draftkings" | "fanduel" | "yahoo"file_formatstring"json" or "csv"GET
/historical-dfs-data/salariesDFS Salaries — Opening salaries for each player on DraftKings, FanDuel, and Yahoo by event.Parameters
tourstring"pga" | "euro"sitestring"draftkings" | "fanduel" | "yahoo"file_formatstring"json" or "csv"Your API Key
No Token
Upgrade to Scratch Plus →Rate Limits
45requests / minute
The rate limit currently applied is 45 requests per minute. This limit is not applied on a per-endpoint basis. If you exceed the limit, subsequent requests will be rejected for 1 minute.