Skip to content
Docs

Google Hotels property (SERP-compatible)

Drop-in shape for the standard SERP API google_hotels_property.

POST/v1/serp/google_hotels_property
5 creditsTry itGoogle Hotels API overview →

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

POSThttps://api.scrapercompany.com/v1/serp/google_hotels_property

Authenticate with your API key in the x-api-key header (see Authentication).

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Body

JSON object. Unknown fields are rejected with 422.

  • property_tokenstringrequiredmin length 8

    Google property token — The standard SERP API name for the same value /v1/search returns as token.

  • check_in_datestring (date)required

    First night of the stay, YYYY-MM-DD.

  • check_out_datestring (date)required

    Departure date. Must be after check_in_date.

  • adultsintegerdefault 2min 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.

  • currencystringdefault USD

    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.

    39 allowed values

    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

  • glstringdefault us

    Two-letter country for the Google request, the standard SERP API spelling of market.

    251 allowed values

    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

  • property_namestringdefault

    Optional. Improves official-site detection when the hotel's own row is labelled with its brand name.

  • sourcesarray of string | nullmin items 1, max items 20

    Optional seller allowlist. Names are canonicalized, so Expedia.com and Expedia are equivalent. Omit for all Google sellers.

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

    One ofadaptivefull

Example request

curl -X POST "https://api.scrapercompany.com/v1/serp/google_hotels_property" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "property_token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "check_in_date": "2027-01-15",
    "check_out_date": "2027-01-16",
    "adults": 2,
    "currency": "USD",
    "gl": "us"
  }'

Response

200 — The standard SERP API google_hotels_property shape. `extracted_price` is populated, which theirs omits. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response
{
  "search_parameters": {
    "engine": "google_hotels_property",
    "property_token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "check_in_date": "2027-02-10",
    "check_out_date": "2027-02-11",
    "adults": 2,
    "currency": "USD",
    "gl": "us",
    "nights": 1
  },
  "property": {
    "property_token": "ChUIoben2Mv6-CYaCi9tLzA3czVwbjQQAQ",
    "name": "Hilton Chicago",
    "hotel_class": "4-star hotel",
    "hotel_class_stars": 4,
    "rating": 4.3,
    "reviews": 10695,
    "deal": "25% less than usual",
    "deal_description": "Great Deal",
    "has_deal": true,
    "price_insights": {
      "lowest_price": "$304",
      "price_level": "typical",
      "price_level_code": 2,
      "typical_price_range": {
        "low_price": "$304",
        "high_price": "$521"
      }
    },
    "all_offers": [
      {
        "source": "Hilton Chicago",
        "is_official": true,
        "num_guests": 2,
        "room_id": "rate-plan-42",
        "price_per_night": {
          "price": "$2,907",
          "extracted_price": 2907.11,
          "extracted_price_before_taxes": 2445,
          "currency": "USD"
        },
        "total_price": {
          "price": "$2,907",
          "extracted_price": 2907.11,
          "extracted_price_before_taxes": 2445,
          "currency": "USD"
        },
        "tax_basis": "deeplink",
        "is_outlier": false
      }
    ],
    "featured_offers": [
      {
        "source": "Hilton Chicago",
        "is_official": true,
        "num_guests": 2,
        "room_id": "rate-plan-42",
        "price_per_night": {
          "price": "$2,907",
          "extracted_price": 2907.11,
          "extracted_price_before_taxes": 2445,
          "currency": "USD"
        },
        "total_price": {
          "price": "$2,907",
          "extracted_price": 2907.11,
          "extracted_price_before_taxes": 2445,
          "currency": "USD"
        },
        "tax_basis": "deeplink",
        "is_outlier": false
      }
    ],
    "price_per_night": {
      "price": "$2,208",
      "extracted_price": 2207.96
    },
    "currency_verified": true,
    "tax_profile": {
      "rate": 0.208,
      "confidence": "low"
    }
  },
  "meta": {
    "elapsed_s": 1.548,
    "offers": 15,
    "priced": 15,
    "property_fetch": "miss",
    "tax_profile_cache": "hit"
  }
}

