Golf Course Finder

FREEMIUM

By golfambit | Updated 8 days ago | Sports

Popularity

9.2 / 10

Latency

422ms

Service Level

98%

Health Check

N/A

Spotlights

GolfAmbit API v2 Documentation

Discover the GolfAmbit API v2 documentation, offering expanded coverage with access to over 30,000 international golf clubs and 39,000 courses, enriched data, location-based search, radius limit functionality, and integration with Google Place Details for comprehensive golfing data enrichment.

Followers: 6

API Creator:

golfambit

Rate API:

Rating: 5 - Votes: 1

README

GolfAmbit API v2 Documentation

Description

🏌️‍♂️ Welcome to the Golf API v2 🏌️‍♀️

🌟 What’s New in v2:

Expanded Coverage: Access over 30,000 international golf clubs and 39,000 international golf courses, providing comprehensive data on global golfing destinations.
Richer Data: Enjoy an enriched dataset, surpassing the capabilities of v1, delivering more detailed and insightful information.

🔍 API Functionality:

Location-based Search: Retrieve golf courses based on specified latitude and longitude coordinates, allowing for precise geographical targeting.
Radius Limit: Explore golf courses within a mile or kilometer radius of your specified latitude and longitude, with a maximum limit of 50 miles or 80.4672 kilometers.
Google Place Details: Access comprehensive place details sourced from the Google Place API, enriching your golfing data with additional contextual information.

Base URL

The base URL for all API requests is:

https://golf-course-finder.p.rapidapi.com/api

Endpoints

`GET /golf-clubs/`

This endpoint will return courses located within a radius of up to 50 miles or 80.4672 kilometers from the given latitude and longitude. You can either request the radius in miles or kilometers, but not both. For example if you want the radius to be in miles=”50” then don’t pass the kilometers parameter or if you want the radius to be in kilometers=“50” then don’t pass the miles parameter.

Parameters

miles (optional): The search radius of miles is limited to a maximum of 50 miles. If you are searching by kilometers then this field must not be passed.
kilometers (optional): The search radius of kilometers is limited to a maximum of 80.4672 kilometers. If you are searching by miles then this field must not be passed.
latitude (required): The latitude of the desired location.
longitude (required): The longitude of the desired location.

Response

Returns a JSON object with the following properties:

club_name: The name of the golf club.
club_membership: The type of membership associated with the club.
number_of_holes: The total number of holes in the club’s golf courses.
address: The street address of the golf club.
city: The city where the golf club is located.
state: The state where the golf club is located.
country: The country where the golf club is located.
postal_code: The postal code of the golf club’s location.
phone: The phone number of the golf club.
fax: The fax number of the golf club.
website: The website URL of the golf club.
email_address: The email address of the golf club.
driving_range: Indicates if the club has a driving range (true/false).
putting_green: Indicates if the club has a putting green (true/false).
chipping_green: Indicates if the club has a chipping green (true/false).
practice_bunker: Indicates if the club has a practice bunker (true/false).
motor_cart: Indicates if motor carts are available for rent (true/false).
pull_cart: Indicates if pull carts are available for rent (true/false).
golf_clubs_rental: Indicates if golf clubs are available for rent (true/false).
club_fitting: Indicates if club fitting services are available (true/false).
pro_shop: Indicates if the club has a pro shop (true/false).
golf_lessons: Indicates if golf lessons are available (true/false).
caddie_hire: Indicates if caddie hire services are available (true/false).
restaurant: Indicates if there is a restaurant at the golf club (true/false).
reception_hall: Indicates if there is a reception hall at the golf club (true/false).
changing_room: Indicates if there are changing rooms at the golf club (true/false).
lockers: Indicates if lockers are available at the golf club (true/false).
lodging_on_site: Indicates if lodging is available on-site (true/false).
latitude: The latitude coordinate of the golf club’s location.
longitude: The longitude coordinate of the golf club’s location.
place_id: The unique identifier of the golf club’s location.
golf_courses: An array of golf course objects, each with the following properties:
- course_name: The name of the golf course.
- holes: The total number of holes in the golf course.
- par: The par value of the golf course.
- course_type: The type of golf course.
- course_architect: The architect(s) of the golf course.
- open_date: The date when the golf course was opened.
- guest_policy: The guest policy of the golf course.
- weekday_price: The price of playing the course on a weekday.
- weekend_price: The price of playing the course on a weekend.
- twilight_price: The twilight price of playing the course.
- fairway: The fairway condition of the golf course.
- green: The green condition of the golf course.
- currency: The currency used for pricing.

