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_coursew_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"
      }
    ]
  }
]