Google Hotels Property Scraper

Google Hotels Property Scraper looks up a hotel on Google Hotels and returns what Google shows for it. OTA offers lists every booking site's price for a stay, from the official site to Booking.com, Expedia and Hotels.com, with taxes, fees and free-cancellation deadlines. Room matrix lines up room types across those sites. Stay price prices an exact check-in/check-out window, and Property details returns the address, phone, star class, amenities, rating and reviews breakdown. Ideal for rate parity monitoring, distribution audits and hotel data enrichment.

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?

• See every booking site's price for a stay, including the official site, with per-site taxes, fees and total.
• Spot free cancellation offers and their deadlines.
• Compare room types across sites in an aligned room matrix.
• Price an exact stay window with base, taxes, fees and total kept separate.
• Get property details: address, phone, GPS, star class, amenities, rating, review breakdown, images, nearby places.
• Any currency and market, 1-8 adults; batch as many properties as you like.

Modes

Mode	What it returns	Price per request
offers	Every booking site's price for one stay (official site, Booking.com, Expedia, ...), with taxes, fees and free cancellation	$0.005
rooms	Room types per booking site, aligned so the same room can be compared across sites	$0.005
stay	Google's price for one explicit stay window (base, taxes, fees, total)	$0.005
details	Name, address, phone, star class, amenities, rating, reviews breakdown, images, nearby places	$0.005

What data can you extract?

Field	Description
offers[].source / is_official	Booking site, and whether it is the hotel's official site (OTA offers)
offers[].price_per_night / total / tax / fees	Per-site price breakdown
offers[].has_free_cancellation / free_cancellation_until	Cancellation terms
lowest_price_per_night / price_insights	Cheapest offer and Google's typical price range
name / hotel_class / rating / reviews	Hotel identity and reputation
rows[] / sources[]	Room matrix: one row per room signature with each site's price (Room matrix)
rate / rate_total / tax / fees	Stay price breakdown (Stay price)
address / phone / gps_coordinates / amenities / images	Property details

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 Property Scraper

1. Open Google Hotels Property Scraper in Apify Console and go to the Input tab.
2. Paste one or more Google Hotels property tokens, choose a Mode and a check-in date (exact or relative such as 30 days).
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": "offers",
  "propertyTokens": [
    "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ"
  ],
  "check_in": "30 days",
  "check_out": "32 days",
  "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": "offers",
  "endpoint": "/v1/offers",
  "input": {
    "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "check_in": "2026-10-31",
    "market": "US",
    "currency": "USD"
  },
  "adults": 2,
  "check_in": "2026-09-14",
  "check_out": "2026-09-15",
  "coverage": 2,
  "currency": "USD",
  "currency_matches_request": true,
  "deal": "25% less than usual",
  "deal_description": "Prices are less than usual for your dates",
  "device": "iphone",
  "egress_geo_locked_ok": true,
  "egress_market": "US",
  "elapsed_s": 1.14,
  "has_deal": true,
  "hotel_class": "4-star hotel",
  "hotel_class_stars": 4,
  "lowest_price_per_night": 303.67,
  "missing_sources": [],
  "name": "Hilton Chicago",
  "nights": 1,
  "offers": [
    {
      "currency": "USD",
      "fees": null,
      "free_cancellation_time": "23:59",
      "free_cancellation_until": "2026-09-10",
      "has_free_cancellation": true,
      "is_official": true,
      "link": "https://www.google.com/aclk?...",
      "nights": 1,
      "price_per_night": 499.44,
      "price_per_night_before_taxes": 420.05,
      "provenance": {
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "collector": "scrapingme.google_property",
        "derivation": "normalized_upstream",
        "egress_mode": "market_proxy",
        "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_property_offers",
        "source_kind": "offer",
        "source_property_id": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
        "upstream_rate_id": null
      },
      "raw_source": "Hilton Chicago",
      "room_id": "rate-plan-42",
      "rooms": [
        {
          "beds": 1,
          "description": "1 bed",
          "free_cancellation_time": "23:59",
          "free_cancellation_until": "2026-09-10",
          "has_free_cancellation": true,
          "is_suite": false,
          "link": "https://www.google.com/aclk?...",
          "name": "1 KING BED",
          "price_before_taxes": 420.06,
          "price_total": 499.45,
          "thumbnail": "https://lh3.googleusercontent.com/..."
        }
      ],
      "source": "Official site",
      "tax": 79.39,
      "total": 499.44
    }
  ],
  "price_insights": {
    "lowest_price": 303.67,
    "price_level": "typical",
    "typical_price_range": {
      "high_price": "$521",
      "low_price": "$304"
    }
  },
  "price_insights_market_verified": true,
  "rates_include_tax": false,
  "rating": 4.3,
  "refundable_offers": 2,
  "requested_market": "US",
  "reviews": 10686,
  "rooms_total": 173,
  "sources": [
    "Official site",
    "Booking.com"
  ],
  "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
  "warnings": [],
  "wire_bytes": 4381263,
  "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
property-request	One property looked up for one stay: OTA offers, room matrix, stay price or property details.	$0.005	$5.00

For example, 1,000 requests in the default mode cost $5.00.

• 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.

Where do I get property tokens?

Use the Google Hotels Search Scraper: its destination search returns a property_token for every hotel, and its Find property token mode resolves a hotel name.

Why do OTA offers differ between runs?

Google varies the list of sites by device and moment. Set Device profiles to merge to 2 for a fuller list at the same price.

Which booking sites are included?

Every seller Google Hotels lists for the stay, usually the hotel's official site plus OTAs such as Booking.com, Expedia, Hotels.com and Agoda. Which sellers appear depends on the hotel, the dates and the country.

Can I check rate parity?

Yes. Compare the official site's price with each OTA for the same stay. For a direct check against the OTAs' own sites, use the Hotel Rate Parity Checker.

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-property-scraper').call({
    "mode": "offers",
    "propertyTokens": [
        "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ"
    ],
    "check_in": "30 days"
});
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-property-scraper").call(run_input={
    "mode": "offers",
    "propertyTokens": ["ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ"],
    "check_in": "30 days",
})
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 Price Calendar Scraper
• Google Hotels Search Scraper
• Hotel Price Comparison

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.