Get price index for hotels

Overview

Retrieve historical price index data for a list of hotels. Returns average per-night prices aggregated by calendar day, allowing you to analyze pricing trends and patterns.

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

Pricing: $0.05 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 trend analysis - Analyze how hotel prices change over time
• Price forecasting - Use historical data to predict future pricing
• Market research - Compare pricing across multiple hotels
• Pricing dashboards - Build visualizations of hotel price trends

What You Get

• Per-night prices - Average price per night for each calendar day
• Daily aggregation - One entry per day with aggregated pricing data
• Multiple hotels - Query up to 50 hotels in a single request
• Future dates only - Only returns data for future check-in dates (defaults to today onwards)

Key Features

• Per-night pricing - Prices are normalized to per-night rates regardless of stay duration
• Daily aggregation - Each day has a single entry with the average per-night price across all stays that include that day
• Future-focused - Only queries check-in dates in the future by default
• Flexible date ranges - Optional date filtering with sensible defaults
• Hotel limit - Maximum 50 hotel IDs per request

Parameters

• hotelIds (required): Comma-separated list of hotel IDs. Maximum 50 hotel IDs allowed.
• fromDate (optional): Start date in YYYY-MM-DD format. Defaults to today.
• toDate (optional): End date in YYYY-MM-DD format. Defaults to 1 year from today.