Skip to main content
Use this pageChatGPTClaudeCursor · OpenAPI · MCP

Get hotels by destination (canonical city)

POST 
/content/hotels/v1/hotels/by-destination

Returns hotels whose canonical_city_id is in the catchment of destination.canonicalCityId (any place type: CITY, REGION, ZONE).

Catchment (same function as advertised hotelCount on search-destination):

  • dense CITY (≥2500 mapped hotels): that city only
  • thin CITY: same-country neighbours within 30 km, unless a namesake tourism ZONE exists
  • REGION / admin ZONE / district ZONE (parent CITY): parent_id descendants
  • tourism ZONE with overlay relationships: those member cities
  • tourism ZONE with no overlay and no curated radius: empty (no 50 km halo)
  • landmark ZONE with spatial_radius_km: that radius only, if the tree is empty

outputCodeType:

  • "provider" (default): Each hotel has providerHotelCode only.
  • "bundleport": Each hotel has providerHotelCode and bundleportHotelCode (base code) when mapped.

When outputCodeType is "bundleport" and scope.providerCode is omitted: hotels from all providers are returned and mappings are resolved per provider. The internal key used for bundleport codes is providerCode:providerHotelCode (e.g. example:12345). Stats (mapped/unmapped) are aggregated across providers.

Request​

Responses​

Successful response