Search hotels by semantic query (Beta)

Overview

Beta Feature - Search hotels using natural language queries. Uses AI to understand search intent and find hotels that match the meaning, not just keywords.

When to Use

  • Natural language search - Let users search with phrases like "romantic getaway in London"
  • Intent-based matching - Find hotels matching the vibe or style, not just location
  • Conversational search - Support natural language hotel discovery
  • Semantic matching - Get hotels that semantically match the query

What You Get

  • Matching hotels - Hotels that semantically match your query
  • Semantic attributes - Tags, persona, style, location_type, and story for each hotel
  • Relevance scores - How well each hotel matches the query
  • Hotel metadata - ID, name, photos, address, city, country

Example Queries

  • "Romantic getaway in London with Italian vibes"
  • "Hotels near Paris"
  • "Family-friendly beachfront hotels"

Quick Start

Provide a natural language query parameter. Returns hotels with semantic matching scores and attributes.

Note: This is a beta feature and may be subject to changes.

Query Params
string
required

Semantic search query. This can be a natural language description of what you're looking for, e.g. 'romantic getaway in london with italian vibes'

integer
≥ 1
Defaults to 3

Maximum number of results to return. Default is 3.

float
≥ 0
Defaults to 0

Minimum hotel rating to filter results. Default is 0 (no minimum rating filter).

Responses

Language
Credentials
Header
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json