Necesitas una forma rápida de listar clubes de golf para un estado o provincia específica de EE. UU., mostrar el nombre de cada club, dirección y coordenadas, y conectar eso a tu aplicación esta semana. Al final de esta guía, consultarás un verdadero endpoint de API deportiva para “clubes de golf por estado o provincia”, analizarás los resultados y enviarás con autenticación y paginación listas para producción.
Lo que puedes construir con la API de Datos de Campos de Golf
La API de Datos de Campos de Golf proporciona registros estructurados de campos de golf para aplicaciones deportivas. Puedes recuperar clubes de golf filtrados por estado o provincia y obtener campos comúnmente necesarios para listados y búsqueda:
- Nombre del campo y datos de dirección (dirección, ciudad, estado, país)
- Campos de contacto como teléfono (cuando esté disponible)
- Latitud y longitud para superposiciones de mapas y cálculos de distancia
Endpoints adicionales soportan búsquedas por nombre de campo y proximidad (coordenadas + radio), incluyendo tarjetas de puntuación e información de tee box donde esté presente. Esta API se adapta a buscadores de horarios de tee, directorios de campos en aplicaciones deportivas, herramientas de planificación de eventos y aplicaciones de acompañamiento en el campo.
Explora la API en Zyla API Hub: una cuenta, una clave de API, un modelo de suscripción + cuota, y más de 10,000 APIs públicas que puedes integrar. La API de Datos de Campos de Golf vive en la categoría de Deportes y Juegos y ofrece una prueba de 7 días en la página del artículo.
Comenzando en Zyla API Hub
Para llamar a los endpoints:
- Abre la página de la API de Datos de Campos de Golf en Zyla API Hub y suscríbete.
- Obtén tu clave de API de tu cuenta.
- Envía solicitudes con el encabezado: Authorization: Bearer YOUR_API_KEY
Usa la página de listados para comenzar tu prueba: Comienza la prueba de 7 días en la API de Datos de Campos de Golf. Consulta la página de la API para opciones de acceso y precios actuales. La facturación es por suscripción + cuota (no por llamada). No hay Plan Gratuito.
Endpoints que usarás
1) Clubes de golf por estado o provincia
Recupera campos de golf filtrados por estado y accede al nombre del campo, dirección, ciudad, país y coordenadas geográficas.
- Método: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province
- Parámetros de consulta requeridos:
- filter[state] (string): p. ej., florida
- per_page (número): p. ej., 1
- page (número): p. ej., 1
Ejemplo de URL de solicitud (sin cuerpo; pasa tu token de portador en el encabezado):
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
La respuesta devuelve un array de "courses" con objetos de campo. Los campos que típicamente usarás son courseName, address1, city, state, country, telephone (cuando esté presente), latitude, longitude, y ocasionalmente datos de rating/scorecard donde estén disponibles.
2) Campos de golf por nombre
Recupera información detallada de campos de golf por nombre. Útil para barras de búsqueda directas y deduplicar registros de campos.
- Método: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name
- Parámetros de consulta requeridos:
- filter[courseName] (string): p. ej., Granadilla
Ejemplo oficial de cURL (listo para copiar y pegar):
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"
Ejemplo oficial de JSON (campos que comúnmente leerás: 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":"-…
Lo que debes leer en la práctica: - courses: un array de objetos de campo que puedes listar en tu UI - courseName/address1/city/state/country/telephone: campos de tarjeta de presentación - latitude/longitude: pin de mapa y orden de distancia - holes/lengthFormat/scorecard/teeBoxes: cuando estén presentes, enriquece las páginas de detalles con par, yardas, pendientes y calificaciones
3) Campos de golf por coordenadas
Recupera campos dentro de un radio de un punto. Genial para búsquedas de “cerca de mí” y mapas.
- Método: GET
- URL: https://zylalabs.com/api/2029/golf-courses-data-api/3595/golf-courses-by-coordinates
- Parámetros de consulta requeridos:
- radius (string): no debe ser mayor que 50
- latitude (string)
- longitude (string)
- page (string)
Usa esto para complementar el filtrado por estado con búsqueda de proximidad y para clasificar los resultados del estado por distancia si tienes las coordenadas de un usuario.
Ejemplo en Python: Obtener clubes de golf por estado o provincia
El fragmento a continuación llama al endpoint de estado/provincia, pagina una página y imprime un listado compacto. Reemplaza YOUR_API_KEY con tu clave.
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})")
Notas: - Paginación: usa per_page y page para iterar a través de grandes estados. Almacena páginas localmente para evitar volver a obtener datos cuando los usuarios se desplazan. - Las coordenadas son cadenas; conviértelas a float al realizar cálculos de distancia. - Algunos campos opcionales (teléfono, sitio web, calificaciones) pueden estar ausentes o ser cadenas vacías; verifica defensivamente antes de mostrar.
cURL oficial que puedes usar ahora mismo
A continuación se muestra el cURL oficial listo para ejecutar para el endpoint de búsqueda por nombre. Mantén el encabezado de Autorización y los parámetros exactamente como se muestra, sustituyendo tu clave.
Juntándolo todo: casos de uso comunes en Deportes
- Directorio de estado/provincia: Crea una página de “Navegar por Estado”. Usa filter[state] con per_page/page para paginación. Enlaza cada campo a una página de detalles que puedes enriquecer con los endpoints de nombre o coordenadas.
- Búsqueda primero en el mapa: Combina el filtrado por estado con el endpoint de coordenadas. Si un usuario selecciona “Florida”, carga la primera página del estado, y si habilitan la ubicación, llama al endpoint de coordenadas para resaltar los clubes más cercanos dentro de un radio de 50 millas (o cualquier radio ≤ 50 según la nota de la API).
- Planificación de eventos: Para administradores de eventos deportivos que establecen torneos, busca por estado para acortar lugares. Luego busca por nombre para mostrar hoyos, par y tees cuando estén disponibles.
- Función móvil “cerca de mí”: Almacena en caché la última consulta de coordenadas y actualiza solo cuando el usuario se mueve significativamente o cambia el radio. Mantén per_page pequeño para una UI receptiva, luego carga perezosamente páginas adicionales.
Llamando a la API desde agentes de IA a través de MCP
Puedes activar los mismos endpoints desde agentes de codificación de IA compatibles con el Protocolo de Contexto de Modelo (MCP). Apunta tu cliente al gateway MCP:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Agentes como Claude Code, Cursor y Windsurf pueden llamar a la API de Datos de Campos de Golf a través de este endpoint MCP y usar el mismo token de portador que usas en cURL y Python. Para más detalles: MCP.
Detalles operativos que ahorran tiempo
- Autenticación: Usa Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Paginación: Los endpoints de estado y coordenadas aceptan page y/o per_page. Comienza con per_page ajustado a tu UI (p. ej., 20) e incrementa page a medida que los usuarios se desplazan.
- Restricciones de radio: Para el endpoint de coordenadas, el radio no debe ser mayor que 50.
- Variabilidad de datos: Algunos campos opcionales como teléfono, sitio web, calificaciones y scorecard pueden estar vacíos u omitidos. Escribe un análisis seguro para null y oculta campos vacíos.
- Caché: Almacena en caché las respuestas por página durante un corto período en tu almacenamiento de borde o cliente para mantener la UI rápida y reducir llamadas redundantes.
- Cuotas: El mercado utiliza un modelo de suscripción + cuota. La primera API a la que te suscribes generalmente ofrece una prueba de 7 días o 50 solicitudes; consulta la página del artículo para detalles actuales.
Referencia: resumen de endpoints
- Clubes de golf por estado o provincia (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3600/golf-clubs-by-state-or-province
- filter[state] (string, requerido), per_page (número, requerido), page (número, requerido)
- Campos de golf por nombre (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3594/golf-courses-by-name
- filter[courseName] (string, requerido)
- Campos de golf por coordenadas (GET): https://zylalabs.com/api/2029/golf-courses-data-api/3595/golf-courses-by-coordinates
- radius (string, requerido; no debe ser mayor que 50), latitude (string, requerido), longitude (string, requerido), page (string, requerido)
FAQ
¿Cómo me autentico?
Envía Authorization: Bearer YOUR_API_KEY en los encabezados de solicitud para cada endpoint.
¿Cómo pagino los resultados del estado?
Usa per_page para controlar el tamaño de la página y page para iterar. Obtén páginas subsecuentes a medida que los usuarios se desplazan o paginan en tu UI.
¿Qué campos debo esperar para un campo?
Los campos comunes incluyen courseName, address1, city, state, country, telephone (cuando esté presente), latitude, longitude. Algunos endpoints también devuelven holes, scorecard y teeBoxes.
¿Hay un límite en las búsquedas de proximidad?
Sí. Para el endpoint de coordenadas, el radio no debe ser mayor que 50.
¿Cuáles son las opciones de precios y prueba?
El mercado utiliza un modelo de suscripción + cuota. La primera API generalmente ofrece una prueba de 7 días o 50 solicitudes. Consulta la página de la API para opciones de acceso y precios actuales.
¿Listo para enviar tu directorio de clubes de golf por estado o provincia? Suscríbete y obtén tu clave en la página del artículo: Comienza la prueba de 7 días en la API de Datos de Campos de Golf.
Respuesta oficial de la API
{"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":"[{[1m1[0m: [1m4[0m, [1m2[0m: [1m5[0m, [1m3[0m: [1m3[0m, [1m4[0m: [1m4[0m, [1m5[0m: [1m3[0m, [1m6[0m: [1m4[0m, [1m7[0m: [1m4[0m, [1m8[0m: [1m4[0m, [1m9[0m: [1m5[0m, [1mOut[0m: [1m36[0m, [1mHole:[0m: [1mPar:[0m}, {[1m1[0m: [1m350[0m, [1m2[0m: [1m469[0m, [1m3[0m: [1m166[0m, [1m4[0m: [1m356[0m, [1m5[0m: [1m169[0m, [1m6[0m: [1m363[0m, [1m7[0m: [1m416[0m, [1m8[0m: [1m356[0m, [1m9[0m: [1m503[0m, [1mOut[0m: [1m3148[0m, [1mHole:[0m: [1mGold:[0m}, {[1m1[0m: [1m0[0m, [1m2[0m: [1m0[0m, [1m3[0m: [1m0[0m, [1m4[0m: [1m0[0m, [1m5[0m: [1m0[0m, [1m6[0m: [1m0[0m, [1m7[0m: [1m0[0m, [1m8[0m: [1m0[0m, [1m9[0m: [1m0[0m, [1mOut[0m: [1m0[0m, [1mHole:[0m: [1mGold (mayo 2023):[0m}, {[1m1[0m: [1m17[0m, [1m2[0m: [1m9[0m, [1m3[0m: [1m13[0m, [1m4[0m: [1m5[0m, [1m5[0m: [1m15[0m, [1m6[0m: [1m11[0m, [1m7[0m: [1m1[0m, [1m8[0m: [1m7[0m, [1m9[0m: [1m3[0m, [1mOut[0m: [1m[0m, [1mHole:[0m: [1mHandicap:[0m}, {[1m10[0m: [1m5[0m, [1m11[0m: [1m4[0m, [1m12[0m: [1m3[0m, [1m13[0m: [1m4[0m, [1m14[0m: [1m3[0m, [1m15[0m: [1m4[0m, [1m16[0m: [1m4[0m, [1m17[0m: [1m5[0m, [1m18[0m: [1m4[0m, [1mIn[0m: [1m36[0m, [1mHole:[0m: [1mPar:[0m, [1mTotal[0m: [1m72[0m}, {[1m10[0m: [1m503[0m, [1m11[0m: [1m347[0m, [1m12[0m: [1m162[0m, [1m13[0m: [1m380[0m, [1m14[0m: [1m164[0m, [1m15[0m: [1m354[0m, [1m16[0m: [1m371[0m, [1m17[0m: [1m539[0m, [1m18[0m: [1m327[0m, [1mIn[0m: [1m3147[0m, [1mHole:[0m: [1mGold:[0m, [1mTotal[0m: [1m6295[0m}, {[1m10[0m: [1m0[0m, [1m11[0m: [1m0[0m, [1m12[0m: [1m0[0m, [1m13[0m: [1m0[0m, [1m14[0m: [1m0[0m, [1m15[0m: [1m0[0m, [1m16[0m: [1m0[0m, [1m17[0m: [1m0[0m, [1m18[0m: [1m0[0m, [1mIn[0m: [1m0[0m, [1mHole:[0m: [1mGold (mayo 2023):[0m, [1mTotal[0m: [1m6067[0m}, {[1m10[0m: [1m8[0m, [1m11[0m: [1m18[0m, [1m12[0m: [1m14[0m, [1m13[0m: [1m2[0m, [1m14[0m: [1m16[0m, [1m15[0m: [1m10[0m, [1m16[0m: [1m12[0m, [1m17[0m: [1m6[0m, [1m18[0m: [1m4[0m, [1mIn[0m: [1m[0m, [1mHole:[0m: [1mHandicap:[0m, [1mTotal[0m: [1m[0m}]","teeBoxes":"[{[1mname[0m: [1mGold[0m, [1mslope[0m: [1m121[0m, [1mrating[0m: [1m70.5[0m}, {[1mname[0m: [1mGold (mayo 2023)[0m, [1mslope[0m: [1m120[0m, [1mrating[0m: [1m69.2[0m}]"},{"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":"-…
Respuesta oficial de la API
{"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":"[{[1m1[0m: [1m4[0m, [1m2[0m: [1m5[0m, [1m3[0m: [1m3[0m, [1m4[0m: [1m4[0m, [1m5[0m: [1m3[0m, [1m6[0m: [1m4[0m, [1m7[0m: [1m4[0m, [1m8[0m: [1m4[0m, [1m9[0m: [1m5[0m, [1mOut[0m: [1m36[0m, [1mHole:[0m: [1mPar:[0m}, {[1m1[0m: [1m350[0m, [1m2[0m: [1m469[0m, [1m3[0m: [1m166[0m, [1m4[0m: [1m356[0m, [1m5[0m: [1m169[0m, [1m6[0m: [1m363[0m, [1m7[0m: [1m416[0m, [1m8[0m: [1m356[0m, [1m9[0m: [1m503[0m, [1mOut[0m: [1m3148[0m, [1mHole:[0m: [1mGold:[0m}, {[1m1[0m: [1m0[0m, [1m2[0m: [1m0[0m, [1m3[0m: [1m0[0m, [1m4[0m: [1m0[0m, [1m5[0m: [1m0[0m, [1m6[0m: [1m0[0m, [1m7[0m: [1m0[0m, [1m8[0m: [1m0[0m, [1m9[0m: [1m0[0m, [1mOut[0m: [1m0[0m, [1mHole:[0m: [1mGold (mayo 2023):[0m}, {[1m1[0m: [1m17[0m, [1m2[0m: [1m9[0m, [1m3[0m: [1m13[0m, [1m4[0m: [1m5[0m, [1m5[0m: [1m15[0m, [1m6[0m: [1m11[0m, [1m7[0m: [1m1[0m, [1m8[0m: [1m7[0m, [1m9[0m: [1m3[0m, [1mOut[0m: [1m[0m, [1mHole:[0m: [1mHandicap:[0m}, {[1m10[0m: [1m5[0m, [1m11[0m: [1m4[0m, [1m12[0m: [1m3[0m, [1m13[0m: [1m4[0m, [1m14[0m: [1m3[0m, [1m15[0m: [1m4[0m, [1m16[0m: [1m4[0m, [1m17[0m: [1m5[0m, [1m18[0m: [1m4[0m, [1mIn[0m: [1m36[0m, [1mHole:[0m: [1mPar:[0m, [1mTotal[0m: [1m72[0m}, {[1m10[0m: [1m503[0m, [1m11[0m: [1m347[0m, [1m12[0m: [1m162[0m, [1m13[0m: [1m380[0m, [1m14[0m: [1m164[0m, [1m15[0m: [1m354[0m, [1m16[0m: [1m371[0m, [1m17[0m: [1m539[0m, [1m18[0m: [1m327[0m, [1mIn[0m: [1m3147[0m, [1mHole:[0m: [1mGold:[0m, [1mTotal[0m: [1m6295[0m}, {[1m10[0m: [1m0[0m, [1m11[0m: [1m0[0m, [1m12[0m: [1m0[0m, [1m13[0m: [1m0[0m, [1m14[0m: [1m0[0m, [1m15[0m: [1m0[0m, [1m16[0m: [1m0[0m, [1m17[0m: [1m0[0m, [1m18[0m: [1m0[0m, [1mIn[0m: [1m0[0m, [1mHole:[0m: [1mGold (mayo 2023):[0m, [1mTotal[0m: [1m6067[0m}, {[1m10[0m: [1m8[0m, [1m11[0m: [1m18[0m, [1m12[0m: [1m14[0m, [1m13[0m: [1m2[0m, [1m14[0m: [1m16[0m, [1m15[0m: [1m10[0m, [1m16[0m: [1m12[0m, [1m17[0m: [1m6[0m, [1m18[0m: [1m4[0m, [1mIn[0m: [1m[0m, [1mHole:[0m: [1mHandicap:[0m, [1mTotal[0m: [1m[0m}]","teeBoxes":"[{[1mname[0m: [1mGold[0m, [1mslope[0m: [1m121[0m, [1mrating[0m: [1m70.5[0m}, {[1mname[0m: [1mGold (mayo 2023)[0m, [1mslope[0m: [1m120[0m, [1mrating[0m: [1m69.2[0m}]"},{"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":"-…