Skip to main content
Use this pageChatGPTClaudeCursor · OpenAPI · MCP

Search destinations with contextual expansion

POST 
/content/hotels/v1/places/search-destination

Smart destination search that returns a flat, relevance-ranked list of places. Ranking is owned by this API — clients must not re-sort results except for display grouping. Order is: exact query pin (destination_query_pins, EXACT folded query only) → text-match priority → locale hint → query specificity → district ZONE behind sibling CITY → resort rule (thin CITY + same-name tourism ZONE; district/admin ZONEs do not count) → CITY-first tie-break → hotelCount.

hotelCount is the catchment stored in place_hotel_counts. Thin vs dense and nearbyIncluded use direct hotel counts plus catalog namesake tourism ZONEs (admin_level NULL, parent is not CITY), not only rows in the current result set.

productLabel is the buyer-facing kind (City, Province, District, Resort, Island, Region, Airport) — do not infer ADM1 vs ADM2 from type alone. locale is a ranking hint, never a filter. countryCode is ignored.

The placeId can be used directly with POST /hotels/by-destination.

Request​

Responses​

Ranked destination results