KAYAK Buzz Calendar API
Compare daily relative price bands for a city.
Copy for your AI agent
Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.
Overview
Compare daily relative price bands for a city. Use StayAPI with an X-API-Key through REST or MCP.
Scope
The response example is an illustrative excerpt. This is a city calendar with relative LOW, MEDIUM, and HIGH price bands. It does not return monetary prices, currency, or hotel availability. The source determines the dates; no date-range controls or pagination are supported.
Authentication
Send your StayAPI key in the X-API-Key header. Each successful request uses one credit and returns JSON; failures use RFC 7807 Problem Details.
Endpoint URL
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| city_id | string | Required | Positive ASCII decimal KAYAK city ID from Destination Lookup, range 1–2147483647 with no leading zero, such as 36014 for Paris. |
Response schema
| Field | Type | Description |
|---|---|---|
| success | boolean | True on success. |
| total | integer | Number of entries returned. |
| city_id | string | Requested KAYAK city identifier. |
| price_basis | string | Always relative; these are not price quotes. |
| calendar | array | Daily entries with date (YYYY-MM-DD) and price_level (LOW, MEDIUM, or HIGH). |
Errors and limitations
Errors use RFC 7807 Problem Details with provider: "kayak", an instance and correlation id.
- 400: invalid query, city identifier, or numeric limit outside 1–50.
- 422: required parameter missing or limit is not an integer.
- 401/402/429: authentication, credit, or rate-limit error.
- 502/503/504: source data temporarily unavailable or request could not complete. Errors are never returned as successful 2xx responses.