v1

latestOpenAPI 3.1.12026-07-134817.5 KB

Semantic hotel search

Advanced semantic search using natural language queries to find hotels matching traveler intent, mood, and preferences. Returns hotels with relevance scores and semantic attributes.

post/api/actions/search-semantic

Request body

querystring required

Natural language search query (e.g., 'romantic getaway in Paris with spa', 'family-friendly beach resort in Bali')

limitinteger

Maximum number of results to return

includeRatesboolean

Include real-time pricing when dates are provided

checkinstring date

Check-in date (YYYY-MM-DD)

checkoutstring date

Check-out date (YYYY-MM-DD)

adultsinteger

Number of adults

childreninteger[]

Ages of children

currencystring

Currency code for pricing

languagestring

Language code for results

guestNationalitystring

ISO 3166-1 alpha-2 country code of guest nationality

Response

Semantic search results with relevance scores