# Google Hotels calendar (SERP-compatible): `POST /v1/serp/google_hotels_calendar`

Cost: 8 credits (8 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/serp-google-hotels-calendar

No SERP API equivalent — a whole forward horizon in one call.

Other SERP APIs bill one request per stay date; this returns ~330 nights in a
single ~105 KB response. `extracted_price_before_taxes` uses the standard SERP API base-plus-mandatory-fees basis; `extracted_price_base` and `fees` preserve
the itemised values.

Request body (JSON):

- `property_token` (string; required; min length 8): Google property token, as returned by `/v1/search`.
- `days` (integer; optional; default 90; min 1, max 330): Nights to price in one call. Max 330.
- `start` (string (date) | null; optional): First stay date. Defaults to tomorrow.
- `adults` (integer; optional; default 2; min 1, max 8): Adults in the room. Two is the hotel default; pass one for a hostel, which is priced per bed. Any value 1-8 works.
- `currency` (string; optional; default USD; one of AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, CZK, DKK, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MXN, MYR, NOK, NZD, PEN, PHP, PLN, QAR, RON, SAR, SEK, SGD, THB, TRY, TWD, USD, VND, ZAR): ISO 4217 code for the returned prices. Major currencies include AED, AUD, BRL, CAD, CHF, CNY, EUR, GBP, HKD, INR, JPY, KRW, MXN, NZD, SGD, USD; all 39 supported codes are listed in the enum.
- `gl` (string; optional; default us; one of ad, ae, af, ag, ai, al, am, ao, aq, ar, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, bi, bj, bl, bm, bn, bo, bq, br, bs, bt, bv, bw, by, bz, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, co, cr, cu, cv, cw, cx, cy, cz, de, dj, dk, dm, do, dz, ec, ee, eg, eh, er, es, et, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, in, io, iq, ir, is, it, je, jm, jo, jp, ke, kg, kh, ki, km, kn, kp, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ly, ma, mc, md, me, mf, mg, mh, mk, ml, mm, mn, mo, mp, mq, mr, ms, mt, mu, mv, mw, mx, my, mz, na, nc, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, pa, pe, pf, pg, ph, pk, pl, pm, pn, pr, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, sd, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, ss, st, sv, sx, sy, sz, tc, td, tf, tg, th, tj, tk, tl, tm, tn, to, tr, tt, tv, tw, tz, ua, ug, uk, um, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, xk, ye, yt, za, zm, zw): Two-letter country for the request.
- `los` (integer; optional; default 1; min 1, max 30): Length of stay each night is priced at. The per-night figure genuinely moves with LOS.

Response fields:

- `search_parameters` (object; required)
  - `search_parameters.engine` (string; required; one of google_hotels_calendar)
  - `search_parameters.property_token` (string; required)
  - `search_parameters.days` (integer; required)
  - `search_parameters.adults` (integer; required)
  - `search_parameters.currency` (string; required)
  - `search_parameters.gl` (string; required)
  - `search_parameters.los` (integer; required)
- `calendar` (array of object; required): One row per priced night.
  - `calendar[].date` (string (date); required)
  - `calendar[].price` (object; required): The market-correct nightly figure (same as `rate` on `/v1/calendar`).
  - `calendar[].extracted_price_before_taxes` (number | null; required): Base + mandatory fees (SERP API basis).
  - `calendar[].extracted_price_base` (number | null; required)
  - `calendar[].extracted_price_total` (number | null; required)
  - `calendar[].tax` (number | null; required)
  - `calendar[].fees` (number | null; required)
  - `calendar[].currency` (string; required)
  - `calendar[].rates_include_tax` (boolean; required)
  - `calendar[].provenance` (object; required): Provenance of one calendar row.
- `unavailable_dates` (array of string (date); required)
- `tax_profile` (object | null; required)
  - `tax_profile.rate` (number; required)
  - `tax_profile.confidence` (string; required; one of high, low, none)
- `meta` (object; required)
  - `meta.coverage` (number; required): Share of requested nights priced, 0-1.
  - `meta.collection_id` (string; required)
  - `meta.observed_at` (string; required)
  - `meta.elapsed_s` (number; required)
  - `meta.retries` (integer; required)

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
