POSTHotel Search
Search for hotel award availability. Returns hotels with points pricing, cash pricing, and transfer partner details.
POST https://ai-api.pointsyeah.com/hotel/explorer/search
Parameters
ParameterValue
locationobjectrequired
Search location.
labelstringrequired
Display label, e.g. "New York, NY"
valuestringrequired
Location value, e.g. "New York, NY"
longitudenumberrequired
Longitude coordinate.
latitudenumberrequired
Latitude coordinate.
distancenumberrequired
Search radius in meters.Default: 30000
dest_typestringrequired
Destination type: city, country, airport.
country_codestringrequired
ISO country code, e.g. "US".
start_datedate
Check-in date, YYYY-MM-DD.
end_datedate
Check-out date, YYYY-MM-DD.
weekend_onlyboolean
Only return weekend stays.Default: false
holiday_onlyboolean
Only return holiday stays.Default: false
max_pointsnumber
Maximum points required.Default: 200000
max_pricesnumber
Maximum cash price in USD.Default: 5000
amenitiesarray
Amenity filters (e.g. pet_friendly, resort).
programsarray
Hotel loyalty programs (e.g. ihg, hyatt, marriott, hilton).
brandsarray
Brand filters. Each item: { program, code }.
free_night_certificatearray
Free night certificate filters.
suit_onlyboolean
Only return suites.Default: false
sortstring
Sort order.Default: points
points-pointscash-cashdistancecpp-updated_atmiles
tagarray
Tag filters (e.g. City, Beach, Boutique, Family, Romance).
fhrboolean
Filter for Fine Hotels & Resorts properties.Default: false
fhr_creditarray
FHR credit filters.
fhr_offerstring
FHR offer filter.
fhr_labelarray
FHR label filters.
paginationobjectrequired
Pagination controls.
pagenumberrequired
Page number (1-based).Default: 1
page_sizenumberrequired
Results per page.Default: 10