Search hotel rooms by image and text (Beta)

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.