Search

Search course groups — POST /courses/searchCourseGroups

This call returns course groups matching keywords, country, region, or GPS, including a publicId you store. It does not hydrate scorecard or GPS — those are later calls on the same publicId.

POST /courses/searchCourseGroups0 · free

Credits

0 credits · free.

Required parameters

POST body is PublicCourseGroupSearchRequestDto:

  • keywords (string)
  • rows (integer)
  • offset (integer)
  • countryCode (string)
  • regionCode (string)
  • gpsCoordinate (latitude / longitude)
  • includeUSGACourseIds (boolean)

Every call needs Authorization: Bearer YOUR_ACCESS_TOKEN after token exchange.

Example

curl -X POST 'https://api.golfintelligence.com/courses/searchCourseGroups' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":"YOUR_COURSE","rows":10,"offset":0}'

Placeholders only. Swap in YOUR_ACCESS_TOKEN, YOUR_PUBLIC_ID, YOUR_COURSE, YOUR_HOLE_ID, YOUR_ACTIVE_TOKEN, or YOUR_CLIENT_ID from the console. Do not treat placeholders as a live course record.

Questions developers ask

Search course groups

Does search return the scorecard or GPS polygons?

No. Search returns matching course groups and a publicId. Hydrate with getCourseGroupDetail (scorecard + GPS), getCourseGroupScorecard (scorecard only), or getCourseGroupGPS (GPS only).

How many credits does searchCourseGroups cost?

0 credits — free. Always step one so you can find a course without burning credits.

What do I store from the response?

Store publicId. Later GETs take query PublicId=YOUR_PUBLIC_ID. Do not treat sample JSON or placeholder names as a live course record.

Start on the homepage

Use the golf course data API.

Test credits are $49 for 50 to download courses, green slope, and elevation. Buy now. After that, email data@golfintelligence.com if you need more. Console login is your email plus a verification code.

Buy now — $49 for 50 test credits. Credits are added in the console after payment. Starter is $399/month for 10,000 credits for apps.