---
title: "Search hotels by semantic query (Beta)"
method: GET
path: "/data/hotels/semantic-search"
tags: ["Hotels"]
---

# Search hotels by semantic query (Beta)

`GET /data/hotels/semantic-search`

## 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 parameters

- `query` string, required
- `limit` integer
- `min_rating` number, float

## Response `200`

OK

- object
  - `data` object[]
    - `id` string, required — LiteAPI hotel ID
    - `name` string, required — Hotel name
    - `main_photo` string — URL of the main hotel photo
    - `address` string — Hotel address
    - `city` string — City where the hotel is located
    - `country` string — Country code where the hotel is located
    - `tags` string[] — Semantic tags describing the hotel
    - `score` number, float — Relevance score (0-1) indicating how well the hotel matches the query, rounded to 2 decimals
    - `persona` string — Target persona for this hotel
    - `style` string — Style of the hotel
    - `location_type` string — Type of location
    - `story` string — Narrative description of the hotel

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/liteapi/apis/api-search.md) · [All operations](https://skmtc.net/liteapi/apis/api-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liteapi/api-search/versions/315ba2a4dcf4/schema)