hotels

Search hotels for a resolved place

Runs hotel.searchByPlace. The client resolves the destination to a placeId + coordinates first (same contract as the web autosuggest flow). Response fields the native client decodes: hotels[] (each with ref, name, starRating, userRating?, reviewCount?, address, city, country, latitude and longitude (always numbers, for the map), distanceKm?, images, amenities, and rooms holding at most the cheapest { price, currency, available, cancellationPolicy, mealPlan? }, a stay total); total, page, limit; priceStats and filteredPriceStats (null or { min, max, currency, buckets[] }, the stay-total distribution before and after the price filter); guestScoreCounts { scored, min7, min8, min9 }; relaxed (null, or { field } with field one of guestScore, stars, price, amenities, naming the one filter dropped because nothing matched them all — only when relaxFilters is sent); amenityFilter (null, or { requested, probed, matched, unchecked }, where unchecked hotels had no amenity data and were left out); radiusExpanded (null or { requestedKm, nearestKm }); the effective checkIn/checkOut/rooms/adults/children; and diagnostics/health.

post/v1/hotels/search

Request

  • Base URL: https://api.getmyhotels.com
  • URL: https://api.getmyhotels.com/v1/hotels/search
  • Auth: none declared

Request body

placeIdstring required
destinationstring
latnumber required
lngnumber required
checkInstring date required
checkOutstring date required
roomsinteger
adultsinteger
childreninteger
childrenAgesinteger[]
guestNationalitystring
pageinteger
limitinteger
hotelNamestring
minStarsinteger
minPricenumber
maxPricenumber
priceCurrency'USD' | 'GBP' | 'EUR' | 'INR'
minGuestScorenumber
relaxFiltersboolean
propertyTypestring
sortBy'best' | 'price' | 'rating' | 'distance'
sortOrder'asc' | 'desc'
currency'USD' | 'GBP' | 'EUR' | 'INR'
maxDistanceKmnumber
supplierCodesstring[]
previewOnlyboolean
amenitiesstring[]
preferPlaceCityboolean
seenHotelsstring[]

Response

Success

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.