Categorías definidas una sola vez
La web y la API comparten las mismas categorías de apnea, buceo, snorkel, vida marina y cruceros de buceo.
API PÚBLICA · VERSIÓN 17
Una API de solo lectura para que la búsqueda de lugares, el mapa, las páginas de detalle y las futuras aplicaciones de iOS y Android usen las mismas categorías, precios, temporadas y datos de vida marina.
La web y la API comparten las mismas categorías de apnea, buceo, snorkel, vida marina y cruceros de buceo.
La paginación, los identificadores estables, las rutas canónicas y la cabecera de versión permiten guardar datos en caché y enlazar directamente a los detalles.
Las respuestas incluyen el nivel de perfil completo, de fuentes comprobadas o de directorio, junto con las fuentes, para distinguir los datos aún pendientes de revisión.
Rutas de la API
/api/v1/placesCombina país, actividad, vida marina, tipo de encuentro, mes, precio publicado, tipo de lugar y nivel de perfil.
/api/v1/places/{country}/{region}/{slug}Devuelve programas destacados, precios, temporadas, contactos, programas de vida marina, fuentes y calidad del perfil.
/api/v1/mapCoordenadas, filtros y datos de tarjetas organizados en una tabla de cadenas y tuplas. Los índices de los campos siguen el documento OpenAPI.
/api/v1/map/searchProgramas, precios, contactos y palabras clave multilingües que se cargan solo cuando el usuario busca.
/api/v1/map/fullUna ruta obsoleta que devuelve el objeto JSON completo. Las nuevas integraciones deben usar las rutas de datos esenciales y búsqueda.
/api/v1/spotsDevuelve, con coordenadas, solo los marcadores cuya temporada publicada incluye el mes elegido y que ofrecen un programa para ese animal.
/api/v1/toursFechas de anfitriones con fuentes revisadas que coinciden con el periodo solicitado, filtradas por fecha, región y actividad, con plazas disponibles según los participantes confirmados.
/api/v1/coverageIndica si cada una de las 249 entradas ISO 3166-1 está registrada, en actualización, suspendida por seguridad o excluida.
Consultas de ejemplo
/api/v1/places?iso=BE&kind=operator&limit=5Programas de ballenas jorobadas en Japón en febrero/api/v1/places?iso=JP&animal=%ED%98%B9%EB%93%B1%EA%B3%A0%EB%9E%98&month=2&limit=20Buceo con precio publicado/api/v1/places?activity=scuba-diving&published_price=true&limit=20Perfiles con fuentes oficiales comprobadas/api/v1/places?profile_tier=verified&limit=20Puntos de tiburón ballena en marzo/api/v1/spots?month=3&marine_life=%EA%B3%A0%EB%9E%98%EC%83%81%EC%96%B4&limit=20Excursiones con reservas abiertas en Jeju en septiembre/api/v1/tours?start_date=2026-09-01&end_date=2026-09-30®ion=%EC%A0%9C%EC%A3%BC&open_only=1Cruceros de buceo/api/v1/places?liveaboard=true&limit=20Los precios publicados, las temporadas, los horarios y los avistamientos pueden cambiar. Las aplicaciones y los servicios externos deben mostrar la URL de la fuente, la fecha de consulta y la calidad del perfil, y consultar de nuevo el sitio oficial del operador antes de reservar. Esta API no copia textos ni puntuaciones de reseñas de Google.