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.

{
  "data": [
    {
      "id": "lp1e4de",
      "name": "The Level Hotel",
      "address": "123 Main Street",
      "city": "Madrid",
      "country": "es",
      "rating": 8.53,
      "rooms": [
        {
          "room_name": "The Level Double Or Twin Room - Mountain View",
          "image_url": "https://static.cupid.travel/rooms-large-pictures/94833838.jpg",
          "similarity": 0.29541015625
        }
      ]
    }
  ]
}