Documentation

UK Golf Course API

REST API with 16 endpoints serving data on 2,833 UK golf clubs. Hosted on RapidAPI — authenticate with your X-RapidAPI-Key header.

Base URL:https://uk-golf-api.vercel.app

Authentication

All requests must include your RapidAPI key in the X-RapidAPI-Key header. Get your key at RapidAPI.

curl "https://uk-golf-api.vercel.app/clubs/nearby?lat=51.5&lng=-0.1&radius_km=10" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: uk-golf-course-data-api.p.rapidapi.com"

Rate Limits

PlanMonthlyPer Minute
Free2005
Basic5,00020
Pro25,00060
Business100,000120

Endpoints

Utility

GET
/

Health check

GET
/stats

Database statistics — club counts, data coverage

GET
/countries

List UK countries (England, Scotland, Wales, NI)

Regions

GET
/regions

List all regions (optional ?country= filter)

GET
/regions/{id}

Region detail

GET
/regions/{id}/clubs

Clubs in a region (paginated)

Clubs

GET
/clubs

List/search clubs — filter by country, county, postcode, type, rating, facilities, green fees

GET
/clubs/nearby

Geographic search — clubs within a radius of lat/lng

GET
/clubs/{id}

Full club detail

GET
/clubs/{id}/green-fees

Green fee pricing (all types)

GET
/clubs/{id}/facilities

Facility availability (19 boolean flags)

GET
/clubs/{id}/reviews

Google reviews (paginated)

GET
/clubs/{id}/courses

Courses with tee sets

Courses

GET
/courses/{id}

Course detail with tee sets and holes

GET
/courses/{id}/scorecard

Hole-by-hole scorecard

Tutorials

Find Golf Courses Near Me

Use /clubs/nearby with a UK postcode to build a location-aware club finder.

Compare Green Fees

Filter clubs by country and fee type to show price comparison tables.

Build a Club Profile Page

Chain club → courses → scorecard to display a rich course profile.

Build a Links Course Finder

Combine course_type and facility filters to surface seaside links courses.

WHS Handicap Integration

Combine UK Golf API scorecard data with the WHS API for handicap features.

Error Codes

CodeMeaning
200Success
400Bad Request — invalid parameters
401Unauthorized — missing or invalid API key
403Forbidden — subscription required for this endpoint
404Not Found — club/course ID does not exist
422Unprocessable — parameter validation error
429Too Many Requests — rate limit or quota exceeded
500Internal Server Error — contact support