Response fields

Fields marked required are always present; others appear when they apply.

  • search_parametersobjectrequired
    Show 10 child fields
    • search_parameters.enginestringrequired

      One ofgoogle_hotels_property

    • search_parameters.property_tokenstringrequired
    • search_parameters.check_in_datestring (date)required
    • search_parameters.check_out_datestring (date)required
    • search_parameters.adultsintegerrequired
    • search_parameters.currencystringrequired
    • search_parameters.glstringrequired
    • search_parameters.nightsintegerrequired
    • search_parameters.sourcesarray of string

      Present only when sources was requested.

    • search_parameters.source_coveragestring

      Present only when sources was requested.

  • propertyobjectrequired
    Show 20 child fields
    • property.property_tokenstringrequired
    • property.namestringrequired
    • property.hotel_classstringrequired
    • property.hotel_class_starsinteger | nullrequired
    • property.ratingnumber | nullrequired
    • property.reviewsinteger | nullrequired
    • property.dealstring | nullrequired
    • property.deal_descriptionstring | nullrequired
    • property.has_dealbooleanrequired
    • property.price_insightsobjectrequired
      Show 4 child fields
      • property.price_insights.lowest_pricestring | nullrequired

        As Google displays it, e.g. $304.

      • property.price_insights.price_levelstring | nullrequired
      • property.price_insights.price_level_codeinteger | nullrequired
      • property.price_insights.typical_price_rangeobject | nullrequired
    • property.all_offersarray of objectrequired
      Show 18 child fields
      • property.all_offers[].sourcestringrequired

        Seller label (official offers use the hotel's rendered name).

      • property.all_offers[].raw_sourcestringrequired
      • property.all_offers[].is_officialbooleanrequired
      • property.all_offers[].num_guestsintegerrequired
      • property.all_offers[].room_idstring | nullrequired
      • property.all_offers[].price_per_nightobjectrequired
      • property.all_offers[].total_priceobjectrequired
      • property.all_offers[].tax_basisstringrequired

        One ofdeeplinkderivedunknown

      • property.all_offers[].is_outlierbooleanrequired
      • property.all_offers[].roomsarray of objectrequired
      • property.all_offers[].is_featuredbooleanrequired
      • property.all_offers[].has_free_cancellationbooleanrequired
      • property.all_offers[].free_cancellation_untilstring | nullrequired
      • property.all_offers[].free_cancellation_timestring | nullrequired
      • property.all_offers[].price_derived_from_roombooleanrequired
      • property.all_offers[].headline_price_totalnumber | nullrequired
      • property.all_offers[].headline_price_before_taxesnumber | nullrequired
      • property.all_offers[].provenanceobjectrequired

        Where, when and how one normalized price was observed.

    • property.featured_offersarray of objectrequired

      Offers Google rendered as featured cards.

      Show 18 child fields
      • property.featured_offers[].sourcestringrequired

        Seller label (official offers use the hotel's rendered name).

      • property.featured_offers[].raw_sourcestringrequired
      • property.featured_offers[].is_officialbooleanrequired
      • property.featured_offers[].num_guestsintegerrequired
      • property.featured_offers[].room_idstring | nullrequired
      • property.featured_offers[].price_per_nightobjectrequired
      • property.featured_offers[].total_priceobjectrequired
      • property.featured_offers[].tax_basisstringrequired

        One ofdeeplinkderivedunknown

      • property.featured_offers[].is_outlierbooleanrequired
      • property.featured_offers[].roomsarray of objectrequired
      • property.featured_offers[].is_featuredbooleanrequired
      • property.featured_offers[].has_free_cancellationbooleanrequired
      • property.featured_offers[].free_cancellation_untilstring | nullrequired
      • property.featured_offers[].free_cancellation_timestring | nullrequired
      • property.featured_offers[].price_derived_from_roombooleanrequired
      • property.featured_offers[].headline_price_totalnumber | nullrequired
      • property.featured_offers[].headline_price_before_taxesnumber | nullrequired
      • property.featured_offers[].provenanceobjectrequired

        Where, when and how one normalized price was observed.

    • property.price_per_nightobject | nullrequired

      Lowest all-in nightly price across offers.

      Show 2 child fields
      • property.price_per_night.pricestringrequired
      • property.price_per_night.extracted_pricenumberrequired
    • property.provenanceobject | nullrequired

      Provenance of the lowest-priced offer.

      Show 13 child fields
      • property.provenance.schema_versionintegerrequired

        Provenance schema version (currently 1).

      • property.provenance.observation_idstringrequired

        Deterministic id of this price observation (rateobs_...).

      • property.provenance.collection_idstringrequired

        Id shared by every price from one upstream fetch (ratecol_...).

      • property.provenance.observed_atstringrequired

        UTC observation time, ISO-8601.

      • property.provenance.sourcestringrequired

        Upstream source, e.g. google_hotels_calendar.

      • property.provenance.source_kindstringrequired

        Kind of source, e.g. calendar, offer, ota_calendar, official.

      • property.provenance.source_property_idstringrequired

        Property identifier at the source.

      • property.provenance.requested_marketstring | nullrequired
      • property.provenance.requested_currencystring | nullrequired
      • property.provenance.returned_currencystring | nullrequired
      • property.provenance.price_basisstringrequired

        What the price represents, e.g. room_base_before_taxes_and_fees.

      • property.provenance.derivationstringrequired

        How the figure was derived, e.g. normalized_upstream.

      • property.provenance.upstream_rate_idstring | nullrequired

        Source-native rate/room id when available.

    • property.currency_verifiedbooleanrequired
    • property.requested_marketstringrequired
    • property.egress_marketstring | nullrequired
    • property.egress_geo_locked_okbooleanrequired
    • property.price_insights_market_verifiedbooleanrequired
    • property.tax_profileobject | nullrequired
      Show 2 child fields
      • property.tax_profile.ratenumberrequired
      • property.tax_profile.confidencestringrequired

        One ofhighlownone

  • metaobjectrequired
    Show 5 child fields
    • meta.elapsed_snumberrequired
    • meta.offersintegerrequired
    • meta.pricedintegerrequired
    • meta.property_fetchstringrequired
    • meta.tax_profile_cachestringrequired

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

StatusMeaningRetry?
400Bad Request

Bad request: the parameters are well-formed but unusable (for example an unknown market or a malformed token).

{"detail":"end must be on or after start"}
No, fix the request
401Unauthorized

Missing or invalid API key.

{"detail":"missing or invalid API key"}
No, fix the request
402Payment Required

Not enough credits for this request: the account's credits mode is enforce (mode in GET /v1/billing) and the request costs more than the available credits. Nothing is run or charged.

{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}
No, fix the request
404Not Found

The property, stay, job or record was not found.

{"detail":"job not found"}
No, fix the request
422Unprocessable Content

Request validation failed.

{"detail":[{"loc":["body","token"],"msg":"Field required","type":"missing"}]}
No, fix the request
429Too Many Requests

Too many requests: the key's requests-per-minute limit was exceeded, or (in enforce credits mode) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry.

{"detail":"rate limit 60/min exceeded"}
Yes, with backoff
502Bad Gateway

The upstream source failed, blocked the request or returned an unusable answer. Safe to retry later; failed requests are not charged.

{"detail":"RuntimeError"}
Yes, with backoff

Try it

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

  1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
  2. Copy the cURL example above and run it in a terminal.

Credits

5 credits per successful call. Failed, blocked and empty results are free.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support