Google Hotels Price Calendar Scraper

Google Hotels Price Calendar Scraper prices a hotel for a whole range of nights in a single request: up to 330 consecutive dates, each with the base rate, taxes, mandatory fees and total that Google Hotels shows. It is built for revenue managers tracking a compset, analysts studying seasonality, and apps that need a forward rate calendar without hammering Google one date at a time.

Powered by the ScraperCompany API: requests, proxies, retries and anti-bot handling run on ScraperCompany's servers, so you don't need your own proxies or API key. Start a run, get structured JSON.

Prefer to call it from your own code? The same data is available as the Google Hotels API, with per-call pricing and a free tier.

What can this scraper do?

• Price up to 330 nights per hotel in one request (the default run prices 30).
• Keeps base rate, taxes, fees and total separate, with the implied tax rate.
• Detects minimum-stay nights that Google otherwise shows as empty.
• Any currency and market, 1-8 adults, and a length of stay per quote.
• Optional source spot-checks that say which OTA a nightly price came from.
• Choose the native format or a SERP-compatible google_hotels_calendar response.

Modes

Mode	What it returns	Price per request
calendar	Nightly price (base, taxes, fees, total) for up to 330 consecutive nights	$0.008
serp	The same calendar in the standard SERP API google_hotels_calendar field names	$0.008

What data can you extract?

Field	Description
rates[].stay_date	Night being priced
rates[].rate / rate_base	Nightly price before taxes and fees
rates[].tax / fees	Taxes and mandatory fees for the night
rates[].rate_total	All-in nightly total
rates[].los / adults / currency / market	What the price was quoted for
unpriced_dates	Nights Google could not price (sold out or closed)
coverage	Priced nights out of requested nights
tax_profile	Implied tax rate and whether prices include tax in that market
calendar[]	SERP-format rows (date, price, extracted_price_total, ...) when Output format is SERP-compatible

Every dataset item also carries input (the exact request that was sent), request_id (quote it to support), billed and scraped_at.

How to use Google Hotels Price Calendar Scraper

1. Open Google Hotels Price Calendar Scraper in Apify Console and go to the Input tab.
2. Paste one or more Google Hotels property tokens. Get a token from the Google Hotels Search Scraper or from the ChUI... value in a Google Hotels URL.
3. Adjust the options if needed. Dates accept an exact date (2026-12-01) or a relative one (30 days from today), so saved tasks and schedules never go stale.
4. Click Start and wait for the run to finish.
5. Download the results from the Output tab as JSON, CSV, Excel or HTML, or fetch them with the Apify API.

Input example

This is the default input; running the Actor without changes uses it.

{
  "mode": "calendar",
  "propertyTokens": [
    "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ"
  ],
  "days": 30,
  "currency": "USD",
  "market": "US",
  "includeErrors": true,
  "maxConcurrency": 3,
  "maxRetries": 2
}

Output example

One dataset item per request (trimmed here; real items contain every field the API returns):

{
  "mode": "calendar",
  "endpoint": "/v1/calendar",
  "input": {
    "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "market": "US",
    "currency": "USD",
    "days": 30
  },
  "calendar_elapsed_s": 0.14,
  "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
  "coverage": "84/84",
  "elapsed_s": 0.31,
  "market": "US",
  "observed_at": "2026-08-07T01:23:45.678Z",
  "rates": [
    {
      "adults": 2,
      "currency": "USD",
      "fees": 25,
      "implied_tax_rate": 0.203217,
      "los": 1,
      "market": "US",
      "provenance": {
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "collector": "scrapingme.google_calendar",
        "derivation": "normalized_upstream",
        "egress_mode": "direct",
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-08-07T01:23:45.678Z",
        "price_basis": "room_base_before_taxes_and_fees",
        "requested_currency": "USD",
        "requested_market": "US",
        "returned_currency": "USD",
        "schema_version": 1,
        "source": "google_hotels_calendar",
        "source_kind": "calendar",
        "source_property_id": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
        "upstream_rate_id": null
      },
      "rate": 332.01,
      "rate_base": 332.01,
      "rate_total": 424.48,
      "rates_include_tax": false,
      "stay_date": "2026-08-04",
      "tax": 67.47
    }
  ],
  "requested_days": 90,
  "tax_profile": {
    "implied_tax_rate": 0.2032,
    "rates_include_tax": false
  },
  "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
  "unpriced_dates": [
    "2026-08-19"
  ],
  "validation": {
    "ok": true,
    "problems": []
  },
  "wire_bytes": 29804,
  "request_id": "req_3f9c0d6e2b8a4c1f9e7d5b3a1c0e8f6d",
  "billed": true,
  "scraped_at": "2026-10-01T14:03:27.512Z"
}

