sg_categories: Only shown in JSON format. (Also listed in the Historical Raw Data Event IDs endpoint). Value of "yes" indicates that SG category data is available for all rounds; "partial" indicates that SG category data is only available for some rounds; "no" indicates that SG category data is not available in any round.

traditional_stats: Only shown in JSON format. (Also listed in the Historical Raw Data Event IDs endpoint). Value of "yes" indicates that all traditional stats (DD, DA, GIR, Scrambling, Proximity) are available for all rounds and are derived from shot-level data (see details on specific variables below); "partial" indicates that traditional stats derived from shot-level data are only available for some of the rounds; "basic" indicates that only some of the traditional stats (DD, DA, GIR) are available and they are not derived from shot-level data but instead use PGA Tour definitions (see details on specific variables below); "no" indicates that traditional stats are not available in any round.

round_score: Total score in a specific round.

sg_app, sg_arg, sg_ott, sg_putt: Strokes-gained categories. Only available at Shotlink-equipped PGA Tour events. The values reported here are directly pulled from the PGA Tour website. In theory, each SG category should have a mean of zero by tournament-round-course (i.e. the PGA Tour subtracts off the mean in each category). This is almost always true, however there are a few exceptions:

Ignoring the above cases, the 4 SG categories should add up to strokes-gained total (defined as the difference between a player's score and the average score for that round and course). However, there are a small number of what appear to be mistakes on the part of the PGA Tour. One somewhat common mistake is that when a player doesn't hit a shot around-the-green they are given a value of 0 for SG:ARG, meaning that the mean SG:ARG for the field was not subtracted off. To fix this you can calculate sg_arg as the difference between sg_t2g and sg_ott+sg_app. We don't make this correction in the API data, as it's meant to be raw data. The remaining errors (20-30 of them, all since the 2020 season) appear to be fairly idiosyncratic and the source of the discrepancy is not always clear. To see these for yourself, calculate the difference between sg_total and the sum of sg_ott, sg_app, sg_arg, sg_putt.

There is a single instance (as of September 2021) where SG category data was not reported for a golfer in a round that should have had Shotlink data:

sg_t2g: Strokes-gained from tee to green. Defined as the sum of sg_ott, sg_app, and sg_arg. The values here are directly pulled from the PGA Tour website (i.e. we do not perform the calculation ourselves), which means we can't guarantee the individual components always add up.

sg_total: Total strokes-gained. Calculated (by us) as the difference between a player's score and the average score for that round and course (for events with multiple courses). When strokes-gained categories are available, this should be equal to the sum of sg_ott, sg_app, sg_arg, and sg_putt, but for the reasons detailed above this will not quite be true in all cases.

driving_dist: Driving distance. When shot-level data is available (traditional_stats='yes' or traditional_stats='partial'), this equals the average distance of all drives on Par 4s and 5s (reloads included). When there is no shot-level data (traditional_stats='basic'), this equals the average of the two measured drives (selected by the PGA Tour) in each round.

driving_acc: Driving accuracy. When shot-level data is available (traditional_stats='yes' or traditional_stats='partial'), this equals the percentage of fairways hit counting intermediate rough, fringe and greens as fairway; reloads are not included. When there is no shot-level data (traditional_stats='basic'), this equals the percentage of fairways hit not counting intermediate rough as fairway.

gir: Greens in regulation. When shot-level data is available (traditional_stats='yes' or traditional_stats='partial'), this equals the percentage of greens hit in regulation counting fringes; when there is no shot-level data (traditional_stats='basic'), fringes in regulation are not counted as greens hit.

scrambling: Scrambling percentage. Only available at events with shot-level data (traditional_stats='yes' or traditional_stats='partial'). Equal to the percentage of around-the-green shots from 50 yards and in that were holed out in 2 strokes or less. Shots deemed to be chip outs are excluded.

prox_rgh: Rough proximity. Only available at events with shot-level data (traditional_stats='yes' or traditional_stats='partial'). Equal to the average proximity of all shots hit from locations other than the fairway or intermediate rough from a distance greater than 50 yards. Shots deemed to be layups or punch outs are excluded.

prox_fw: Fairway proximity. Only available at events with shot-level data (traditional_stats='yes' or traditional_stats='partial'). Equal to the average proximity of all shots hit from the fairway (par 3 tee shots included) or intermediate rough from a distance greater than 50 yards. Shots deemed to be layups or punch outs are excluded.

great_shots: Great shots. Only available at events with shot-level data (traditional_stats='yes' or traditional_stats='partial'). Equal to the number of "great" shots in the round, where a great shot is defined as the top 5% of strokes-gained values in each category. The strokes-gained cutoffs by category are OTT: 0.3, APP: 0.55, ARG: 0.55, PUTT: 0.65. SG values are adjusted at the hole-level.

poor_shots: Poor shots. Only available at events with shot-level data (traditional_stats='yes' or traditional_stats='partial'). Equal to the number of "bad" shots in the round, where a bad shot is defined as the bottom 5% of strokes-gained values in each category. The strokes-gained cutoffs by category are OTT: -0.4, APP: -0.5, ARG: -0.6, PUTT: -0.5. SG values are adjusted at the hole-level.

dg_id: Player ID. There is a single dg_id for each player. Please notify us if you find a player that has multiple dg_ids. Use dg_id when performing operations by player. Any changes we make retroactively to a player's dg_id will be posted in the changelog.

player_name: Player's name. Will not necessarily be the same for all data points for a given player, although it should be. Use dg_id instead of player_name when performing operations by player.

teetime: Player's tee time. In the case of a weather delay changing tee times, we use the updated times. Within a tournament-round-course, teetime + start_hole identify groupings.

start_hole: Player's starting hole.

event_id: Tournament ID. For PGA, KFT, SAM, and CAN tours, event_id is constant across years. (However, note that in seasons where an event was played twice, e.g. the Masters in 2021, a new tournament number is used for the second playing of the event). For all other tours, event_id changes by year. Within a tour and season, or within a tour and calendar year, event_id uniquely identifies a tournament.

event_name: Event name. May change by year for any tour.

course_num: Course ID. For PGA, KFT, SAM, and CAN, course_num is constant for a given course. However, a course number may "change" if the course undergoes substantial changes. For example, Pebble Beach Golf Links at the 2019 U.S. Open is assigned a different number than its typical assignment for the AT&T Pro-Am. Here is the full list of PGA Tour courses with multiple IDs:

When performing operations by course on the above-listed tours, use course_num. For all other tours, course_num varies by course-year. For tours other than PGA, EUR, KFT, CHA, CAN, SAM, and CHAMP, course_num is not meaningful, and therefore multi-course events are not distinguishable from single-course events.

course_name: Course name. For the European Tour (EUR) and Challenge Tour (CHA), we have made course_name constant for a given course (i.e. spelling, naming convention is identical across years and tours). Use course_name when performing operations by course on the European and/or Challenge tours. For all other tours, the course_name variable may not be constant for a given course. If you find a course that has different values for course_name (on EUR or CHA), please notify us.

course_par: Course par. Available for PGA, EUR, KFT, CHA, CAN, SAM, CHAMP, and LIV tours.

fin_text: Official finishing position.

season: Official season as defined by each tour.

year: Calendar year.

event_completed: Official date of the final round of the tournament (e.g. if the event is delayed 1 day to a Monday, this date will still be that of the Sunday).

tour: Professional tour that the event was played on.