Categories defined once
The web and the API share the same freediving, scuba diving, snorkeling, marine life and liveaboard categories.
PUBLIC API · VERSION 17
Shared by web and mobile:
the Maptlantis data contract
A read-only API, so that place search, the map, detail pages and future iOS and Android apps all use the same categories, prices, seasons and marine life data.
Ready for mobile
Pagination, stable IDs, canonical detail paths and an API version header let apps cache the data and deep-link into it.
Profile tier included
Responses carry the complete, verified or directory tier with the sources, so unchecked data is never handled as if it were finished.
Endpoints
Public read API
/api/v1/placesSearch, filters and pagination
Combine country, activity, marine life, encounter type, month, published price, place type and profile tier.
/api/v1/places/{country}/{region}/{slug}Operator and place detail
Returns featured programs, prices, seasons, contacts, marine life programs, sources and profile quality.
/api/v1/mapCore wire data for mobile maps
Coordinates, filters and card data packed into a string pool and tuples. Field indexes follow the OpenAPI document.
/api/v1/map/searchSearch index, loaded on demand
Programs, prices, contacts and multilingual keywords, loaded lazily only when the user searches.
/api/v1/map/fullLegacy client route
A deprecated route that returns the full JSON object. New integrations should use the core and search routes.
/api/v1/spotsSpots by month and marine life season
Returns, with coordinates, only the markers whose published season includes the chosen month and that run a program for that animal.
/api/v1/toursPublic tour dates and open spots
Dates from source-checked hosts that overlap the requested period, narrowed by date, region and activity, with live open spots based on confirmed guests.
/api/v1/coverageWorldwide coverage
Whether each of the 249 ISO 3166-1 entries is listed, being updated, on hold for safety or excluded.
Example queries
Try it now
5 operators in Belgium
/api/v1/places?iso=BE&kind=operator&limit=5Humpback whale programs in Japan in February/api/v1/places?iso=JP&animal=%ED%98%B9%EB%93%B1%EA%B3%A0%EB%9E%98&month=2&limit=20Scuba diving with a published price/api/v1/places?activity=scuba-diving&published_price=true&limit=20Profiles in the verified tier (official sources)/api/v1/places?profile_tier=verified&limit=20Whale shark spots in March/api/v1/spots?month=3&marine_life=%EA%B3%A0%EB%9E%98%EC%83%81%EC%96%B4&limit=20Tours taking bookings in Jeju in September/api/v1/tours?start_date=2026-09-01&end_date=2026-09-30®ion=%EC%A0%9C%EC%A3%BC&open_only=1Liveaboards/api/v1/places?liveaboard=true&limit=20Before you use the data
Published prices, seasons, opening hours and wildlife sightings can change. Apps and outside services should show the source URL, check date and profile quality with the data, and check the operator’s own official page again before booking. This API does not copy Google review text or ratings.