Google Hotels Price Calendar API Documentation

GET /api/v1/search?engine=google_hotels_price_calendar

The Google Hotels Price Calendar API returns the price Google Hotels shows for a property on every check-in date in a range, the same prices as the date picker on the property's Prices tab. Each day prices a stay of nights nights starting on that date, and the cheapest stays are marked with is_lowest_price.

Days without a price come back with their dates only. Google Hotels lists prices up to roughly 11 months ahead. The nightly price strings are the date picker's labels, so they can be shortened (¥31.2K) or leave out the currency symbol. Read extracted_price together with currency. To see the offers for a stay, pass its check_in_date and check_out_date to the Google Hotels Property API with the same property_token, adults, children_ages, currency and gl.

API Parameters

Search Query

Name

property_token

Required

Required

Description

Parameter defines the property whose prices you want. You can find property_token values using Google Hotels API, Google Hotels Property API, Google Hotels Autocomplete API or Google Local API.

Date Range

Name

check_in_date_start

Required

Optional

Description

The first check-in date of the calendar in the format YYYY-MM-DD. It cannot be in the past. Defaults to today (UTC).
Name

check_in_date_end

Required

Optional

Description

The last check-in date of the calendar in the format YYYY-MM-DD, at most 364 days after check_in_date_start. Defaults to 30 days after check_in_date_start.
Name

nights

Required

Optional

Description

The length of the stay priced for each check-in date, from 1 to 30 nights.

Localization

Name

gl

Required

Optional

Description

Defines the country of the search. Some countries show prices before taxes next to the total, others show only the total including taxes. Check the full list of supported Google Travel gl countries.
Name

hl

Required

Optional

Description

Defines the interface language of the search. Check the full list of supported Google Travel hl languages.
Name

currency

Required

Optional

Description

Defines the currency of the returned prices. Check the full list of supported Google Travel currency values.

Number of Guests

Name

adults

Required

Optional

Description

The number of adults staying at the property. The total number of adults and children cannot exceed 10.
Name

children_ages

Required

Optional

Description

Defines the ages of children as a comma-separated list, e.g., 2,5 for two children aged 2 and 5. Available age range is 1 to 17, with at most 5 children.

Engine

Name

engine

Required

Required

Description

Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_hotels_price_calendar.

API key

Name

api_key

Required

Required

Description

The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

Name

zero_retention

Enterprise Only

Enterprise Only

Required

Optional

Description

Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

GET

https://www.searchapi.io/api/v1/search?engine=google_hotels_price_calendar&property_token=ChkIsL6Z-KPh0eJyGg0vZy8xMWJ0djZjbTIxEAE

Request

import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_hotels_price_calendar",
  "property_token": "ChkIsL6Z-KPh0eJyGg0vZy8xMWJ0djZjbTIxEAE"
}

response = requests.get(url, params=params)
print(response.text)

Response

{
  "search_metadata": {
    "id": "search_KLXZmzQn3CTEDXfjfrNqZaxt",
    "status": "Success",
    "created_at": "2026-10-27T15:06:32Z",
    "request_time_taken": 1.22,
    "parsing_time_taken": 0.14,
    "total_time_taken": 1.36,
    "request_url": "https://www.google.com/travel/search?qs=CAEyJ0Noa0lzTDZaLUtQaDBlSnlHZzB2Wnk4eE1XSjBkalpqYlRJeEVBRTgN...",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_KLXZmzQn3CTEDXfjfrNqZaxt.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_KLXZmzQn3CTEDXfjfrNqZaxt"
  },
  "search_parameters": {
    "engine": "google_hotels_price_calendar",
    "property_token": "ChkIsL6Z-KPh0eJyGg0vZy8xMWJ0djZjbTIxEAE",
    "check_in_date_start": "2026-10-27",
    "check_in_date_end": "2026-11-26",
    "nights": 1,
    "adults": 2,
    "currency": "USD",
    "gl": "US",
    "hl": "en"
  },
  "calendar": [
    {
      "check_in_date": "2026-10-27",
      "check_out_date": "2026-10-28",
      "price_per_night": {
        "price": "$407",
        "extracted_price": 407,
        "price_before_taxes": "$352",
        "extracted_price_before_taxes": 352
      },
      "total_price": {
        "price": "$407",
        "extracted_price": 407,
        "price_before_taxes": "$352",
        "extracted_price_before_taxes": 352
      },
      "currency": "USD"
    },
    {
      "check_in_date": "2026-10-28",
      "check_out_date": "2026-10-29",
      "price_per_night": {
        "price": "$372",
        "extracted_price": 372,
        "price_before_taxes": "$321",
        "extracted_price_before_taxes": 321
      },
      "total_price": {
        "price": "$372",
        "extracted_price": 372,
        "price_before_taxes": "$321",
        "extracted_price_before_taxes": 321
      },
      "currency": "USD"
    },
    {
      "check_in_date": "2026-10-29",
      "check_out_date": "2026-10-30",
      "price_per_night": {
        "price": "$265",
        "extracted_price": 265,
        "price_before_taxes": "$228",
        "extracted_price_before_taxes": 228
      },
      "total_price": {
        "price": "$265",
        "extracted_price": 265,
        "price_before_taxes": "$228",
        "extracted_price_before_taxes": 228
      },
      "currency": "USD"
    },
    "...",
    {
      "check_in_date": "2026-11-22",
      "check_out_date": "2026-11-23",
      "price_per_night": {
        "price": "$181",
        "extracted_price": 181,
        "price_before_taxes": "$155",
        "extracted_price_before_taxes": 155
      },
      "total_price": {
        "price": "$181",
        "extracted_price": 181,
        "price_before_taxes": "$155",
        "extracted_price_before_taxes": 155
      },
      "currency": "USD",
      "is_lowest_price": true
    },
    "..."
  ]
}

Week-Long Stays in Euros

GET

https://www.searchapi.io/api/v1/search?currency=EUR&engine=google_hotels_price_calendar&gl=FR&nights=7&property_token=ChgI5sC219yo3969ARoLL2cvMXY4aF9yYmoQAQ

Request

import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_hotels_price_calendar",
  "property_token": "ChgI5sC219yo3969ARoLL2cvMXY4aF9yYmoQAQ",
  "nights": 7,
  "gl": "FR",
  "currency": "EUR"
}

response = requests.get(url, params=params)
print(response.text)

Response

{
  "calendar": [
    {
      "check_in_date": "2026-10-27",
      "check_out_date": "2026-11-03",
      "price_per_night": {
        "price": "€236",
        "extracted_price": 236
      },
      "total_price": {
        "price": "€1,649",
        "extracted_price": 1649
      },
      "currency": "EUR"
    },
    {
      "check_in_date": "2026-10-28",
      "check_out_date": "2026-11-04",
      "price_per_night": {
        "price": "€231",
        "extracted_price": 231
      },
      "total_price": {
        "price": "€1,618",
        "extracted_price": 1618
      },
      "currency": "EUR"
    },
    {
      "check_in_date": "2026-10-29",
      "check_out_date": "2026-11-05",
      "price_per_night": {
        "price": "€263",
        "extracted_price": 263
      },
      "total_price": {
        "price": "€1,842",
        "extracted_price": 1842
      },
      "currency": "EUR"
    },
    "...",
    {
      "check_in_date": "2026-11-08",
      "check_out_date": "2026-11-15",
      "price_per_night": {
        "price": "€169",
        "extracted_price": 169
      },
      "total_price": {
        "price": "€1,183",
        "extracted_price": 1183
      },
      "currency": "EUR",
      "is_lowest_price": true
    },
    "..."
  ]
}