---
title: "Search hotel rooms by image and text (Beta)"
method: GET
path: "/data/hotels/room-search"
tags: ["Hotels"]
---

# Search hotel rooms by image and text (Beta)

`GET /data/hotels/room-search`

## Overview

**Beta Feature** - Search hotel rooms using visual and text-based queries. Uses image search technology to match your query against room images and find hotels with rooms that match your visual preferences, amenities, or style.

## When to Use

- **Visual room search** - Find rooms based on visual characteristics like "luxury modernist comfort" or "blue accessible bathroom"
- **Style-based search** - Search for rooms by design style like "art deco hotel room" or "brutalist room"
- **Amenity-focused search** - Find rooms with specific features like "twin room with a city view" or "room with a skylight"
- **Geographic filtering** - Limit results to hotels near a specific location using coordinates or Place ID
- **City and country filtering** - Filter results by city and/or country

## What You Get

- **Matching hotels** - Hotels grouped by hotel ID with rooms that match your query
- **Room details** - Room name, image URL, and similarity score (rounded to 3 decimals) for each matching room
- **Hotel metadata** - ID, name, address, city, country, and rating for each hotel
- **Geographic filtering** - Optionally limit results to a specific area using coordinates or Place ID
- **City and country filters** - Filter results by city and/or country code

## Example Queries

- "luxury modernist comfort"
- "an extremely fun room or art deco hotel room"
- "luxurious accessible bathroom or blue accessible bathroom with walk in shower"
- "twin room with a city view"
- "a room filled with paintings"
- "a hotel room with a skylight"

## Geographic Filtering

You can optionally limit search results to a specific geographic area:

- **Using coordinates**: Provide `latitude`, `longitude`, and optionally `radius` (in kilometers, default: 12km)
- **Using Place ID**: Provide `placeId` - the place's location will be automatically fetched and the search will use the place's viewport boundaries (or the provided `radius` if viewport is unavailable)
- **Using city/country**: Provide `city` and/or `country` to filter results by location

## Quick Start

Provide a `query` parameter describing the room you're looking for. Optionally add geographic filtering with `latitude`/`longitude` or `placeId` to limit results to a specific area.

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

## Query parameters

- `query` string, required
- `limit` integer
- `placeId` string
- `latitude` number, float
- `longitude` number, float
- `radius` number, float
- `city` string
- `country` string

## Response `200`

OK

- object
  - `data` object[]
    - `id` string, required — LiteAPI hotel ID
    - `name` string, required — Hotel name
    - `address` string — Hotel address
    - `city` string — City where the hotel is located
    - `country` string — Country code where the hotel is located
    - `rating` number, float — Hotel rating
    - `rooms` object[] — Array of rooms matching the search query
      - `room_name` string — Name of the room
      - `image_url` string — URL of the room image
      - `similarity` number, float — Similarity score indicating how well the room matches the query

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