Course Fingerprints
This endpoint returns a variety of data points about the course and its context
Endpoint URLs
https://dde-api.data.imgarena.com/golf/course_fingerprints/{request_type}/{external_course_id}
URL Sample:
https://dde-api.data.imgarena.com/golf/course_fingerprints/course_difficulty/ET-1553
https://dde-api.data.imgarena.com/golf/course_fingerprints/course_fingerprint/ET-1553
https://dde-api.data.imgarena.com/golf/course_fingerprints/numbers_to_know/ET-1553
https://dde-api.data.imgarena.com/golf/course_fingerprints/three_categories/ET-1553
https://dde-api.data.imgarena.com/golf/course_fingerprints/winner_data/ET-1553
Required Headers
Key
Value
Accept
application/vnd.imggaming.dde.api+json;version=1
Content-Type
application/json
Authorization
Bearer eyvhaoudfgpdfgo*
*Authorization header includes a truncated Bearer token, contact IMG for your auth token if you do not have.
Request Parameters
Request Types:
course_difficulty
course_fingerprint
numbers_to_know
three_categories
winner_data
External Course ID
Response Model
Covers all request types
Field Name
Type
Description
APP
array
Approach Shot SG value within an array from 0 to 10
ARG
array
Around the Green SG Shot value within an array from 0 to 10
OTT
array
Off The Tee SG Shot value within an array from 0 to 10
PUT
array
Putting Shot SG value within an array from 0 to 10
TOT
array
Total SG Shot value within an array from 0 to 10
external_course_id
string
External Tournament ID identifier String, covering DPWT, PGA Tour, Other Golf Tours
stat_name
string
course oriented stat name e.g. :
absolute_slope_x
around_the_green_gsg_difficulty
birdie_chance_inside_10ft
Average approach shot distance (yards)
Green in regulation %outOf10
float
score from 0 to 10
stat_average
float
average score for the stat in question (ranges in scale)
rank
int
the rank and importance of this stat in relation to the course
stat_value
float
the stat value score on this course
direction
string
an indication of acute context, e.g. hillier, easier, elevation
average_of_all_courses
float
the stat value score average across multiple courses
comment
string
an elaboration on stat_name
percentageScore
float
Average performance on this stat measured by percentages
playerId
string
The internal ID of the Player of the current event
firstName
string
The first name of the player
lastName
string
The surname of the player
americanodds
string
American MoneyLine odds format e.g +2800
averageWinningScore
float
average winning score
percentagePlayoffs
float
Number of play offs this person has had here
percentageShorter
float
Percentage of shorter scores
tournaments
int
Number of tournaments played
standings_toPar_displayValue
Number
variance on standings to Par display e.g. -21
tournament_year
int
Year of tournament (YYYY) e.g. 2022
winningMargin
string
e.g. 2 strokes
Sample Response for Course Difficulty
{
"APP": {
"outOf10": 2.1538461538461537
},
"ARG": {
"outOf10": 4.769230769230769
},
"OTT": {
"outOf10": 4.153846153846154
},
"PUT": {
"outOf10": 3.3076923076923075
},
"TOT": {
"outOf10": 3.5384615384615383
},
"external_course_id": "ET-1553"
}
]Sample Response for Course Fingerprint
[
{
"external_course_id": "ET-1553",
"stats": [
{
"stat_name": "absolute_slope_x",
"values": {
"outOf10": "8.846153846153845",
"stat_average": "0.0035148266536710357"
}
},
{
"stat_name": "absolute_slope_y",
"values": {
"outOf10": "7.076923076923077",
"stat_average": "0.003963628422724988"
}
},
{
"stat_name": "altitude_in_feet",
"values": {
"outOf10": "7.0",
"stat_average": "28.23680848043165"
}
},
{
"stat_name": "approach_gsg_difficulty",
"values": {
"outOf10": "2.1538461538461537",
"stat_average": "0.06969603810630402"
}
},
{
"stat_name": "around_the_green_gsg_difficulty",
"values": {
"outOf10": "4.769230769230769",
"stat_average": "0.06980111963818746"
}
},
{
"stat_name": "average_approach_shot",
"values": {
"outOf10": "8.0",
"stat_average": "189.85738576119988"
}
},
{
"stat_name": "average_driving_distance",
"values": {
"outOf10": "3.4615384615384617",
"stat_average": "296.7888611130697"
}
},
{
"stat_name": "birdie_chance_inside_10ft",
"values": {
"outOf10": "3.769230769230769",
"stat_average": "0.21908305839518766"
}
},
{
"stat_name": "birdie_chance_inside_20ft",
"values": {
"outOf10": "3.3846153846153846",
"stat_average": "0.4205938029765444"
}
},
{
"stat_name": "birdie_or_better_average",
"values": {
"outOf10": "3.846153846153846",
"stat_average": "0.23791889795504279"
}
},
{
"stat_name": "bogey_or_worse_average",
"values": {
"outOf10": "4.3076923076923075",
"stat_average": "0.1367226764087517"
}
},
{
"stat_name": "double_or_worse_average",
"values": {
"outOf10": "2.5384615384615388",
"stat_average": "0.011024423998713022"
}
},
{
"stat_name": "driver_hit_average",
"values": {
"outOf10": "4.428571428571429",
"stat_average": "0.8042703488598812"
}
},
{
"stat_name": "eagle_average",
"values": {
"outOf10": "4.923076923076923",
"stat_average": "0.006570205161474597"
}
},
{
"stat_name": "elevation_change",
"values": {
"outOf10": "7.538461538461538",
"stat_average": "7.530984604514016"
}
},
{
"stat_name": "extra_feet_distance_elevation",
"values": {
"outOf10": "7.0",
"stat_average": "0.5109453344747463"
}
},
{
"stat_name": "fairway_hit_average",
"values": {
"outOf10": "3.769230769230769",
"stat_average": "0.6052046865567015"
}
},
{
"stat_name": "go_for_green_average",
"values": {
"outOf10": "5.6923076923076925",
"stat_average": "0.18478914258151685"
}
},
{
"stat_name": "go_for_green_sum",
"values": {
"outOf10": "8.0",
"stat_average": "9.108223743469646"
}
},
{
"stat_name": "green_in_regulation_average",
"values": {
"outOf10": "2.5384615384615388",
"stat_average": "0.7396010938926597"
}
},
{
"stat_name": "green_size",
"values": {
"outOf10": "5.0",
"stat_average": "7107.858457746012"
}
},
{
"stat_name": "green_under_regulation_average",
"values": {
"outOf10": "4.923076923076923",
"stat_average": "0.02412365855240047"
}
},
{
"stat_name": "greenside_bunkers_found_average",
"values": {
"outOf10": "5.307692307692308",
"stat_average": "0.07497828380028018"
}
},
{
"stat_name": "hole_wind_impact_mph",
"values": {
"outOf10": "4.0",
"stat_average": "6.579755849297505"
}
},
{
"stat_name": "median_proximity",
"values": {
"outOf10": "3.3846153846153846",
"stat_average": "26.417091641573393"
}
},
{
"stat_name": "miss_fairway_penalty",
"values": {
"outOf10": "5.384615384615385",
"stat_average": "0.3816926874724374"
}
},
{
"stat_name": "obstructed_stroke_sum",
"values": {
"outOf10": "3.0",
"stat_average": "2.206431745568368"
}
},
{
"stat_name": "off_the_tee_gsg_difficulty",
"values": {
"outOf10": "4.153846153846154",
"stat_average": "-0.019345163034511798"
}
},
{
"stat_name": "over_2percent_break",
"values": {
"outOf10": "4.923076923076923",
"stat_average": "0.00047815528008778014"
}
},
{
"stat_name": "par_3_scoring",
"values": {
"outOf10": "4.3076923076923075",
"stat_average": "3.032680023076923"
}
},
{
"stat_name": "par_4_scoring",
"values": {
"outOf10": "2.8461538461538463",
"stat_average": "3.9551667944230773"
}
},
{
"stat_name": "par_5_scoring",
"values": {
"outOf10": "4.846153846153847",
"stat_average": "4.654170808447414"
}
},
{
"stat_name": "players",
"values": {
"outOf10": "9.307692307692307",
"stat_average": "50.600311850311854"
}
},
{
"stat_name": "putting_gsg_difficulty",
"values": {
"outOf10": "3.3846153846153846",
"stat_average": "0.012073019888329055"
}
},
{
"stat_name": "sand_save_average",
"values": {
"outOf10": "6.3076923076923075",
"stat_average": "0.4605773025672481"
}
},
{
"stat_name": "score_average",
"values": {
"outOf10": "4.846153846153847",
"stat_average": "3.926212111343111"
}
},
{
"stat_name": "scrambling_average",
"values": {
"outOf10": "4.230769230769231",
"stat_average": "0.5905436633680246"
}
},
{
"stat_name": "three_putt_average",
"values": {
"outOf10": "7.0",
"stat_average": "0.03682390979820924"
}
},
{
"stat_name": "total_penalty_sum",
"values": {
"outOf10": "5.0769230769230775",
"stat_average": "0.49085376754131904"
}
},
{
"stat_name": "tree_fairway_obstruction",
"values": {
"outOf10": "4.230769230769231",
"stat_average": "0.08331663093104864"
}
},
{
"stat_name": "up_and_down_average",
"values": {
"outOf10": "5.153846153846154",
"stat_average": "0.582369231643576"
}
},
{
"stat_name": "vspar_score_average",
"values": {
"outOf10": "3.5384615384615383",
"stat_average": "-0.09567855760638173"
}
},
{
"stat_name": "water_fairway_obstruction",
"values": {
"outOf10": "4.0",
"stat_average": "0.0028652461402400705"
}
},
{
"stat_name": "water_green_obstruction",
"values": {
"outOf10": "6.769230769230769",
"stat_average": "0.029452268244073657"
}
},
{
"stat_name": "width_fairway_feet",
"values": {
"outOf10": "6.0",
"stat_average": "66.59707431712137"
}
}
]
}
]
Sample Response for Numbers to Know
[
{
"external_course_id": "ET-1553",
"stats": [
{
"rank": 1,
"stat_name": "Average approach shot distance (yards)",
"values": {
"average_of_all_courses": "175.4",
"comment": "approachShot",
"direction": "longer",
"stat_value": "189.9"
}
},
{
"rank": 2,
"stat_name": "Green in regulation %",
"values": {
"average_of_all_courses": "66.0",
"comment": "greenInRegulation",
"direction": "easier",
"stat_value": "73.9"
}
},
{
"rank": 3,
"stat_name": "Average driving distance (yards)",
"values": {
"average_of_all_courses": "285.6",
"comment": "drivingDistance",
"direction": "longer",
"stat_value": "296.8"
}
},
{
"rank": 4,
"stat_name": "% of drives hitting driver",
"values": {
"average_of_all_courses": "75.1",
"comment": "driverHit",
"direction": "more",
"stat_value": "80.4"
}
},
{
"rank": 5,
"stat_name": "Average side break in putts",
"values": {
"average_of_all_courses": "0.6",
"comment": "slope",
"direction": "more",
"stat_value": "1.0"
}
},
{
"rank": 6,
"stat_name": "Driving accuracy %",
"values": {
"average_of_all_courses": "54.7",
"comment": "fairwayHit",
"direction": "easier",
"stat_value": "60.5"
}
},
{
"rank": 7,
"stat_name": "Par 4 scoring average",
"values": {
"average_of_all_courses": "4.06",
"comment": "par4",
"direction": "easier",
"stat_value": "3.96"
}
},
{
"rank": 8,
"stat_name": "Obstructed shots per round",
"values": {
"average_of_all_courses": "6.0",
"comment": "obstructed",
"direction": "less",
"stat_value": "2.0"
}
},
{
"rank": 9,
"stat_name": "% of holes with birdie or better",
"values": {
"average_of_all_courses": "20.4",
"comment": "birdieOrBetter",
"direction": "more",
"stat_value": "23.7"
}
},
{
"rank": 10,
"stat_name": "Proximity to pin (feet)",
"values": {
"average_of_all_courses": "29.1",
"comment": "proximity",
"direction": "closer",
"stat_value": "26.4"
}
},
{
"rank": 11,
"stat_name": "Average change in elevation (up or down) between tee and green",
"values": {
"average_of_all_courses": "15.1",
"comment": "elevationChange",
"direction": "hillier",
"stat_value": "24.4"
}
},
{
"rank": 12,
"stat_name": "Average score to par",
"values": {
"average_of_all_courses": "0.0",
"comment": "vsParScore",
"direction": "easier",
"stat_value": "-0.1"
}
},
{
"rank": 13,
"stat_name": "Penalties per round",
"values": {
"average_of_all_courses": "0.57",
"comment": "penalty",
"direction": "less",
"stat_value": "0.49"
}
},
{
"rank": 14,
"stat_name": "Three putt %",
"values": {
"average_of_all_courses": "3.0",
"comment": "threePutt",
"direction": "more",
"stat_value": "3.59"
}
},
{
"rank": 15,
"stat_name": "Average green size (sq ft)",
"values": {
"average_of_all_courses": "6020.0",
"comment": "greenSize",
"direction": "larger",
"stat_value": "7110.0"
}
},
{
"rank": 16,
"stat_name": "Scrambling %",
"values": {
"average_of_all_courses": "56.8",
"comment": "scrambling",
"direction": "easier",
"stat_value": "59.0"
}
},
{
"rank": 17,
"stat_name": "% of holes with bogey or worse",
"values": {
"average_of_all_courses": "18.4",
"comment": "bogeyOrWorse",
"direction": "less",
"stat_value": "13.6"
}
},
{
"rank": 18,
"stat_name": "Par 3 scoring average",
"values": {
"average_of_all_courses": "3.06",
"comment": "par3",
"direction": "easier",
"stat_value": "3.03"
}
},
{
"rank": 19,
"stat_name": "% of holes with eagle",
"values": {
"average_of_all_courses": "0.5",
"comment": "eagles",
"direction": "more",
"stat_value": "0.6"
}
},
{
"rank": 20,
"stat_name": "Sand save %",
"values": {
"average_of_all_courses": "48.0",
"comment": "sand_save",
"direction": "harder",
"stat_value": "46.0"
}
},
{
"rank": 21,
"stat_name": "Par 5 scoring average",
"values": {
"average_of_all_courses": "4.68",
"comment": "par5",
"direction": "easier",
"stat_value": "4.65"
}
},
{
"rank": 22,
"stat_name": "% of holes where players find GS Bunker",
"values": {
"average_of_all_courses": "7.39",
"comment": "greensideBunkers",
"direction": "more",
"stat_value": "7.39"
}
},
{
"rank": 23,
"stat_name": "Change in score between hitting and missing fairway",
"values": {
"average_of_all_courses": "0.38",
"comment": "missFairwayPenalty",
"direction": "smaller",
"stat_value": "0.38"
}
}
]
}
]Sample Response for Three Categories
[
{
"external_course_id": "ET-1553",
"stats": [
{
"stat_name": "Difficulty of Hitting Fairway",
"values": {
"comment": "difficultyFairway",
"direction": "more",
"percentageScore": "0.3769230769230769"
}
},
{
"stat_name": "Difficulty of Hitting Green",
"values": {
"comment": "difficultyGreen",
"direction": "more",
"percentageScore": "0.2538461538461539"
}
},
{
"stat_name": "Difficulty of Short Game",
"values": {
"comment": "difficultyShortGame",
"direction": "less",
"percentageScore": "0.4230769230769231"
}
},
{
"stat_name": "Difficulty of Slope on Greens",
"values": {
"comment": "difficultySlope",
"direction": "more",
"percentageScore": "0.8846153846153845"
}
},
{
"stat_name": "Frequency of Birdie Putts",
"values": {
"comment": "freqBirdiePutts",
"direction": "more",
"percentageScore": "0.7"
}
},
{
"stat_name": "Frequency of Birdie or Better",
"values": {
"comment": "freqBirdieOrBetter",
"direction": "more",
"percentageScore": "0.7153846153846154"
}
},
{
"stat_name": "Frequency of Bogey or Worse",
"values": {
"comment": "freqBogeyOrWorse",
"direction": "fewer",
"percentageScore": "0.43076923076923074"
}
},
{
"stat_name": "Frequency of Going for Green",
"values": {
"comment": "freqGFG",
"direction": "fewer",
"percentageScore": "0.5"
}
},
{
"stat_name": "Frequency of Short Game Shots",
"values": {
"comment": "freqShortGame",
"direction": "fewer",
"percentageScore": "0.4"
}
},
{
"stat_name": "Frequency of Taking Penalties",
"values": {
"comment": "freqPenalty",
"direction": "less",
"percentageScore": "0.5076923076923078"
}
},
{
"stat_name": "Frequency of Three Putts",
"values": {
"comment": "freqThreePutts",
"direction": "more",
"percentageScore": "0.7"
}
},
{
"stat_name": "Importance Hitting Green",
"values": {
"comment": "importGreen",
"direction": "more",
"percentageScore": "0.6038461538461538"
}
},
{
"stat_name": "Importance of Hitting Fairway",
"values": {
"comment": "importFairway",
"direction": "less",
"percentageScore": "0.5384615384615385"
}
},
{
"stat_name": "Importance of Using Driver",
"values": {
"comment": "importDriver",
"direction": "more",
"percentageScore": "0.6571428571428573"
}
}
]
}
]Sample Response for Winner Data
[
{
"external_course_id": "ET-1553",
"stats": {
"averageWinningScore": -19.333333333333332,
"percentagePlayoffs": 0,
"percentageShorter": 0.6666666666666666,
"tournaments": 3
},
"winners": [
{
"americanOdds": "+2800",
"firstName": "Nicolai",
"lastName": "Højgaard",
"playerId": "1799",
"standings_toPar_displayValue": "-21",
"tournament_year": 2023,
"winningMargin": "2 strokes"
},
{
"americanOdds": "+500",
"firstName": "Jon",
"lastName": "Rahm",
"playerId": "493",
"standings_toPar_displayValue": "-20",
"tournament_year": 2022,
"winningMargin": "2 strokes"
},
{
"americanOdds": "+750",
"firstName": "Collin",
"lastName": "Morikawa",
"playerId": "3378",
"standings_toPar_displayValue": "-17",
"tournament_year": 2021,
"winningMargin": "3 strokes"
}
]
}
]Last updated