Google Hotels API: Forward rate calendars and destination search

Endpoints

Example

Calendar, with POST /v1/calendar. Set SCRAPERCOMPANY_API_KEY to your key and run it; the full parameter list is in the API reference.

curl -X POST "https://api.scrapercompany.com/v1/calendar" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "market": "US",
    "currency": "USD",
    "days": 90
  }'

200 response

{
  "token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
  "market": "US",
  "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
  "observed_at": "2026-08-07T01:23:45.678Z",
  "requested_days": 90,
  "coverage": 0.9333,
  "elapsed_s": 0.31,
  "calendar_elapsed_s": 0.14,
  "unpriced_dates": [
    "2026-11-24"
  ],
  "validation": {
    "ok": true,
    "errors": [],
    "warnings": []
  },
  "tax_profile": {
    "rate": 0.2032,
    "confidence": "high",
    "itemised": 84,
    "derived": 0
  },
  "rates": [
    {
      "stay_date": "2026-11-09",
      "rate": 332.01,
      "rate_base": 332.01,
      "rate_total": 424.48,
      "tax": 67.47,
      "fees": 25,
      "currency": "USD",
      "market": "US",
      "rates_include_tax": false,
      "adults": 2,
      "los": 1,
      "implied_tax_rate": 0.203217,
      "provenance": {
        "schema_version": 1,
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-08-07T01:23:45.678Z",
        "source": "google_hotels_calendar",
        "source_kind": "calendar",
        "source_property_id": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
        "requested_market": "US",
        "requested_currency": "USD",
        "returned_currency": "USD",
        "price_basis": "room_base_before_taxes_and_fees",
        "derivation": "normalized_upstream"
      }
    }
  ]
}

Try it on your key

Good to know

One calendar call replaces one request per night.
Destination search returns about 20 properties a page with price, rating, class and amenity filters, each with the property token the calendar takes.
Offers and rooms break one night down by seller, the OTAs and the hotel's own site; offers cost 10 credits (14 with require_rooms).
SERP-compatible shapes are served at /v1/serp/google_hotels, /v1/serp/google_hotels_calendar and /v1/serp/google_hotels_property.