Overview

Retrieve cached public price data for a specific hotel and occupancy. This endpoint returns pricing information sourced from public booking platforms (e.g., Booking.com, Expedia) that has been pre-fetched and cached. It applies occupancy canonicalization automatically, so callers don't need to replicate that logic.

⚠️ Beta Feature: This endpoint is currently in beta. The API structure and behavior may change in future versions.

Rate Limiting: This endpoint is rate-limited to 10 requests per minute for both sandbox and production API keys. Exceeding this limit will result in a 429 Too Many Requests response.

When to Use

• Price comparison - Compare your negotiated rates against publicly available prices
• Rate validation - Verify that your offered rates are competitive before displaying to end users
• Market intelligence - Understand public pricing trends for specific hotels and dates

What You Get

• amount - The cached public price in the specified currency
• currency - Currency code (USD)
• source - The data collection source (e.g., google_hotels_brightdata_serp)
• provider - The OTA or booking platform where the price was found (e.g., Booking.com)
• fetchedAt - When the price was last retrieved from the source
• expiresAt - When this cached price expires and should no longer be used

Key Features

• Occupancy-specific - Prices are stored per occupancy configuration; query params must match write-time occupancy
• Negative cache aware - Returns 404 for both cache misses and negative cache entries (hotels with no public price found)
• Low latency - Direct Redis cache lookup, no upstream API calls

Parameters

• hotelId (required): The liteAPI hotel ID (e.g., lp36ad1)
• checkin (required): Check-in date in YYYY-MM-DD format
• checkout (required): Check-out date in YYYY-MM-DD format
• adults (required): Number of adult guests
• childrenAges (optional): Comma-separated ages of children (e.g., 5,8)
• currency (optional): Currency code; if present, must be USD