A request that fails is saved with an error message instead (turn off Include failed requests to skip those). Failed requests are never charged.

How much does it cost?

This Actor uses pay-per-event pricing: you pay for successful API requests, not for compute time.

Event	Charged when	Price	Per 1,000
calendar-request	One property priced for a range of nights (up to 330) in one request.	$0.008	$8.00
offers-page	One extra offers page, fetched per night for the "mainstream" price basis or per spot-check when you ask to verify sources.	$0.005	$5.00

For example, 1,000 hotel calendars (30, 90 or 330 nights each, same price) cost $8.00. Mainstream basis and source spot-checks add one offers-page event per extra page.

• Failed requests (errors, invalid input, blocked upstream after retries) are free.
• Requests where the source returns nothing at all (no results, nothing priced) are saved but not charged.
• Set Maximum cost per run when you start a run and the Actor stops cleanly before going over it.

FAQ

Do I need proxies or a ScraperCompany API key?

No. Proxy rotation, retries and anti-bot handling run on the ScraperCompany side, and the Actor is already connected to the API. You only pay the per-event prices above.

How do I find a Google Hotels property token?

Run the Google Hotels Search Scraper in Find property token mode with the hotel name and city, or copy the ChUI... token from a Google Hotels URL.

Why are some dates missing?

Nights Google cannot price (sold out, closed, or below a minimum stay) are listed in unpriced_dates. With minimum-stay detection on, two-night-minimum nights are re-asked and priced as such.

Does a longer range cost more?

No. One request prices the whole range for the same price, whether it is 1 night or 330.

How is this cheaper than one search per date?

A Google Hotels search prices one check-in date at a time, so 90 dates take 90 searches. This Actor returns all 90 nights (up to 330) for one hotel in a single request and a single charged event.

Can I monitor a competitor set every day?

Yes. Put every competitor's property token in one run, save it as a task and schedule it daily. Each night comes back with base rate, taxes, fees and total.

Is it legal to scrape this data?

The Actor collects publicly available information that anyone can see without logging in. You are responsible for how you use the results: respect the source site's terms, copyright and privacy law (such as GDPR) and do not collect personal data without a lawful basis. If in doubt, ask a lawyer.

What happens when a request is blocked or rate-limited?

Rate limits (HTTP 429) and temporary errors (5xx) are retried automatically with exponential backoff, respecting Retry-After. If a request still fails it is saved with the error message and not charged, and the rest of the batch keeps going. A run only fails when every request failed.

Why did a request return an error?

Read the error field: validation problems (for example a malformed date or an unknown id) are reported exactly as the API sees them. Fix the input and run again; failed requests cost nothing.

How many requests can I run at once?

Any number per run. The Actor sends up to 3 requests in parallel by default (change it under Run options); larger batches simply take longer.

Use it from your code

Call the Actor from any language through the Apify API. With the JavaScript client (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scrapercompany/google-hotels-calendar-scraper').call({
    "mode": "calendar",
    "propertyTokens": [
        "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ"
    ]
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

With Python (pip install apify-client):

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("scrapercompany/google-hotels-calendar-scraper").call(run_input={
    "mode": "calendar",
    "propertyTokens": ["ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ"],
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

You can also schedule runs, chain them with webhooks, or connect them to Make, Zapier, n8n, Google Sheets and other integrations from the Integrations tab.

Related scrapers

• Google Hotels Property Scraper
• Google Hotels Search Scraper
• ScraperCompany Hotel Rates (all-in-one)

Support

Questions, a field you need, or a site that stopped working? Open an issue on the Issues tab or contact us at scrapercompany.com. Include the request_id from the dataset item so we can trace the request.