Example

JavaScript Request:

const url = 'https://golf-course-finder.p.rapidapi.com/api/golf-clubs/?miles=10&latitude=36.56910381018662&longitude=-121.95035631683683';
const options = {
	method: 'GET',
	headers: {
		'X-RapidAPI-Key': 'YOUR_API_KEY',
		'X-RapidAPI-Host': 'golf-course-finder.p.rapidapi.com'
	}
};

try {
	const response = await fetch(url, options);
	const result = await response.text();
	console.log(result);
} catch (error) {
	console.error(error);
}

Python Request:

import requests

url = "https://golf-course-finder.p.rapidapi.com/api/golf-clubs/"

querystring = {"miles":"10","latitude":"36.56910381018662","longitude":"-121.95035631683683"}

headers = {
	"X-RapidAPI-Key": "YOUR_API_KEY",
	"X-RapidAPI-Host": "golf-course-finder.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

Response:

[
  {
    "club_name": "Pebble Beach Resorts",
    "club_membership": "Resort",
    "number_of_holes": 27,
    "address": "1700 17 Mile Drive",
    "city": "Pebble Beach",
    "state": "California",
    "country": "United States of America",
    "postal_code": "93953",
    "phone": "+1 (831) 622-8723",
    "fax": "+1 (831) 622-8795",
    "website": "pebblebeach.com/golf/pebble-beach-golf-links",
    "email_address": "",
    "driving_range": true,
    "putting_green": true,
    "chipping_green": false,
    "practice_bunker": false,
    "motor_cart": true,
    "pull_cart": true,
    "golf_clubs_rental": true,
    "club_fitting": false,
    "pro_shop": false,
    "golf_lessons": true,
    "caddie_hire": false,
    "restaurant": true,
    "reception_hall": true,
    "changing_room": true,
    "lockers": false,
    "lodging_on_site": true,
    "latitude": 36.5696623,
    "longitude": -121.9497552,
    "place_id": "ChIJYUuxSFbmjYAR14kcbsdLieM",
    "golf_courses": [
      {
        "course_name": "Pebble Beach",
        "holes": 18,
        "par": 72,
        "course_type": "Parkland",
        "course_architect": "Jack Neville/Douglas Grant/",
        "open_date": null,
        "guest_policy": "Open",
        "weekday_price": "535.00",
        "weekend_price": "535.00",
        "twilight_price": "535.00",
        "fairway": "Default Fairway Value",
        "green": "Default Green Value",
        "currency": "USD"
      },
      {
        "course_name": "Peter Hay Par 3",
        "holes": 9,
        "par": 27,
        "course_type": "Parkland",
        "course_architect": "Peter Hay",
        "open_date": null,
        "guest_policy": "Open",
        "weekday_price": "30.00",
        "weekend_price": "30.00",
        "twilight_price": "30.00",
        "fairway": "Default Fairway Value",
        "green": "Default Green Value",
        "currency": "USD"
      }
    ]
  }
]

Errors

This Endpoint uses the following error codes:

{
  "message": "No results were found."
}
// Supply another mile radius because no results were found.

{
  "message": "Please enter a mile radius of 50 or less."
}
// Please enter a mille radius that is 1 to 50 miles.

{
  "message": "Please enter a kilometer radius of 80.4672 or less."
}
// Please enter a kilometer radius that is 1 to 80.4672 kilometers.

{
    "message": "Please provide a miles or kilometers value."
}
// Please provide a value for either the miles parameter or
// the kilometers parameter. One must be provided.

{
    "message": "Please provide only one value for either miles or kilometers."
}
// Please provide only one value for either the miles parameter or
// the kilometers parameter. Only one parameter can be provided.

`GET /course/details`

This endpoint retrieves course details from the Google Places API. The ‘place_id’ can be obtained from the ‘Get Courses’ call. We have ‘place_ids’ for 99% of our golf clubs. If a golf club doesn’t have a ‘place_id’, it means we haven’t found one yet.