Get aggregated price index for a city

Overview

Retrieve aggregated historical price index data for all hotels in a specific city. Returns average per-night prices aggregated by calendar day across all hotels in the city, providing city-level pricing trends.

⚠️ 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

• City-level price analysis - Analyze average pricing trends for an entire city
• Market research - Compare pricing across different cities
• Destination pricing - Get aggregated pricing data for a destination
• City pricing dashboards - Build visualizations of city-level price trends

What You Get

• City-level aggregation - Average prices aggregated across all hotels in the city (up to 1,000 hotels)
• Per-night prices - Average price per night for each calendar day
• Daily aggregation - One entry per day with aggregated pricing data
• Future dates only - Only returns data for future check-in dates (defaults to today onwards)

Key Features

• Automatic hotel discovery - Automatically finds hotels in the specified city (up to 1,000)
• City-level aggregation - Prices are averaged across all hotels in the city, not per hotel
• Per-night pricing - Prices are normalized to per-night rates
• Future-focused - Only queries check-in dates in the future by default
• Flexible date ranges - Optional date filtering with sensible defaults

Parameters

• countryCode (required): ISO-2 country code (e.g., 'US', 'GB', 'FR')
• cityName (required): City name (case-insensitive)
• 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.