---
title: "Semantic hotel search by text query"
method: GET
path: "/data/hotel/search"
tags: ["Hotels"]
---

# Semantic hotel search by text query

`GET /data/hotel/search`

## Request

- Base URL: `https://api.liteapi.travel/v3.0`
- URL: `https://api.liteapi.travel/v3.0/data/hotel/search`
- Auth: API key in header `X-API-Key`

Search for a hotel using a semantic text query. Returns the best-matching hotel with basic details and a relevance score.

## Query parameters

- `query` string, required

## Response `200`

OK

- object
  - `data` object
    - `id` string, required: LiteAPI hotel ID
    - `name` string, required: Hotel name
    - `hotelDescription` string: Hotel description
    - `city` string, required: City
    - `country` string, required: Country code
    - `latitude` number, required: Latitude
    - `longitude` number, required: Longitude
    - `address` string: Address
    - `zip` string: ZIP code
  - `score` number: Semantic search relevance score (0-1)

## Other responses

- `400`: Bad Request
- `404`: No match found

---

[API](https://skmtc.dev/liteapi/apis/api-hotel-data.md) - [All operations](https://skmtc.dev/liteapi/apis/api-hotel-data/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-hotel-data/revisions/f89f11b63949?raw)