Golf-Data

Sports API · Golf courses · Club data · Hole information

TL;DR

Golf-Data provides a free REST API for golf course information, club details, hole layouts, and player data. Query courses by name or location, get per-hole details including par, yardage, and handicap rating, and access club metadata. Designed for golf stat tracking apps, course finders, and scorecard applications. No API key required.

Quick start: https://golf-data-api.com/courses

No API key needed — free golf data!

How to Use This API

1. List All Golf Courses

Returns a list of available courses with basic metadata:

https://golf-data-api.com/courses

2. Get Course Details and Holes

Fetch hole-by-hole information including par, yardage, and handicap for each tee:

https://golf-data-api.com/courses/1/holes

3. Search Courses by Name

https://golf-data-api.com/courses?search=Pebble+Beach

4. JavaScript — Course Scorecard

fetch('https://golf-data-api.com/courses/1/holes')
  .then(r => r.json())
  .then(data => {
    console.log(`Course: ${data.course_name}`);
    data.holes.forEach(h => {
      console.log(`Hole ${h.hole_number}: Par ${h.par}, ${h.yardage}yd, HCP ${h.handicap}`);
    });
  });

5. Python — Find Courses Near You

import requests

courses = requests.get(
    'https://golf-data-api.com/courses',
    params={'lat': 33.95, 'lng': -118.40}
).json()

for course in courses[:5]:
    print(f"{course['name']} — {course['city']}, {course['state']}")
    print(f"  Holes: {course['holes']}, Par: {course['total_par']}")
List courses: https://golf-data-api.com/courses

Frequently Asked Questions

What data is available per hole?
Each hole includes hole_number, par, yardage (from each tee), handicap (stroke index), and optional notes like water hazards or dogleg direction.
Are different tee boxes supported?
Yes — the API supports multiple tee colors (black, blue, white, red, gold) with yardages and slope/rating data for each, where available.
How many golf courses are in the database?
The database covers thousands of golf courses worldwide, with primary coverage in the United States, Canada, the UK, and Australia. New courses are added regularly.
Can I get course slope and rating?
Yes — course-level data includes slope and rating values for each tee box, as well as total_par and total_yardage.
Is there geographic search?
Yes — pass lat and lng parameters to search courses by proximity to a location. Results are sorted by distance.
Can I contribute data for missing courses?
The API is open-source and community-driven. Contributions for missing courses are welcome via the project's GitHub repository.

API Details

API URL
https://golf-data-api.com/
Documentation
github.com/Jacobbrewer1/golf-data-docs
Category
Sports
Authentication
Not Required
Geographic Coverage
Global — primary coverage in US, CA, UK, AU

What You Can Build