You need a fast way to list golf clubs for a specific U.S. state or province, show each club’s name, address, and coordinates, and wire that into your app this week. By the end of this guide, you’ll query a real sports API endpoint for “golf clubs by state or province,” parse the results, and ship with production-ready authentication and pagination.
What you can build with the Golf Courses Data API
The Golf Courses Data API provides structured golf course records for sports applications. You can retrieve golf clubs filtered by state or province and get fields commonly needed for listings and search:
- Course name and address data (address, city, state, country)
- Contact fields like telephone (when available)
- Latitude and longitude for map overlays and distance calculations
Additional endpoints support lookups by course name and proximity (coordinates + radius), including scorecards and tee box info where present. This API fits tee time finders, course directories in sports apps, event planning tools, and on-course companion apps.
Explore the API on Zyla API Hub: one account, one API key, a subscription + quota model, and more than 10,000 public APIs you can integrate. The Golf Courses Data API lives in the Sports & Gaming category and offers a 7-day trial on the item page.
Getting started on Zyla API Hub
To call the endpoints:
- Open the Golf Courses Data API page on Zyla API Hub and subscribe.
- Grab your API key from your account.
- Send requests with the header: Authorization: Bearer YOUR_API_KEY
Use the listing page to start your trial: Start 7-day trial on Golf Courses Data API. Check the API page for current access options and pricing. Billing is subscription + quota (not pay-per-call). No Free Plan.
Endpoints you’ll use
1) Golf clubs by state or province
Retrieve golf courses filtered by state and access course name, address, city, country, and geographic coordinates.
- Method: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province
- Required query parameters:
- filter[state] (string): e.g., florida
- per_page (number): e.g., 1
- page (number): e.g., 1
Example request URL (no body; pass your bearer token in the header):
https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province?filter%5Bstate%5D=florida&per_page=1&page=1
Response returns a "courses" array with course objects. The fields you’ll typically use are courseName, address1, city, state, country, telephone (when present), latitude, longitude, and occasionally rating/scorecard data where available.
2) Golf courses by name
Retrieve detailed golf course information by name. Useful for direct search bars and deduping course records.
- Method: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name
- Required query parameters:
- filter[courseName] (string): e.g., Granadilla
Official cURL example (copy-paste ready):
curl -s -X GET "https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name?filter%5BcourseName%5D=Granadilla" \
-H "Authorization: Bearer YOUR_API_KEY"
Official JSON example (fields you’ll commonly read: courseName, address1, city, state, country, telephone, latitude, longitude, holes, scorecard, teeBoxes):
{"courses":[{"courseName":"Franklin Bridge Golf Club","address1":"750 Riverview Dr.","city":"Franklin","state":"Tennessee","country":"USA","telephone":"6157949400","ratings":"[]","latitude":"35.8930130","longitude":"-86.8406430"},{"courseName":"Franklin Bridge Golf Course","address1":"","city":"Franklin","state":"Tennessee","country":"USA","telephone":"","latitude":"35.8912540","longitude":"-86.8393630","website":"","holes":18,"lengthFormat":"Y","scorecard":"[{\"1\": \"4\", \"2\": \"5\", \"3\": \"3\", \"4\": \"4\", \"5\": \"3\", \"6\": \"4\", \"7\": \"4\", \"8\": \"4\", \"9\": \"5\", \"Out\": \"36\", \"Hole:\": \"Par:\"}, {\"1\": \"350\", \"2\": \"469\", \"3\": \"166\", \"4\": \"356\", \"5\": \"169\", \"6\": \"363\", \"7\": \"416\", \"8\": \"356\", \"9\": \"503\", \"Out\": \"3148\", \"Hole:\": \"Gold:\"}, {\"1\": \"0\", \"2\": \"0\", \"3\": \"0\", \"4\": \"0\", \"5\": \"0\", \"6\": \"0\", \"7\": \"0\", \"8\": \"0\", \"9\": \"0\", \"Out\": \"0\", \"Hole:\": \"Gold (May 2023):\"}, {\"1\": \"17\", \"2\": \"9\", \"3\": \"13\", \"4\": \"5\", \"5\": \"15\", \"6\": \"11\", \"7\": \"1\", \"8\": \"7\", \"9\": \"3\", \"Out\": \"\", \"Hole:\": \"Handicap:\"}, {\"10\": \"5\", \"11\": \"4\", \"12\": \"3\", \"13\": \"4\", \"14\": \"3\", \"15\": \"4\", \"16\": \"4\", \"17\": \"5\", \"18\": \"4\", \"In\": \"36\", \"Hole:\": \"Par:\", \"Total\": \"72\"}, {\"10\": \"503\", \"11\": \"347\", \"12\": \"162\", \"13\": \"380\", \"14\": \"164\", \"15\": \"354\", \"16\": \"371\", \"17\": \"539\", \"18\": \"327\", \"In\": \"3147\", \"Hole:\": \"Gold:\", \"Total\": \"6295\"}, {\"10\": \"0\", \"11\": \"0\", \"12\": \"0\", \"13\": \"0\", \"14\": \"0\", \"15\": \"0\", \"16\": \"0\", \"17\": \"0\", \"18\": \"0\", \"In\": \"0\", \"Hole:\": \"Gold (May 2023):\", \"Total\": \"6067\"}, {\"10\": \"8\", \"11\": \"18\", \"12\": \"14\", \"13\": \"2\", \"14\": \"16\", \"15\": \"10\", \"16\": \"12\", \"17\": \"6\", \"18\": \"4\", \"In\": \"\", \"Hole:\": \"Handicap:\", \"Total\": \"\"}]","teeBoxes":"[{\"name\": \"Gold\", \"slope\": \"121\", \"rating\": \"70.5\"}, {\"name\": \"Gold (May 2023)\", \"slope\": \"120\", \"rating\": \"69.2\"}]"},{"courseName":"Franklin Canyon GC","address1":"Highway 4","city":"Hercules","state":"California","country":"USA","ratings":"[]","latitude":"38.0054700","longitude":"-122.2160290"},{"courseName":"Franklin Canyon Golf Course","address1":"CA-4","city":"Hercules","state":"California","country":"USA","telephone":"(510) 799-6191","latitude":"38.0148580","longitude":"-…
What to read in practice: - courses: an array of course objects you can list in your UI - courseName/address1/city/state/country/telephone: business card fields - latitude/longitude: map pin and distance sort - holes/lengthFormat/scorecard/teeBoxes: when present, enrich detail pages with par, yardages, slopes, and ratings
3) Golf courses by coordinates
Retrieve courses within a radius of a point. Great for “near me” and map searches.
- Method: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3595/golf-courses-by-coordinates
- Required query parameters:
- radius (string): must not be greater than 50
- latitude (string)
- longitude (string)
- page (string)
Use this to complement state filtering with proximity search and to rank state results by distance if you have a user’s coordinates.
Python example: Fetch golf clubs by state or province
The snippet below calls the state/province endpoint, paginates one page, and prints a compact listing. Replace YOUR_API_KEY with your key.
import os
import requests
API_KEY = os.getenv("Zyla_API_Key", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province"
params = {
"filter[state]": "florida",
"per_page": 1,
"page": 1
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(BASE_URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
for c in data.get("courses", []):
name = c.get("courseName", "")
addr = c.get("address1", "")
city = c.get("city", "")
state = c.get("state", "")
country = c.get("country", "")
lat = c.get("latitude", "")
lon = c.get("longitude", "")
tel = c.get("telephone", "")
print(f"{name} | {addr}, {city}, {state}, {country} | tel={tel} | ({lat}, {lon})")
Notes: - Pagination: use per_page and page to iterate through large states. Cache pages locally to avoid re-fetches when users scroll. - Coordinates are strings; convert to float when running distance calculations. - Some optional fields (telephone, website, ratings) may be missing or empty strings—defensively check before displaying.
Official cURL you can use right now
Below is the ready-to-run official cURL for the name search endpoint. Keep the Authorization header and parameters exactly as shown, substituting your key.
Putting it together: common Sports use cases
- State/province directory: Build a “Browse by State” page. Use filter[state] with per_page/page for pagination. Link each course to a details page that you can enrich with the name or coordinate endpoints.
- Map-first search: Combine state filtering with the coordinates endpoint. If a user selects “Florida,” load the first state page, and if they enable location, call the coordinates endpoint to highlight the closest clubs within a 50-mile radius (or any radius ≤ 50 per the API note).
- Event planning: For sports event admins setting tournaments, search by state to shortlist venues. Then fetch by name to display holes, par, and tee boxes when available.
- Mobile “near me” feature: Cache the last coordinates query and refresh only when the user moves significantly or changes the radius. Keep per_page small for responsive UI, then lazy-load additional pages.
Calling the API from AI agents via MCP
You can trigger the same endpoints from AI coding agents compatible with the Model Context Protocol (MCP). Point your client at the MCP gateway:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Agents like Claude Code, Cursor, and Windsurf can call the Golf Courses Data API through this MCP endpoint and use the same bearer token you use in cURL and Python. For more details: MCP.
Operational details that save time
- Authentication: Use Authorization: Bearer YOUR_API_KEY on every request.
- Pagination: State and coordinates endpoints accept page and/or per_page. Start with per_page tuned to your UI (e.g., 20) and increment page as users scroll.
- Radius constraints: For the coordinates endpoint, the radius must not be greater than 50.
- Data variability: Some optional fields like telephone, website, ratings, and scorecard may be empty or omitted. Write null-safe parsing and hide empty fields.
- Caching: Cache per-page responses for a short period in your edge or client store to keep UI snappy and reduce redundant calls.
- Quotas: The marketplace uses a subscription + quota model. The first API you subscribe to typically offers a 7-day trial or 50 requests—check the item page for current details.
Reference: endpoints recap
- Golf clubs by state or province (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province
- filter[state] (string, required), per_page (number, required), page (number, required)
- Golf courses by name (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name
- filter[courseName] (string, required)
- Golf courses by coordinates (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3595/golf-courses-by-coordinates
- radius (string, required; must not be greater than 50), latitude (string, required), longitude (string, required), page (string, required)
FAQ
How do I authenticate?
Send Authorization: Bearer YOUR_API_KEY in the request headers for every endpoint.
How do I paginate state results?
Use per_page to control page size and page to iterate. Fetch subsequent pages as users scroll or paginate in your UI.
What fields should I expect for a course?
Common fields include courseName, address1, city, state, country, telephone (when present), latitude, longitude. Some endpoints also return holes, scorecard, and teeBoxes.
Is there a limit on proximity searches?
Yes. For the coordinates endpoint, the radius must not be greater than 50.
What are the pricing and trial options?
The marketplace uses a subscription + quota model. The first API typically offers a 7-day trial or 50 requests. Check the API page for current access options and pricing.
Ready to ship your golf club directory by state or province? Subscribe and get your key on the item page: Start 7-day trial on Golf Courses Data API.
Official API response
{"courses":[{"courseName":"Franklin Bridge Golf Club","address1":"750 Riverview Dr.","city":"Franklin","state":"Tennessee","country":"USA","telephone":"6157949400","ratings":"[]","latitude":"35.8930130","longitude":"-86.8406430"},{"courseName":"Franklin Bridge Golf Course","address1":"","city":"Franklin","state":"Tennessee","country":"USA","telephone":"","latitude":"35.8912540","longitude":"-86.8393630","website":"","holes":18,"lengthFormat":"Y","scorecard":"[{\"1\": \"4\", \"2\": \"5\", \"3\": \"3\", \"4\": \"4\", \"5\": \"3\", \"6\": \"4\", \"7\": \"4\", \"8\": \"4\", \"9\": \"5\", \"Out\": \"36\", \"Hole:\": \"Par:\"}, {\"1\": \"350\", \"2\": \"469\", \"3\": \"166\", \"4\": \"356\", \"5\": \"169\", \"6\": \"363\", \"7\": \"416\", \"8\": \"356\", \"9\": \"503\", \"Out\": \"3148\", \"Hole:\": \"Gold:\"}, {\"1\": \"0\", \"2\": \"0\", \"3\": \"0\", \"4\": \"0\", \"5\": \"0\", \"6\": \"0\", \"7\": \"0\", \"8\": \"0\", \"9\": \"0\", \"Out\": \"0\", \"Hole:\": \"Gold (May 2023):\"}, {\"1\": \"17\", \"2\": \"9\", \"3\": \"13\", \"4\": \"5\", \"5\": \"15\", \"6\": \"11\", \"7\": \"1\", \"8\": \"7\", \"9\": \"3\", \"Out\": \"\", \"Hole:\": \"Handicap:\"}, {\"10\": \"5\", \"11\": \"4\", \"12\": \"3\", \"13\": \"4\", \"14\": \"3\", \"15\": \"4\", \"16\": \"4\", \"17\": \"5\", \"18\": \"4\", \"In\": \"36\", \"Hole:\": \"Par:\", \"Total\": \"72\"}, {\"10\": \"503\", \"11\": \"347\", \"12\": \"162\", \"13\": \"380\", \"14\": \"164\", \"15\": \"354\", \"16\": \"371\", \"17\": \"539\", \"18\": \"327\", \"In\": \"3147\", \"Hole:\": \"Gold:\", \"Total\": \"6295\"}, {\"10\": \"0\", \"11\": \"0\", \"12\": \"0\", \"13\": \"0\", \"14\": \"0\", \"15\": \"0\", \"16\": \"0\", \"17\": \"0\", \"18\": \"0\", \"In\": \"0\", \"Hole:\": \"Gold (May 2023):\", \"Total\": \"6067\"}, {\"10\": \"8\", \"11\": \"18\", \"12\": \"14\", \"13\": \"2\", \"14\": \"16\", \"15\": \"10\", \"16\": \"12\", \"17\": \"6\", \"18\": \"4\", \"In\": \"\", \"Hole:\": \"Handicap:\", \"Total\": \"\"}]","teeBoxes":"[{\"name\": \"Gold\", \"slope\": \"121\", \"rating\": \"70.5\"}, {\"name\": \"Gold (May 2023)\", \"slope\": \"120\", \"rating\": \"69.2\"}]"},{"courseName":"Franklin Canyon GC","address1":"Highway 4","city":"Hercules","state":"California","country":"USA","ratings":"[]","latitude":"38.0054700","longitude":"-122.2160290"},{"courseName":"Franklin Canyon Golf Course","address1":"CA-4","city":"Hercules","state":"California","country":"USA","telephone":"(510) 799-6191","latitude":"38.0148580","longitude":"-…
Official API response
{"courses":[{"courseName":"Franklin Bridge Golf Club","address1":"750 Riverview Dr.","city":"Franklin","state":"Tennessee","country":"USA","telephone":"6157949400","ratings":"[]","latitude":"35.8930130","longitude":"-86.8406430"},{"courseName":"Franklin Bridge Golf Course","address1":"","city":"Franklin","state":"Tennessee","country":"USA","telephone":"","latitude":"35.8912540","longitude":"-86.8393630","website":"","holes":18,"lengthFormat":"Y","scorecard":"[{\"1\": \"4\", \"2\": \"5\", \"3\": \"3\", \"4\": \"4\", \"5\": \"3\", \"6\": \"4\", \"7\": \"4\", \"8\": \"4\", \"9\": \"5\", \"Out\": \"36\", \"Hole:\": \"Par:\"}, {\"1\": \"350\", \"2\": \"469\", \"3\": \"166\", \"4\": \"356\", \"5\": \"169\", \"6\": \"363\", \"7\": \"416\", \"8\": \"356\", \"9\": \"503\", \"Out\": \"3148\", \"Hole:\": \"Gold:\"}, {\"1\": \"0\", \"2\": \"0\", \"3\": \"0\", \"4\": \"0\", \"5\": \"0\", \"6\": \"0\", \"7\": \"0\", \"8\": \"0\", \"9\": \"0\", \"Out\": \"0\", \"Hole:\": \"Gold (May 2023):\"}, {\"1\": \"17\", \"2\": \"9\", \"3\": \"13\", \"4\": \"5\", \"5\": \"15\", \"6\": \"11\", \"7\": \"1\", \"8\": \"7\", \"9\": \"3\", \"Out\": \"\", \"Hole:\": \"Handicap:\"}, {\"10\": \"5\", \"11\": \"4\", \"12\": \"3\", \"13\": \"4\", \"14\": \"3\", \"15\": \"4\", \"16\": \"4\", \"17\": \"5\", \"18\": \"4\", \"In\": \"36\", \"Hole:\": \"Par:\", \"Total\": \"72\"}, {\"10\": \"503\", \"11\": \"347\", \"12\": \"162\", \"13\": \"380\", \"14\": \"164\", \"15\": \"354\", \"16\": \"371\", \"17\": \"539\", \"18\": \"327\", \"In\": \"3147\", \"Hole:\": \"Gold:\", \"Total\": \"6295\"}, {\"10\": \"0\", \"11\": \"0\", \"12\": \"0\", \"13\": \"0\", \"14\": \"0\", \"15\": \"0\", \"16\": \"0\", \"17\": \"0\", \"18\": \"0\", \"In\": \"0\", \"Hole:\": \"Gold (May 2023):\", \"Total\": \"6067\"}, {\"10\": \"8\", \"11\": \"18\", \"12\": \"14\", \"13\": \"2\", \"14\": \"16\", \"15\": \"10\", \"16\": \"12\", \"17\": \"6\", \"18\": \"4\", \"In\": \"\", \"Hole:\": \"Handicap:\", \"Total\": \"\"}]","teeBoxes":"[{\"name\": \"Gold\", \"slope\": \"121\", \"rating\": \"70.5\"}, {\"name\": \"Gold (May 2023)\", \"slope\": \"120\", \"rating\": \"69.2\"}]"},{"courseName":"Franklin Canyon GC","address1":"Highway 4","city":"Hercules","state":"California","country":"USA","ratings":"[]","latitude":"38.0054700","longitude":"-122.2160290"},{"courseName":"Franklin Canyon Golf Course","address1":"CA-4","city":"Hercules","state":"California","country":"USA","telephone":"(510) 799-6191","latitude":"38.0148580","longitude":"-…