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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
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
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json