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.

Pricing: $0.02 per request

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 best (lowest) cached public price for the stay in the specified currency
• nightlyAmount - The best (lowest) nightly public price
• nightlyRateWithFees / stayTotalWithFees - The best offer's nightly price and stay total including taxes and fees, when the source showed them
• currency - Currency code (USD)
• provider - Normalized provider identifier for the best offer (e.g., cheaptickets)
• rawObservedText - Raw observed price text from the source
• offers - Public price offers from multiple booking providers, each with its stay total including taxes and fees (stayTotalWithFees) when the source showed one
• 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 cache lookup, no upstream API calls

Parameters

• hotelId (required): The liteAPI hotel ID (e.g., lpec902)
• 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

{
  "data": {
    "hotelId": "lpec902",
    "checkin": "2026-08-24",
    "checkout": "2026-08-28",
    "amount": 156,
    "nightlyAmount": 39,
    "nightlyRateWithFees": 45.4,
    "stayTotalWithFees": 181.6,
    "currency": "USD",
    "provider": "cheaptickets",
    "rawObservedText": "39 USD",
    "adults": 2,
    "offers": [
      {
        "amount": 156,
        "nightly": 39,
        "stayTotalWithFees": 181.6,
        "provider": "cheaptickets",
        "rawProvider": "CheapTickets.com"
      }
    ],
    "fetchedAt": "2026-07-30T12:16:11.352517242Z",
    "expiresAt": "2026-08-24T23:59:59.999999999Z"
  }
}