# Google Hotels property (SERP-compatible): `POST /v1/serp/google_hotels_property`

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

Drop-in shape for the standard SERP API google_hotels_property.

Repointing an existing integration is a base-URL change. `extracted_price`
is populated where SERP API may omit it, and prices are exact floats
rather than rounded integers.

Request body (JSON):

- `property_token` (string; required; min length 8): Google property token — The standard SERP API name for the same value `/v1/search` returns as `token`.
- `check_in_date` (string (date); required): First night of the stay, `YYYY-MM-DD`.
- `check_out_date` (string (date); required): Departure date. Must be after `check_in_date`.
- `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 Google request, the standard SERP API spelling of `market`.
- `property_name` (string; optional; default ): Optional. Improves official-site detection when the hotel's own row is labelled with its brand name.
- `sources` (array of string | null; optional; min items 1, max items 20): Optional seller allowlist. Names are canonicalized, so `Expedia.com` and `Expedia` are equivalent. Omit for all Google sellers.
- `source_coverage` (string; optional; default full; one of adaptive, full): `full` starts iPhone and desktop fetches in parallel for maximum breadth. `adaptive` starts with iPhone and fetches desktop only when a requested seller is absent.

Response fields:

- `search_parameters` (object; required)
  - `search_parameters.engine` (string; required; one of google_hotels_property)
  - `search_parameters.property_token` (string; required)
  - `search_parameters.check_in_date` (string (date); required)
  - `search_parameters.check_out_date` (string (date); required)
  - `search_parameters.adults` (integer; required)
  - `search_parameters.currency` (string; required)
  - `search_parameters.gl` (string; required)
  - `search_parameters.nights` (integer; required)
  - `search_parameters.sources` (array of string; optional): Present only when `sources` was requested.
  - `search_parameters.source_coverage` (string; optional): Present only when `sources` was requested.
- `property` (object; required)
  - `property.property_token` (string; required)
  - `property.name` (string; required)
  - `property.hotel_class` (string; required)
  - `property.hotel_class_stars` (integer | null; required)
  - `property.rating` (number | null; required)
  - `property.reviews` (integer | null; required)
  - `property.deal` (string | null; required)
  - `property.deal_description` (string | null; required)
  - `property.has_deal` (boolean; required)
  - `property.price_insights` (object; required)
  - `property.all_offers` (array of object; required)
  - `property.featured_offers` (array of object; required): Offers Google rendered as featured cards.
  - `property.price_per_night` (object | null; required): Lowest all-in nightly price across offers.
  - `property.provenance` (object | null; required): Provenance of the lowest-priced offer.
  - `property.currency_verified` (boolean; required)
  - `property.requested_market` (string; required)
  - `property.egress_market` (string | null; required)
  - `property.egress_geo_locked_ok` (boolean; required)
  - `property.price_insights_market_verified` (boolean; required)
  - `property.tax_profile` (object | null; required)
- `meta` (object; required)
  - `meta.elapsed_s` (number; required)
  - `meta.offers` (integer; required)
  - `meta.priced` (integer; required)
  - `meta.property_fetch` (string; required)
  - `meta.tax_profile_cache` (string; 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)
