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.

{
  "data": [
    {
      "id": "lp5d8a7",
      "name": "Point Pleasant Inn & Resort",
      "main_photo": "https://example.com/hotel-photo.jpg",
      "address": "123 Main Street",
      "city": "Bristol",
      "country": "US",
      "tags": [
        "boutique hotel",
        "coastal retreat",
        "romantic getaway"
      ],
      "score": 0.7,
      "persona": "Discerning Couple",
      "style": "Classic Elegance",
      "location_type": "Waterfront Estate",
      "story": "Historic waterfront inn offering an exclusive and tranquil escape near local cultural attractions."
    }
  ]
}