Time to first 200

Token, free search, full course

Create a console account (email + verification code — no password). Use the API at console.golfintelligence.com. Buy now — $49 for 50 test credits. After that, email data@golfintelligence.com if you need more. Credits are added in the console after payment. Active Token lives under API Account. It is not a Bearer token. Exchange it first, then call search for free. A short machine file is at /llms.txt; credits are on API pricing.

1 · AUTHENTICATEconsole

POST /auth/authenticateToken

Host https://api.golfintelligence.com. Use client credentials. Placeholders only — swap in your Client ID and Active Token from the console.

POST https://api.golfintelligence.com/auth/authenticateToken
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
code=YOUR_ACTIVE_TOKEN
client_id=YOUR_CLIENT_ID

Authorization: Bearer YOUR_ACCESS_TOKEN   # after the exchange
2 · SEARCH0 credits · free

POST /courses/searchCourseGroups

Always step one. Power “find a course” without burning credits. Store publicId.

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}'

Illustrative only. Use a real course name from your market. Do not treat sample JSON as a live record.

3 · HYDRATE3 credits

GET /courses/getCourseGroupDetail?PublicId=

Flagship call. Scorecard + GPS + metadata. Cache one year per user. Optional per hole: slope image (1) and geohash lie elevation (ask us).

curl 'https://api.golfintelligence.com/courses/getCourseGroupDetail?PublicId=YOUR_PUBLIC_ID' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Building a personal golf app with Claude or Grok? Everything you need is on Personal golf app — Test credits are $49 for 50. Buy now. After that, email data@golfintelligence.com if you need more.

Endpoints

Production routes

MethodPathCreditsReturns
POST/courses/searchCourseGroups0 · freeCourse groups matching keywords, country, region, or GPS. Returns publicId.
POST/courses/searchCourseGroupsByCountryRegionconfirmPaginated course groups for a location. United States requests require a region code. Confirm credits in the console or email data@golfintelligence.com.
GET/courses/getCourseGroupScorecard1Complete scoring scorecard. GPS shapes are not included.
GET/courses/getCourseGroupGPS2Complete GPS shapes only. Scorecard is not included.
GET/courses/getCourseGroupDetail3Flagship: scorecard + GPS + metadata in one payload.
GET/greens/getSlopeImage1Rendered green slope image details, including URL. 900×1620.
GET/greens/getElevationImage1Rendered green elevation image details, including URL. 900×1620.
GET/holeProfile/getGeoHashElevationsee consoleLive lie elevation: geohash cells with GPS altitude. Confirm credits with us.
POST/holeProfile/getHoleProfileconfirmHole profile for a single hole or a list of holes for a course group. Confirm credits in the console or email data@golfintelligence.com.

Auth: OAuth2 client_credentials · Token URL POST /auth/authenticateToken · Every call Authorization: Bearer <access_token>

Errors you will see

  • 400 — bad or missing PublicId / body
  • 401 — missing or expired bearer; create a new token in console
  • 500 — retry, then email data@golfintelligence.com

Integration notes

  • 99.9% uptime; credits issued for downtime
  • Spatial data in a licensed app (sim / caddie) is Normal Use. Scraping, training, RAG, or catalog dumps are not. See Terms of Use.
  • No third-party resale; no printed books
  • California law · Encinitas, CA

Next step

Swap in your token and search for free.

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.