Skip to main content

DestinationSearchResponse

results object[]
  • Array [
  • placeIdstring

    Place UUID. Use as canonicalCityId in hotels/by-destination.

    namestring

    Place display name

    typestring

    Place type

    Possible values: [CITY, REGION, ZONE, AIRPORT, COUNTRY, POI]

    pathstring

    Full breadcrumb path excluding self (e.g. "Community of Madrid, Spain")

    hotelCountinteger

    Catchment hotel count for this placeId. Same set as POST /hotels/by-destination (mapped catalog, not occupancy). 0 for airports and places without hotels.

    productLabelstring

    Buyer-facing kind (City, Province, District, Resort, Island, Region, Airport, Landmark). Prefer this over raw type in UI badges.

    adminLevelinteger

    GeoNames ADM level when the place is an administrative ZONE/REGION.

    nearbyIncludedboolean

    True when a thin CITY expands to neighbouring cities in by-destination (same-country 30 km). False when a namesake tourism ZONE exists (catalog lookup, not only the current result set).

    catchmentRadiusKmnumber<double>

    Explicit catchment radius in km when the product surface is not a single municipality.

    latitudenumber<double>

    Center latitude

    longitudenumber<double>

    Center longitude

  • ]
  • DestinationSearchResponse
    {
    "results": [
    {
    "placeId": "string",
    "name": "string",
    "type": "CITY",
    "path": "string",
    "hotelCount": 0,
    "productLabel": "string",
    "adminLevel": 0,
    "nearbyIncluded": true,
    "catchmentRadiusKm": 0,
    "latitude": 0,
    "longitude": 0
    }
    ]
    }