Google Hotels Scraper & Google Hotels API: Prices per Site

Google Hotels search results as data, logged out: a place (or a hotel) and a stay in, one row per hotel out — Google's own record with class, rating and review count, the nightly and stay prices before and with taxes (taxes and fees apart), the deal line ("25% less than usual"), amenities, photos, nearby places with travel times, check-in times, and Google's ids and links. On request: the price per booking site for the stay (Google's click-out link and the site's own deep link, the official-site flag, free cancellation, rate parity), the full record (address, phone, rating histogram, review aspects and texts), a price calendar (one row per check-in date with its site list), filters (class, guest rating, price, amenities, free cancellation, special offers, vacation rentals), Google's own sorts, 70+ currencies, markets and languages, batches of places, and a memory that delivers only the hotels whose price moved. A free summary row per search states Google's count for the stay, how many distinct hotels were read and whether the list was COMPLETE, TRUNCATED or CAPPED. Dates as YYYY-MM-DD or +N days from the day of the run, so a saved task never asks for a past day. No login, no Google account, no API key, no browser, proxies handled for you.

Why this Google Hotels scraper

• Every hotel Google lists, counted. Google Hotels shows 18 hotels a page and serves about 200 distinct hotels per sorted list and 500 under relevance; the lane's tools stop at 20, 200 or their cap and never say where the list ended. Here a place search walks the relevance list to its end, then the class facets under two orders, de-duplicates by Google's id, and the free summary row states Google's own count for the stay (results_count, 1,221 for New York on our test), how many distinct hotels were read and a verdict: COMPLETE, TRUNCATED (Google's lists end before its count) or CAPPED (your maxHotelsPerSearch).
• The stay and the currency you asked, or nothing. Every record Google answers echoes the stay and the currency; a record that carries another stay or currency is never delivered as yours — the search becomes a free failed row that says what Google answered. The lane's leaders read Google's default stay or another market without a word.
• One price model, both tax states. Every row carries the stay's parts — price_base, taxes, fees, total_price_with_taxes — and from them the nightly price before taxes (nightly_price, Google's main figure) and with taxes and fees (nightly_price_with_taxes), the same on every exit and market; price_tax_state names what the figures are. Twelve rival actors deliver one figure and disagree on which.
• The price per booking site, dated, with two links. detailsFor (or a hotel in hotels) reads the booking-site list for the asked stay — 28–36 sites for a Manhattan hotel in our tests, every one priced before and with taxes — with Google's click-out link and the site's own deep link for the stay (site_url), the official-site flag, free cancellation and its deadline, the member-rate note, and the parity gap between the hotel's own site and the cheapest one. The sponsored block (Google's "Featured options") is delivered apart in sponsored_sites.
• The full record on the same row. With the details call: address, phone, website, the rating histogram, Google's review aspects with positive and negative counts, the review snippets and the external ratings (Tripadvisor, Trip.com), Google's review summary, the amenity groups, nearby landmarks, transit stops, airports and restaurants with walking, driving and transit times, check-in and check-out times, the neighbourhood text.
• Honest runs. A search Google lists nothing for, a value that is no search, a refusal the exits could not pass, a hotel name Google does not answer and a list in the wrong stay or currency are free search rows with the reason; nothing silent, nothing charged. The run summary (RUN_SUMMARY) carries the walk per search and the share of fresh exits Google served in your run's own window.
• Plain HTTP, 256 MB, seconds a search. A page of 18–20 hotels is one call to Google's own page API (45 KB on the wire), a hotel's dated site list one more (54–81 KB): no browser, no page load, no token to mint. A 25-hotel search with the site list for two of them took 15 seconds from a cold start in our tests.

Who it's for

• Revenue managers and rate-parity teams — a hotel by name, URL or id with the price per booking site for the stay, the official site's price against the cheapest OTA, free-cancellation deadlines, and a price calendar over the next weeks; a saved task on a schedule with onlyChanges delivers only the sites whose price moved.
• Travel apps and meta-search — the hotel list for a place and stay with Google's ids, class, rating, the nightly and stay prices before and with taxes, photos and amenities, in the market, language and currency of the user, sorted the way Google sorts.
• Analysts and consultants — batches of places with their own stays, Google's count per stay, class and rating filters, the whole list de-duplicated with a verdict, the deal line and the review aspects.
• Developers and agents — typed rows keyed by search_id, a free summary row per search with the status and its reason, and a run summary to check a pipeline against; every input constrained in the schema.

Quick start

A place and a stay, Google's first 20 hotels

{
  "query": "hotels in New York",
  "checkIn": "+30",
  "checkOut": "+32",
  "maxHotelsPerSearch": 20
}

Every hotel Google lists, with the booking-site list for the first 10

{
  "query": "hotels in Barcelona",
  "checkIn": "+30",
  "checkOut": "+33",
  "detailsFor": 10,
  "maxItems": 1000
}

One hotel: the price per booking site and a 30-day price calendar

{
  "hotels": [
    "Arlo NoMad New York"
  ],
  "checkIn": "+30",
  "checkOut": "+32",
  "calendarDays": 30
}

Filters, a sort and a market

{
  "query": "hotels in Berlin",
  "checkIn": "+30",
  "checkOut": "+32",
  "hotelClass": [
    "4",
    "5"
  ],
  "minRating": "4",
  "maxPrice": 250,
  "freeCancellation": true,
  "sortBy": "lowest_price",
  "market": "DE",
  "language": "de",
  "currency": "EUR",
  "maxHotelsPerSearch": 50
}

Output

One row per hotel (and one free summary row per search; price-calendar days are rows of their own kind):

field	meaning
row_type	hotel (one hotel, charged), search (the free summary row of a search) or calendar_day (one check-in date of a hotel's price calendar, charged).
search_id	s1, s2, …: the search the row answers, in the order of the input; join rows by it.
search_label	The search as you gave it (the place and stay, the search object, the hotel name, URL or id).
status	On a hotel or calendar row ok. On a search row: ok (the list was served), no_hotels (Google listed nothing for it, or no hotel of that name), failed (a refusal the exits could not pass, Google's own error, or a stay or currency Google did not honour), invalid (a value that is no search).
status_detail	The reason behind a status that is not ok, in a sentence; on a hotel row a note when the details call was not served.
scraped_at	When the row was read, ISO 8601 UTC.
query	The place words asked (a search), or the hotel name asked (a hotel by name).
check_in	The check-in date of the stay, YYYY-MM-DD (a +N date resolved to the day).
check_out	The check-out date of the stay, YYYY-MM-DD.
nights	Nights of the stay.
adults	Adults the prices are for.
children_ages	The children's ages the prices are for, or null.
market	The market (point of sale) asked, a two-letter country code.
language	The language of the texts asked.
currency	The currency asked.
currency_served	The currency Google answered with (every price of the row is in it); equal to currency on a delivered row.
sort	The sort asked: relevance, lowest_price, highest_rating or most_reviewed.
filters	The filters applied to the search (sortBy, hotelClass, minRating, maxPrice, minPrice, amenities, freeCancellation, specialOffers, propertyType), or null when none narrows the list.
property_type_asked	hotels, vacation_rentals or all: the view asked.
rank	The hotel's position in the delivered list of its search (1 = first); null on a hotel asked by name, URL or id.
name	The hotel's name as Google lists it.
property_type	hotel or vacation_rental, from Google's own type flag.
hotel_class	Google's class as a number of stars (1–5); null when Google shows none (unclassed hotels, rentals).
hotel_class_label	Google's class label in the language asked (4-star hotel, 4-Sterne-Hotel).
rating	Google's guest rating (0–5).
reviews_count	The number of Google reviews behind the rating.
feature_id	Google's feature id of the place (0x…:0x…), the key a hotel is de-duplicated on; null on a vacation rental.
entity_id	Google Hotels' entity id (ChkI…): the id of the hotel's own page and of the hotels input.
cid	Google's cid of the place (the Maps listing's id).
google_hotels_url	The hotel's Google Hotels prices page for the stay (the stay in its ts token).
google_maps_url	The hotel's Google Maps link (from the details call).
website	The hotel's own website as Google links it.
latitude	Latitude of the hotel.
longitude	Longitude of the hotel.
address	The hotel's address as Google shows it (from the details call; on a list row only when Google's first screen carries it).
phone	The hotel's phone number as Google shows it (from the details call).
country_code	The two-letter country of the hotel.
neighborhood	The innermost place Google files the hotel under (Midtown South).
neighborhood_description	Google's text about the hotel's area (from the details call).
check_in_time	The hotel's check-in time as Google shows it (3:00 PM).
check_out_time	The hotel's check-out time (11:00 AM).
description	Google's one-line description of the hotel.
description_long	With the details call: Google's long description of the hotel (null when Google has none).
thumbnail	The hotel's thumbnail image URL.
images	The hotel's photo URLs as Google serves them (9 on a list record).
more_photos	With the details call: further photo URLs of the hotel (guests' and the hotel's own; 10–16 a hotel).
amenities	The amenities Google marks available, by name (Free Wi-Fi, Pool, Pet-friendly); a code the map does not know is code:<n>.
amenities_unavailable	The amenities Google marks as not offered (Parking, Breakfast).
amenity_codes	Google's raw amenity codes with their availability flag and Google's qualifier where it gives one ({code, available, qualifier}: free, extra charge, 24 hours), for a map of your own.
amenity_groups	With the details call: the amenities by Google's groups ({group, amenities, unavailable}: Internet, Food & drink, Pools, Parking & transportation, Accessibility, Pets, Services, Wellness, Rooms, Bathrooms, …).
nearby	Nearby places Google lists with travel times ({name, kind (landmark, transit, airport, restaurant), walk_minutes, drive_minutes, transit_minutes, rating, reviews_count, category, latitude, longitude}); the details call carries the full set.
rating_histogram	Google's reviews by stars ({"5": n, "4": n, …}).
review_aspects	Google's review aspects ({name, mentions, positive, negative, sentiment, score}): Location, Service, Cleanliness, Breakfast, …; the details call carries the full set.
reviews	With the details call: the review snippets Google shows ({source, author, text, date, rating, url}) — Google's own highlights and the external sources' entries (Tripadvisor, Trip.com).
external_ratings	With the details call: the hotel's ratings on other sites ({source, rating, scale, reviews_count, url}).
review_summary_positive	With the details call: Google's own summary of what guests praise.
review_summary_negative	With the details call: Google's own summary of what guests complain about.
nightly_price	The nightly price before taxes (Google's main figure: the room rate with fees, taxes out), in currency_served: (price_base + fees) / nights.
nightly_price_with_taxes	The nightly price with taxes and fees: total_price_with_taxes / nights.
total_price	The stay's price before taxes (price_base + fees).
total_price_with_taxes	The stay's price with taxes and fees (Google's total).
price_base	The stay's room rate before fees and taxes, as Google's parts give it.
taxes	The stay's taxes, as Google's parts give them.
fees	The stay's fees (resort, destination, cleaning …), as Google's parts give them.
price_tax_state	both when the figures come from Google's parts (the before- and with-taxes figures are computed from them: the usual case), as_displayed when only the display strings were there, null on a record without a price.
nightly_price_display	The nightly price as Google displayed it ($180, 58 €).
nightly_price_with_taxes_display	The nightly price with taxes as Google displayed it ($210); null where Google showed one figure (a non-US market read on some exits).
deal	Google's deal line when it shows one (25% less than usual).
deal_percent	The deal's percentage below the usual price (25 for 25% less than usual).
deal_level	deal or great_deal, Google's own level of the deal line.
typical_price_low	With the details call: the low end of Google's typical nightly price range for this hotel and stay, in currency as Google displays it.
typical_price_high	With the details call: the high end of Google's typical nightly price range for this hotel and stay, in currency.
details_read	True when the row carries the details call (the booking-site list and the full record): the details event.
sites	The dated booking-site list, Google's organic list in its order ({site, partner_id, is_official_site, nightly_price, nightly_price_with_taxes, total_price, total_price_with_taxes, nightly_price_display, free_cancellation, free_cancellation_until, rate_note, member_nightly_price, booking_url (Google's click-out link), site_url (the site's own deep link for the stay), sponsored (false), logo}).
sites_count	The number of organic booking sites Google lists for the stay.
sites_priced	How many of them carry a price.
lowest_site	The booking site with the lowest nightly price.
lowest_site_price	The lowest nightly price among the sites (before taxes).
lowest_site_price_with_taxes	That site's nightly price with taxes.
official_site_price	The hotel's own site's nightly price when it is in the list.
parity_gap	official_site_price − lowest_site_price: how much the hotel's own site is above the cheapest OTA (negative when it is the cheapest).
sponsored_sites	Google's featured block (ads) above the list, with the same site fields and sponsored true (their links are Google's ad links).
results_count	Google's own count of results for the search and stay, for the view read (hotels, or all lodging when the walk read only the mixed list); the yardstick of the verdict.
results_count_page	The count the Google Hotels page shows for the stay (its first screen's figure, 1,221 for New York); read when nothing narrows the list.
place_resolved	The place Google resolved the words to (New York); an unknown place resolves to Google's nearest guess, never to an empty list.
hotels_found	On a search row: distinct hotels read for the search (de-duplicated by Google's id).
hotels_delivered	On a search row: hotel rows delivered for the search (the cap and maxItems may keep some back).
verdict	On a search row: COMPLETE (≥ 90 % of Google's count read), TRUNCATED (Google's lists ended before its count) or CAPPED (your cap stopped the walk).
verdict_detail	The verdict in a sentence: what was read against Google's count, the pages and facet lists, where Google stopped.
list_calls	On a search row: calls made to Google for the search (pages, facet lists, details calls).
change_type	With onlyChanges: new (first delivery), changed (a watched price moved since the last delivery) or unchanged (not delivered).
changed_fields	With onlyChanges: which watched fields moved (price, sites).
previous_read_at	With onlyChanges: when this hotel and stay were last delivered.
first_read_at	With onlyChanges: when this hotel and stay were first read by the memory.
times_read	With onlyChanges: how many runs read this hotel and stay.
previous_price	With onlyChanges: the nightly price with taxes as last delivered.
price_change	With onlyChanges: nightly_price_with_taxes − previous_price.
sites_gained	With onlyChanges and the details call: booking sites in the list now that were not in the last delivered one.
sites_lost	With onlyChanges and the details call: booking sites of the last delivered list that are gone.
sites_changed	With onlyChanges and the details call: sites whose nightly price moved ({site, previous_price, price}).
price_history_own	With onlyChanges: our own reads of this hotel and stay ({at, price}), the newest 60.
date	On a calendar row: the check-in date of the day (the stay's length kept).
day_rank	On a calendar row: the date's rank by the lowest site price among the calendar's dates (1 = cheapest).
is_cheapest	On a calendar row: true on the cheapest date of the calendar.

Example record:

{
  "row_type": "hotel",
  "search_id": "s1",
  "search_label": "hotels in New York 2026-11-12 → 2026-11-14",
  "status": "ok",
  "status_detail": null,
  "scraped_at": "2026-10-14T14:41:52Z",
  "query": "hotels in New York",
  "check_in": "2026-11-12",
  "check_out": "2026-11-14",
  "nights": 2,
  "adults": 2,
  "children_ages": null,
  "market": "US",
  "language": "en",
  "currency": "USD",
  "currency_served": "USD",
  "sort": "relevance",
  "filters": null,
  "property_type_asked": "hotels",
  "rank": 1,
  "name": "Fairfield by Marriott Inn & Suites New York Staten Island",
  "property_type": "hotel",
  "hotel_class": 3,
  "hotel_class_label": "3-star hotel",
  "rating": 3.8,
  "reviews_count": 657,
  "feature_id": "0x89c24d347e74e265:0x5c9e5ad04f3207da",
  "entity_id": "ChkI2o_I-YTals9cGg0vZy8xMWZsMHRrazhqEAE",
  "cid": "15613996860267130446",
  "google_hotels_url": "https://www.google.com/travel/hotels/entity/ChkI2o_I-YTals9cGg0vZy8xMWZsMHRrazhqEAE/prices?hl=en&gl=us&curr=USD&ts=CAESCgoCCAMKAggDEAAaGBIWEhQKBwjqDxALGAwSBwjqDxALGA4YAioHCgU6A1VTRA",
  "google_maps_url": "https://maps.google.com/maps?hl=en&gl=US&um=1&ie=UTF-8&fb=1&sa=X&ll=40.5868991,-74.1911844&z=11&ftid=0x0:0x5c9e5ad04f3207da&q=Fairfield+by+Marriott+Inn+%26+Suites+New+York+Staten+Island",
  "website": "https://www.marriott.com/en-us/hotels/nycfd-fairfield-inn-and-suites-new-york-staten-island/overview/?scid=f2ae0541-1279-4f24-b197-a979c79310b0",
  "latitude": 40.5868196,
  "longitude": -74.19115780000001,
  "address": "290 Wild Ave, Staten Island, NY 10314",
  "phone": "(718) 698-8811",
  "country_code": "US",
  "neighborhood": "Mid Island",
  "neighborhood_description": "Suburban Mid Island is home to the Staten Island Greenbelt, a cluster of nature preserves and parks with miles of trails through woods and wetlands. Historic Richmond Town, a village complex with restored 19th-century homes and shops, features guided tours and a local history museum. The hillside Jacques Marchais Museum of Tibetan Art displays Buddha sculptures and other Himalayan works in a monastery-style setting.",
  "check_in_time": "3:00 PM",
  "check_out_time": "12:00 PM",
  "description": "Informal hotel with a gym & a restaurant/bar, plus free breakfast, Wi-Fi & a ferry terminal shuttle.",
  "description_long": "Set 11 miles from St. George Ferry Terminal, offering access to Manhattan, this down-to-earth hotel is 5 miles from The Jacques Marchais Museum of Tibetan Art and 8 miles from the Staten Island Zoo.",
  "thumbnail": "https://lh3.googleusercontent.com/grass-cs/AABkmLfSOrgWfpF0URc5NWNnvKxDk4ngHsCl-S10Zu8glBX6jUa0bbwDS529-3T4-LE58SeW50HyJK4QCnOaauIBw0LEODyr6I22FJ6N2qOKszvBBXDd2n-7EaNaVhr3ihNE4BaaLwG8gg=s150-w92-h150-n-k-no",
  "images": [
    "https://lh3.googleusercontent.com/grass-cs/AABkmLdYG1iSQWhQIV2oASS1FN1t7aWAiqAojR_kA5yUFBx-eF4yn2OdnDktbgnILTcYui34CrHqo01-7sv9EUNHjGE_sew_fGnLY9ddMkkhbEH6shaN9JCJCO8ORGSNg8BLUeFo4zbBofQ9hNA=s287-w287-h192-n-k-no-v1",
    "https://lh3.googleusercontent.com/grass-cs/AABkmLd0JBzkOWVFMHXR9ifi6iRMa-nb_YdqQW5nry1kf7f0K1IVOfYJusIt5WoK-mGb4bW20xYAeCGrpmgWeqrgUtaFi9SiHNBLCYB6dLxs4ovUgKVI31ZvRhUUMIBY_ln2_ao4DV4Fw0IQ9ZTF=s287-w287-h192-n-k-no-v1",
    "https://lh3.googleusercontent.com/grass-cs/AABkmLcva-__2t0lj8kWDhxT3n3ilVdaxxAXy6Xpsjg8YZzaGeDN_L_uur5_8fVPRMvUXuPfIpOzSJ8TAOUnyJVDgrEWMhA1GXcN5_xwaGACm9ZXWUxLeoZlvBMWRM4PGxg61Jpx49EgdcGAi74=s287-w287-h192-n-k-no-v1"
  ],
  "more_photos": [
    "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9RC1ewUBuzQcCagkR8elHBy1SRpQRDV8XMl5Hc1fjofUhYStX0yQ_rmaYJmvSUpSCiC8DTbWycLbxt_0XIP22oF1gKCm6oFXoqdXYYSgv0S45TKLYv8xTA4X9fyAipvW6xWBFWivwH6mvM=w252-h168-k-no",
    "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Sv3L20LZo2h3NPF-dgDGdWIAMrOy5HW6mWfHGrGYAW6BOJSDrEgC-ko8iH9JIWTWa8P3aN3HK_tBl4sWWf1bu49-SJ3pn661X_l84yAwOJ7qoYEqxEuRExr_FghG5L74j5Ok3iJprT1Stb=w252-h168-k-no"
  ],
  "amenities": [
    "Wi-Fi (free)",
    "Wi-Fi in public areas",
    "Table service",
    "Breakfast (free)",
    "Breakfast buffet",
    "Smoke-free property",
    "Credit cards",
    "Cash",
    "Checks",
    "Front desk (24 hours)",
    "Baggage storage",
    "Convenience store",
    "Full-service laundry",
    "Self-service laundry",
    "Elevator",
    "Wake up calls",
    "Housekeeping",
    "Kid-friendly",
    "Parking (free)",
    "Self parking (free)",
    "Accessible",
    "Accessible parking",
    "Fitness center (free)",
    "Treadmill",
    "Free weights",
    "English",
    "Spanish",
    "Private bathroom",
    "Air conditioning",
    "Coffee maker"
  ],
  "amenities_unavailable": [
    "Pool",
    "Hot tub"
  ],
  "amenity_codes": [
    {
      "code": 28,
      "available": true,
      "qualifier": "free"
    },
    {
      "code": 162,
      "available": true
    },
    {
      "code": 148,
      "available": true
    },
    {
      "code": 54,
      "available": true,
      "qualifier": "free"
    },
    {
      "code": 56,
      "available": true
    }
  ],
  "amenity_groups": [
    {
      "group": "Internet",
      "amenities": [
        "Wi-Fi (free)",
        "Wi-Fi in public areas"
      ],
      "unavailable": []
    },
    {
      "group": "Food & drink",
      "amenities": [
        "Table service",
        "Breakfast (free)",
        "Breakfast buffet"
      ],
      "unavailable": []
    },
    {
      "group": "Policies & payments",
      "amenities": [
        "Smoke-free property",
        "Credit cards",
        "Cash",
        "Checks"
      ],
      "unavailable": []
    }
  ],
  "nearby": [
    {
      "name": "Statue of Liberty",
      "kind": "landmark",
      "walk_minutes": null,
      "drive_minutes": 24,
      "transit_minutes": 55,
      "rating": 4.7,
      "reviews_count": 112707,
      "category": "Point of interest",
      "latitude": 40.6892494,
      "longitude": -74.04450039999999
    },
    {
      "name": "Coney Island",
      "kind": "landmark",
      "walk_minutes": null,
      "drive_minutes": 25,
      "transit_minutes": 108,
      "rating": 4.6,
      "reviews_count": 6861,
      "category": "Point of interest",
      "latitude": 40.5755438,
      "longitude": -73.9707016
    },
    {
      "name": "Ellis Island",
      "kind": "landmark",
      "walk_minutes": null,
      "drive_minutes": 25,
      "transit_minutes": 95,
      "rating": 4.6,
      "reviews_count": 1470,
      "category": "Point of interest",
      "latitude": 40.6994748,
      "longitude": -74.0395587
    },
    {
      "name": "Governors Island",
      "kind": "landmark",
      "walk_minutes": 347,
      "drive_minutes": null,
      "transit_minutes": 84,
      "rating": 4.7,
      "reviews_count": 1455,
      "category": "Point of interest",
      "latitude": 40.689450099999995,
      "longitude": -74.016792
    }
  ],
  "rating_histogram": {
    "5": 299,
    "4": 144,
    "3": 84,
    "2": 40,
    "1": 90
  },
  "review_aspects": [
    {
      "name": "Breakfast",
      "mentions": 70,
      "positive": 45,
      "negative": 14,
      "sentiment": "positive",
      "score": 0.323
    },
    {
      "name": "Restaurant",
      "mentions": 41,
      "positive": 28,
      "negative": 6,
      "sentiment": "positive",
      "score": 0.462
    },
    {
      "name": "Service",
      "mentions": 170,
      "positive": 101,
      "negative": 57,
      "sentiment": "neutral",
      "score": 0
    },
    {
      "name": "Parking",
      "mentions": 33,
      "positive": 8,
      "negative": 24,
      "sentiment": "negative",
      "score": -0.371
    }
  ],
  "reviews": [
    {
      "source": "Google",
      "author": "Gary Fried",
      "text": "Rooms are generally clean, but service can be a bit hit or miss.",
      "date": null,
      "rating": null,
      "rating_scale": null,
      "url": null
    },
    {
      "source": "Google",
      "author": "D Johnson",
      "text": "Ugly location, first floor room very loud, could not sleep, over priced.",
      "date": null,
      "rating": null,
      "rating_scale": null,
      "url": null
    },
    {
      "source": "Google",
      "author": "Tom Gegan",
      "text": "Staff gave great directions and selections for dinner and cheapest gas!",
      "date": null,
      "rating": null,
      "rating_scale": null,
      "url": null
    }
  ],
  "external_ratings": [
    {
      "source": "Tripadvisor",
      "rating": 3.1,
      "scale": 5,
      "reviews_count": 60,
      "url": "https://www.tripadvisor.com/Hotel_Review-g48682-d5539370-r1072767421?m=68573&staydates=2026_10_25_2026_10_26&uguests=1_2_0&supdv=desktop&supuc=US&supul=en"
    },
    {
      "source": "Trip.com",
      "rating": 4.2,
      "scale": 5,
      "reviews_count": 56,
      "url": null
    },
    {
      "source": "Priceline",
      "rating": 7.5,
      "scale": 10,
      "reviews_count": 243,
      "url": null
    }
  ],
  "review_summary_positive": "Guests consistently praise this hotel for its spacious rooms, solid complimentary breakfast, and friendly, helpful staff.",
  "review_summary_negative": "Other reviews mention the service can be inconsistent and the rooms can be poorly maintained.",
  "nightly_price": 119.44,
  "nightly_price_with_taxes": 141.98,
  "total_price": 238.88,
  "total_price_with_taxes": 283.95,
  "price_base": 238.88,
  "taxes": 45.08,
  "fees": 0.0,
  "price_tax_state": "both",
  "nightly_price_display": "$119",
  "nightly_price_with_taxes_display": "$142",
  "deal": "16% less than usual",
  "deal_percent": 16,
  "deal_level": "deal",
  "typical_price_low": 128.0,
  "typical_price_high": 156.0,
  "details_read": true,
  "sites": [
    {
      "site": "Fairfield by Marriott Inn & Suites New York Staten Island",
      "partner_id": 100231600,
      "is_official_site": true,
      "nightly_price": 168.0,
      "nightly_price_with_taxes": 196.0,
      "total_price": 337.0,
      "total_price_with_taxes": 392.0,
      "nightly_price_display": "$168",
      "free_cancellation": false,
      "free_cancellation_until": null,
      "rate_note": "Get a lower price plus free Wi-Fi with free enrollment",
      "member_nightly_price": 168.0,
      "booking_url": "https://www.google.com/travel/lodging/clk?pc=AA80OsyQufwN93Ontl5jBDhl9NXfx3mLvWp_p8HYdvoaKdNWL6NpXiuDQUt9XQk_03e7dyp2gmDrDcFq5zb1tu822k2hZKK8Y7kONmMXRtqrCuNN6bkKq-f_ua2V7br7YRN45xsVR4PmqZB3pd0V6b4YghdwHZR4e3S-KSWb42pGcYY5GFRDVh2M43kjeCM&pcurl=https://marriottclk.koddi.com/clk?destination%3Dhttps%253A%252F%252Fad.doubleclick.net%252Fclk%253B269275299%253B95398642%253Bk%253Bu%253Dkoddi%2526sv2%253Dkoddi_hpa_US_NYCFD_localuniversal_2_desktop_11/12/2026_non-distributable__selected___organic%253Fhttps%253A%252F%252Fwww.marriott.com%252Freservation%252FavailabilitySearch.mi%253Fcid%253DOMS_GLB0002Y27_GLE00070C9_GLF000C1AH%2526pId%253D%2526isSearch%253Dfalse%2526propertyCode%253DNYCFD%2526fromDate%253D11%252F12%252F2026%2526toDate%253D11%252F14%252F2026%2526numberOfRooms%253D1%2526numberOfGuests%253D2%2526currency%253DUSD&s=AD1XQnlmxZTubhcXTYK0_fNQJDmy&ap=1",
      "site_url": "https://marriottclk.koddi.com/clk?destination=https%3A%2F%2Fad.doubleclick.net%2Fclk%3B269275299%3B95398642%3Bk%3Bu%3Dkoddi%26sv2%3Dkoddi_hpa_US_NYCFD_localuniversal_2_desktop_11/12/2026_non-distributable__selected___organic%3Fhttps%3A%2F%2Fwww.marriott.com%2Freservation%2FavailabilitySearch.mi%3Fcid%3DOMS_GLB0002Y27_GLE00070C9_GLF000C1AH%26pId%3D%26isSearch%3Dfalse%26propertyCode%3DNYCFD%26fromDate%3D11%2F12%2F2026%26toDate%3D11%2F14%2F2026%26numberOfRooms%3D1%26numberOfGuests%3D2%26currency%3DUSD",
      "sponsored": false,
      "logo": "https://www.gstatic.com/travel-hotels/branding/df3424c9-7799-4d27-aeb5-cdcabf8bf950.png"
    },
    {
      "site": "KAYAK.com",
      "partner_id": 100979605,
      "is_official_site": false,
      "nightly_price": 119.0,
      "nightly_price_with_taxes": 142.0,
      "total_price": 239.0,
      "total_price_with_taxes": 284.0,
      "nightly_price_display": "$119",
      "free_cancellation": false,
      "free_cancellation_until": null,
      "rate_note": null,
      "member_nightly_price": null,
      "booking_url": "https://www.google.com/travel/lodging/clk?pc=AA80OswR-O0R4xVKYl1eNf3kGu6i1fdj1vWP1qaXbnvtY-1mbg3UpEpF4ll6VgysdZ7hE3eeD1bNOUYjPlkhOAK0MtxxP5_bHyZTEtilek60qXoDv5IeBQrImrYqShPQiT9UHK2HtMXxOBvPipmcORqPalBjqaOUTcUchytK3Ub5u-_LV2ZAP-CC_-1_dA&pcurl=https://www.kayak.com/semi/ha/hotel_ads/746011/en.html?utm_source%3Dgoogle%26utm_medium%3Dcpc%26utm_term%3D746011%26adType%3D0%26utm_content%3Dlocaluniversal%26utm_campaign%3DHotelAds%26ci%3D2026-11-12%26co%3D2026-11-14%26gs%3Dlocaluniversal%26l%3D2%26pc%3DUSD%26rid%3D%26pdtax%3D45.08%26pdtotal%3D283.95%26rpid%3D%26uc%3DUS%26ucuc%3DUSD%26d%3Ddesktop%26lc%3Den%26v%3Dfalse%26rrid%3DUFJJQ0VMSU5FQ09SRQ%26k_pc%3D~UENMTkhPVEVMV0hJU0tZ%26k_rt%3D%26k_sid%3D2QBkJ8zJ1a%26k_kct%3D1791969899%26k_gct%3D1791979864%26g%3D2%26r%3D1%26ac%3D2%26k_cc%3Dus%26dt%3Dselected%26cmpid%3D%26cmptrack%3D&s=AD1XQnkEB6bgTU6-TxddAf9ePJNx&ap=1",
      "site_url": "https://www.kayak.com/semi/ha/hotel_ads/746011/en.html?utm_source=google&utm_medium=cpc&utm_term=746011&adType=0&utm_content=localuniversal&utm_campaign=HotelAds&ci=2026-11-12&co=2026-11-14&gs=localuniversal&l=2&pc=USD&rid=&pdtax=45.08&pdtotal=283.95&rpid=&uc=US&ucuc=USD&d=desktop&lc=en&v=false&rrid=UFJJQ0VMSU5FQ09SRQ&k_pc=~UENMTkhPVEVMV0hJU0tZ&k_rt=&k_sid=2QBkJ8zJ1a&k_kct=1791969899&k_gct=1791979864&g=2&r=1&ac=2&k_cc=us&dt=selected&cmpid=&cmptrack=",
      "sponsored": false,
      "logo": "https://www.gstatic.com/travel-hotels/branding/6417d44c-c676-4b16-8ae9-f3bbeaa51899.png"
    },
    {
      "site": "Priceline",
      "partner_id": 220,
      "is_official_site": false,
      "nightly_price": 129.0,
      "nightly_price_with_taxes": 152.0,
      "total_price": 258.0,
      "total_price_with_taxes": 303.0,
      "nightly_price_display": "$129",
      "free_cancellation": true,
      "free_cancellation_until": "Nov 9 11:59 PM",
      "rate_note": null,
      "member_nightly_price": null,
      "booking_url": "https://www.google.com/travel/lodging/clk?pc=AA80OszYeMVgd83ZIhfNzcSqFPE5-6A-IY39GsaU-ZEFlaiHzay92qKdnhfv5UzmrbTGLMZYQjx68ignOmNrY1C3L5HLrpuacx6MPI5yk3aq59EyXshxRHivM8jnxOQMN_Wyga_p_G0oIftDs-oboiEiXKJZpNwYsDkN1ezE9EsiT5G5VAwh1hEkTku2boQ6HQ3Qk4c&pcurl=https://www.priceline.com/r/?channel%3Dmeta%26product%3Dhotel%26theme%3DGoogle-L%26refid%3DPLGOOGLEMSS%26refclickid%3DUS_HP%257C43756706_localuniversal_2%257C20261112%257Cdesktop%257Cuserdate%7Cpublic%7C%7C%7C29%257C2%257C0%7C0%7CEN%26hotelid%3D43756706%26checkin%3D20261112%26checkout%3D20261114%26rooms%3D1%26cur%3DUSD%26POSCountryCode%3DUS%26taxDisplayMode%3DBP%26cityID%3D3000016474%26adults%3D4%26land%3DL%26metaid%3DH62cz-JuPRvOebA4y4svbysBGhV5iGFREq_5yxlaX49wORuc4QFZHd944tiJdvhobCuFG0Fj04kpqGVM5Gb6u79G6b9CVlrPTOMSF4iyis-uFp4dTgGXJiAlib8im38AnJ5LA_vvqbxW2MZRVcCpICzdUckg-PBHnN3fCJggjvA7YA2HLvayyuAcKOsZugfkP6ek1tQUAz6sIbonjetOr7PF1nI38UIqeyFXstpqeosVahcWtHR0IKZmtGEKg2_jZ6tO_wjkv2y0e-UJOfWVKkxTbtSDP3RCw0DrLzBsIL6OOj7x8hH5LRumr_LrUefTNgIREWPBiuixfwYeR90q3Yr_kwDHrzjao9mfXS-rx3bb20jThMoCb8T36cnBzBXqQ4XmpdJbr7uHLDxz3ON8ph_8xsEXhuYv15LYdjv9wCCVUzgmWKABWjiX_KBkhftaAXvE_m_HD5Qp7OKv75eZkX74Ptp-fceZu10NePOugs5enJ8ewPSwPcCY_YbcO2xtJE7rT8LPdVv_xIjxI46K6Q%26dblcnt%3Dtrue%26hc%3D1%26pdtax%3D45.08%26pdf%3D0.00%26pdt%3D303.08%26locale%3Den-us%26ad-src%3D%26numChild%3D0%26aid%3D%26selAdults%3D2&s=AD1XQnnQsGweJae76cMUCNZzcn4_&ap=1",
      "site_url": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=Google-L&refid=PLGOOGLEMSS&refclickid=US_HP%7C43756706_localuniversal_2%7C20261112%7Cdesktop%7Cuserdate|public|||29%7C2%7C0|0|EN&hotelid=43756706&checkin=20261112&checkout=20261114&rooms=1&cur=USD&POSCountryCode=US&taxDisplayMode=BP&cityID=3000016474&adults=4&land=L&metaid=H62cz-JuPRvOebA4y4svbysBGhV5iGFREq_5yxlaX49wORuc4QFZHd944tiJdvhobCuFG0Fj04kpqGVM5Gb6u79G6b9CVlrPTOMSF4iyis-uFp4dTgGXJiAlib8im38AnJ5LA_vvqbxW2MZRVcCpICzdUckg-PBHnN3fCJggjvA7YA2HLvayyuAcKOsZugfkP6ek1tQUAz6sIbonjetOr7PF1nI38UIqeyFXstpqeosVahcWtHR0IKZmtGEKg2_jZ6tO_wjkv2y0e-UJOfWVKkxTbtSDP3RCw0DrLzBsIL6OOj7x8hH5LRumr_LrUefTNgIREWPBiuixfwYeR90q3Yr_kwDHrzjao9mfXS-rx3bb20jThMoCb8T36cnBzBXqQ4XmpdJbr7uHLDxz3ON8ph_8xsEXhuYv15LYdjv9wCCVUzgmWKABWjiX_KBkhftaAXvE_m_HD5Qp7OKv75eZkX74Ptp-fceZu10NePOugs5enJ8ewPSwPcCY_YbcO2xtJE7rT8LPdVv_xIjxI46K6Q&dblcnt=true&hc=1&pdtax=45.08&pdf=0.00&pdt=303.08&locale=en-us&ad-src=&numChild=0&aid=&selAdults=2",
      "sponsored": false,
      "logo": "https://www.gstatic.com/travel-hotels/branding/icon_220.png"
    }
  ],
  "sites_count": 18,
  "sites_priced": 18,
  "lowest_site": "KAYAK.com",
  "lowest_site_price": 119.0,
  "lowest_site_price_with_taxes": 142.0,
  "official_site_price": 168.0,
  "parity_gap": 49.0,
  "sponsored_sites": [
    {
      "site": "Fairfield by Marriott Inn & Suites New York Staten Island",
      "partner_id": 100231600,
      "is_official_site": true,
      "nightly_price": 168.0,
      "nightly_price_with_taxes": 196.0,
      "total_price": 337.0,
      "total_price_with_taxes": 392.0,
      "nightly_price_display": "$168",
      "free_cancellation": false,
      "free_cancellation_until": null,
      "rate_note": "Get the best prices plus free Wi-Fi with free membership enrollment",
      "member_nightly_price": 168.0,
      "booking_url": "https://www.google.com/aclk?sa=l&ai=DChsSEwjakpn73rmXAxW9bkcBHcSeEaUYACICCAEQJxoCcXU&co=1&ase=2&gclid=EAIaIQobChMI2pKZ-965lwMVvW5HAR3EnhGlEAoYASABEgJCQPD_BwE&cid=CAAS0wHkaPbql05Ohz0bmsFMVtHrY7N61Rid5ESBEHVDme_KuCv1SwkhQNfJrF0w40KCUpyj2U9wEzyHAqJt74s9TZZxO385_kVPKpA8jQ_XACXHtFX3SgHak8FCNHmBZMGN78U6g-_bvU9_RJRIIs7senw-u8XRwcZGiyYJbVBeCqY0Qp25i26Wc2ccR8keo7hFPx2GPU7dwSbXMVklEdDzLMSlksWeeIIN1TA3X__QBdPTL3jOhHieNOsJndKYIle0VJ-Mxb68rM9zSGVIzSzeIfIKkNy7&category=acrcp_v1_48&sig=AOD64_2B3X8C_RmKq9k4Ly-lXvk1oS6kuw&adurl",
      "site_url": null,
      "sponsored": true,
      "logo": "https://www.gstatic.com/travel-hotels/branding/df3424c9-7799-4d27-aeb5-cdcabf8bf950.png"
    },
    {
      "site": "Booking.com",
      "partner_id": 184,
      "is_official_site": false,
      "nightly_price": 168.0,
      "nightly_price_with_taxes": 196.0,
      "total_price": 335.0,
      "total_price_with_taxes": 392.0,
      "nightly_price_display": "$168",
      "free_cancellation": false,
      "free_cancellation_until": null,
      "rate_note": null,
      "member_nightly_price": null,
      "booking_url": "https://www.google.com/aclk?sa=l&ai=DChsSEwjakpn73rmXAxW9bkcBHcSeEaUYACICCAEQHxoCcXU&co=1&ase=2&gclid=EAIaIQobChMI2pKZ-965lwMVvW5HAR3EnhGlEAoYAiABEgKZFvD_BwE&cid=CAAS0wHkaPbql05Ohz0bmsFMVtHrY7N61Rid5ESBEHVDme_KuCv1SwkhQNfJrF0w40KCUpyj2U9wEzyHAqJt74s9TZZxO385_kVPKpA8jQ_XACXHtFX3SgHak8FCNHmBZMGN78U6g-_bvU9_RJRIIs7senw-u8XRwcZGiyYJbVBeCqY0Qp25i26Wc2ccR8keo7hFPx2GPU7dwSbXMVklEdDzLMSlksWeeIIN1TA3X__QBdPTL3jOhHieNOsJndKYIle0VJ-Mxb68rM9zSGVIzSzeIfIKkNy7&category=acrcp_v1_48&sig=AOD64_29NF7hPw24UT_0OdZsyC-ZX9bH8w&adurl",
      "site_url": null,
      "sponsored": true,
      "logo": "https://www.gstatic.com/travel-hotels/branding/icon_184.png"
    }
  ],
  "results_count": 1221,
  "results_count_page": 1221,
  "place_resolved": "New York",
  "hotels_found": null,
  "hotels_delivered": null,
  "verdict": null,
  "verdict_detail": null,
  "list_calls": null,
  "change_type": null,
  "changed_fields": null,
  "previous_read_at": null,
  "first_read_at": null,
  "times_read": null,
  "previous_price": null,
  "price_change": null,
  "sites_gained": null,
  "sites_lost": null,
  "sites_changed": null,
  "price_history_own": null,
  "date": null,
  "day_rank": null,
  "is_cheapest": null
}

Pricing

Pay only for the rows a run delivers, with no start fee and no platform usage billed to you. Prices fall with your Apify plan.

per 1,000	Free	Starter	Scale	Business
Hotel (hotel)	$2.87	$2.4395	$2.009	$1.435
Booking-site list and full record of a hotel (details)	$4.00	$3.40	$2.80	$2.00
Price calendar day (calendar_day)	$3.00	$2.55	$2.10	$1.50

A hotel row is $2.87 per 1,000 on the Free plan ($0.00287 a hotel) and $1.435 on Business: Google's first page for a place (18–20 hotels) costs $0.0574 on the Free plan, 500 hotels of a large city $1.435. The booking-site list with the full record is an extra $0.004 ($0.002 on Business) on each hotel row that carries it (details_read true): the first detailsFor hotels of a search and every hotel of hotels. A price-calendar day is a row of its own at the price above: a calendar of N days is N calendar_day rows, the asked stay's date included (its row repeats that date's site list on the hotel row), so one hotel with a 30-day calendar costs $0.09687 on the Free plan (the hotel row, its booking-site list and 30 days). Free: every search summary row (Google's count, the distinct hotels read, the verdict, the status and its reason), a search Google lists no hotels for (no_hotels), a value that is no search (invalid), a refusal the exits could not pass or a list in another stay or currency than the one asked (failed), a calendar date Google did not answer (no row), the unchanged hotels onlyChanges does not deliver, and a run that failed before its first row. A run that stops early (a timeout, an abort) is charged for the rows it delivered. maxItems counts the charged rows (hotels and calendar days); before the first request the log says the most the run can cost at your plan's prices (for a search with no maxHotelsPerSearch and no maxItems, an estimate: such a search reads to Google's end, 893 hotels for New York on our run). Enterprise plans have their own rates — the Actor's Pricing tab shows the price for your plan.

Usage patterns

• One search or many — Give query (a city, a neighbourhood, a landmark) with checkIn and checkOut, or list searches in searches (objects with their own stay, party, market and filters; texts such as hotels in Paris 2026-11-12 2026-11-14; Google Hotels search URLs), or hotels in hotels (a name with its city, a Google Hotels URL or an entity id). A date is YYYY-MM-DD or +N, N days after the day of the run (UTC): +30 / +32 for a two-night stay a month ahead, so a saved task or a schedule never asks for a past day (a past date is a free invalid row that says so). Every row carries search_id and search_label, and every search gets one free search row with its status and verdict.
• What a row is — row_type = hotel: one hotel Google lists for the search, in the order asked (rank; Google's order for relevance), with its class, rating, review count, prices, deal, amenities, photos, nearby places, Google's ids and links; with the details call also the booking-site list (sites), the address and phone, the histogram, the aspects, the reviews. search: the free summary of a search (Google's count, the place Google resolved, distinct hotels read and delivered, the verdict with its reason, the status). calendar_day: one check-in date of a hotel's price calendar with the lowest site price, the official site's price and the dated site list.
• How far a search goes — maxHotelsPerSearch = 0 (the default) reads every hotel Google lists for the stay: the relevance list to its end (Google repeats its pages after about 500 distinct records), then the hotels sorted by price and each class facet under both orders (about 200 more each), all de-duplicated by Google's id — 500–900 distinct hotels for a big city, 2–3 minutes on four exits. maxHotelsPerSearch = 20 is the first screen and one page (two calls). The summary row's verdict and verdict_detail say what was read against Google's results_count.
• Filters and sorts — hotelClass, minRating (3.5 / 4 / 4.5), maxPrice, amenities (18 of Google's amenity filters: pool, indoor and outdoor pool, free parking, parking, spa, fitness center, restaurant, bar, free breakfast, free Wi-Fi, pet-friendly, kid-friendly, airport shuttle, room service, hot tub, beach access, air conditioning; several = all of them), freeCancellation and specialOffers are applied by Google on its own request; minPrice is applied on the records read (Google's request takes no minimum we could find), so a hotel Google lists without a price is left out. sortBy relevance / lowest_price / highest_rating / most_reviewed are Google's own sorts; the rows come out in that order. propertyType hotels (the default), vacation_rentals or all: Google's mixed list holds both, told apart by Google's own type flag.
• The booking-site list and the full record — detailsFor N reads, for the first N hotels of each place search, one more call: the dated price per booking site with Google's click-out link (booking_url) and the site's own deep link for the stay (site_url), the official-site flag, free cancellation and its deadline, the member-rate note; plus the address and phone, the website, the amenity groups, the rating histogram, the review aspects and texts, the external ratings, the nearby places. A hotel in hotels always gets it. The row carries lowest_site, lowest_site_price, official_site_price and parity_gap; the sponsored block is sponsored_sites.
• A price calendar — calendarDays N reads, for each hotel of hotels (and the first detailsFor hotels of a search), the stay on each of the next N check-in dates with the stay's length kept: one calendar_day row per date with lowest_site_price, official_site_price, sites_count and the dated sites list; day_rank and is_cheapest rank the dates by the lowest price. The asked stay's date is the first row (from the call already made for the hotel row), each further date one call; every row is a charged calendar_day.
• Monitoring: only what moved — onlyChanges with a stateStoreName remembers every hotel row delivered (by Google's id and the stay) and, on the next run of the same memory, delivers only the hotels that are new or whose nightly price with taxes (or, with the details call, a site's price) moved: change_type, previous_price, price_change, sites_gained, sites_lost, sites_changed and price_history_own (our own reads) say what. Unchanged hotels are counted in the summary, not delivered, not charged. Save it as a task and schedule it with the stay's own dates (YYYY-MM-DD): a +N date moves with the day, so each day's list is new to the memory.
• Markets, languages and currencies — market (the point of sale), language (the texts: class labels, group names) and currency (every price) are sent on every call; the row carries currency_served, the currency Google answered with, and a list in another currency is a free failed row. The prices are computed from Google's own parts on every exit, so a German market read and a US market read of the same hotel carry the same nightly_price and nightly_price_with_taxes.

Input configuration

field	type	default	what it does
query	string	""	A place to search hotels in: a city, a neighbourhood, a landmark (New York, hotels in Barcelona, Times Square hotels). Google resolves the words; every row carries the place it resolved (place_resolved). Not searched when searches or hotels has an item: the list is then the whole run, and the dates and options here are its defaults.
checkIn	string	""	The check-in date, YYYY-MM-DD, or +N for N days after the day of the run (UTC): +30. A date in the past is a free invalid row.
checkOut	string	""	The check-out date, YYYY-MM-DD or +N; empty = the night after check-in. At most 30 nights.
searches	array	[]	A list of searches, each an object {"query": "hotels in Paris", "checkIn": "+30", "checkOut": "+32", "adults": 2, "childrenAges": [8], "market": "FR", "language": "fr", "currency": "EUR", "sortBy": "lowest_price", "hotelClass": [4, 5], "minRating": 4, "maxPrice": 250, "amenities": ["pool"], "freeCancellation": true, "propertyType": "hotels"} (the run's fields are the defaults; the run's query is then not searched), a text hotels in Paris 2026-11-12 2026-11-14, or a Google Hotels search URL. Up to 200 searches a run; a value that is no search is a free invalid row.
hotels	array	[]	One hotel per line for the stay above: a name with its city (Arlo NoMad New York), a Google Hotels URL (https://www.google.com/travel/hotels/entity/ChkI…/prices) or a bare entity id (ChkI5-ea3sPi9Y9PGg0vZy8xMWM1NF81cHF3EAE). Each one is a hotel row with the dated booking-site list and the full record (the details event). With a hotel here, the run's query is not searched.
adults	integer	2	Adults in the room (1–10). Google prices one room; every price is for this party.
childrenAges	array	[]	One line per child with the child's age (0–17): 8, 3. Google prices the stay for the party; the rows carry the ages asked.
maxHotelsPerSearch	integer	0	Stop a place search after this many distinct hotels. 0 = every hotel Google lists for the stay: the relevance list to its end, then the class facets and the price order (about 500–900 distinct for a big city; the summary row says how many Google counts and whether the list was COMPLETE, TRUNCATED or CAPPED).
detailsFor	integer	0	For the first N hotels of each place search, one more call each: the dated price per booking site (Google's click-out link and the site's own deep link, the official-site flag, free cancellation), the address and phone, the amenity groups, the rating histogram, the review aspects and texts, the nearby places. Charged as the details event on those rows. Hotels in hotels always get it.
calendarDays	integer	0	For each hotel of hotels (and the first detailsFor hotels of a search), read the stay on each of the next N check-in dates, the stay's length kept: one calendar_day row per date with the lowest site price, the official site's price and the dated site list. One call per date.
sortBy	relevance / lowest_price / highest_rating / most_reviewed	"relevance"	relevance keeps Google's own order (the first screen first); lowest_price, highest_rating and most_reviewed are Google's own sorts (the rows come out in that order).
hotelClass	array	[]	Keep these classes only, one per line: 4, 5. Applied by Google.
minRating	`` / 3.5 / 4 / 4.5	""	Google's own rating steps: 3.5+, 4.0+ or 4.5+. Applied by Google.
maxPrice	integer	0	Keep hotels up to this nightly price (before taxes, in currency). Applied by Google. 0 = no limit.
minPrice	integer	0	Keep hotels from this nightly price up (before taxes, in currency). Applied on the records read (Google's request takes no minimum). 0 = no limit.
amenities	array	[]	Keep hotels with every one of these amenities, one per line: free_parking, parking, indoor_pool, outdoor_pool, pool, fitness_center, restaurant, free_breakfast, spa, beach_access, kid_friendly, airport_shuttle, bar, pet_friendly, room_service, hot_tub, free_wifi, air_conditioning. Applied by Google (its own amenity filter ids); several amenities = hotels with all of them.
freeCancellation	boolean	false	Keep hotels with a free-cancellation rate; the prices shown are the refundable rates. Applied by Google.
specialOffers	boolean	false	Keep hotels Google marks with a deal. Applied by Google.
propertyType	hotels / vacation_rentals / all	"hotels"	hotels (the default: Google's hotel records), vacation_rentals (the rental records of Google's mixed list: apartments, houses) or all. Every row carries property_type.
market	string	"US"	The two-letter country Google serves the view for (US, GB, DE, …): the point of sale and the strings' market.
language	string	"en"	The language of the texts (en, de, fr, es, pt-BR, …): class labels, descriptions, amenity group names.
currency	string	"USD"	The currency of every price (USD, EUR, GBP, JPY, …). Each row carries the currency Google answered with (currency_served); a list in another currency is a free failed row, never a charged one.
onlyChanges	boolean	false	Remember every hotel row delivered (by its Google id and stay) and, on the next run of the same memory, deliver only the hotels that are new or whose nightly price with taxes (or a site's price, with detailsFor) moved: change_type, previous_price, price_change, sites_gained, sites_lost, sites_changed say what. Unchanged hotels are counted, not delivered, not charged.
stateStoreName	string	""	With onlyChanges: the name of the memory to keep between runs (letters, digits, dashes); empty = a name derived from the searches.
maxItems	integer	0	Stop after this many charged rows (hotels and calendar days; the free search summary rows do not count). 0 = no limit.

Errors

A run does not fail because of your input. When an input cannot be used — a date that is not a date, an id in the wrong form, two settings that contradict each other — the run ends Succeeded, charges nothing, and says what to change:

• the status message starts with INPUT REJECTED;
• the dataset holds one row, {"error": true, "code": "…", "message": "…"}, and no results;
• the key-value store record ERROR holds the same object.

From code, check error on the first row before reading results.

A search Google lists no hotels for is not an error: it gets one free search row with status no_hotels and the reason, and the run goes on with the others. A run that ends Failed is a fault on our side, never your input; it charges nothing, and we are alerted.

FAQ

How many hotels does a search return?

As many as you ask (maxHotelsPerSearch) up to every hotel Google lists for the stay. Google shows a count for the stay (results_count, 1,221 hotels for New York on our test) but serves about 200 distinct hotels per sorted list and 500 under relevance before its pages repeat; the Actor walks the relevance list, the price order and the class facets and reaches 500–900 distinct hotels for a big city. The summary row's verdict says COMPLETE, TRUNCATED (with the reason) or CAPPED.

Which price is which?

nightly_price is Google's main figure, the nightly rate before taxes (room rate and fees); nightly_price_with_taxes adds the taxes. total_price and total_price_with_taxes are the same for the whole stay; price_base, taxes and fees are the stay's parts Google itself sends, so nightly × nights = total. The display strings Google showed are in nightly_price_display and nightly_price_with_taxes_display. Every figure is in currency_served.

Are the prices for my party?

Yes: adults and childrenAges go into Google's request and every record echoes the stay; the rows carry the party asked. Google prices one room; there is no rooms input because Google Hotels has none.

Do the booking links work?

booking_url is Google's own click-out link (it redirects to the site) and site_url the site's own deep link for the stay, decoded from it, with the dates inside; both are delivered so a dead redirect is visible. sponsored_sites holds Google's featured block with its ad links apart from the organic list.

Why does a search end as failed with 'Google answered the stay …'?

Google Hotels takes the stay from the request's state; when its answer echoes another stay or another currency than the one you asked (it happens on a hotel-name search Google resolves to its default stay, or on a currency Google does not price), the rows would carry the wrong prices, so they are not delivered and the search says what Google answered. Nothing is charged for it.

Can I get the Google Hotels amenities as names?

Yes: Google sends amenity codes; the Actor maps the 73 codes it met on the pages it studied to Google's own names (amenities, amenities_unavailable), with Google's qualifier where it gives one (Wi-Fi (free), Parking (extra charge), Front desk (24 hours)), and delivers an unmapped code as code:<n> in amenity_codes, so nothing is lost. The details call adds the grouped list (amenity_groups: Internet, Food & drink, Pools, Parking, Accessibility, Pets, Services, Wellness, Rooms, Bathrooms, …).

What about vacation rentals?

propertyType = vacation_rentals keeps the rental records of Google's mixed list (apartments, houses, rooms; Google's own type flag), all keeps both. A rental has no class and no feature id; its amenities come as names.

What does a run cost?

The log's first line says the most the run can cost at your plan's prices for what you asked (an estimate for a search with no maxHotelsPerSearch and no maxItems: it reads to Google's end; set either for a hard maximum); only rows Google served are charged, the free rows never. A run that stops early (a timeout, an abort) is charged for the rows it delivered.

Integration

JavaScript

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('hyperbach/google-hotels-scraper').call({"query": "hotels in New York", "checkIn": "+30", "checkOut": "+32", "maxHotelsPerSearch": 20});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')
run = client.actor('hyperbach/google-hotels-scraper').call(run_input={'query': 'hotels in New York', 'checkIn': '+30', 'checkOut': '+32', 'maxHotelsPerSearch': 20})
items = client.dataset(run['defaultDatasetId']).list_items().items

CLI

$apify call hyperbach/google-hotels-scraper --input '{"query": "hotels in New York", "checkIn": "+30", "checkOut": "+32", "maxHotelsPerSearch": 20}'

REST

curl -X POST "https://api.apify.com/v2/acts/hyperbach~google-hotels-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H 'Content-Type: application/json' -d '{"query": "hotels in New York", "checkIn": "+30", "checkOut": "+32", "maxHotelsPerSearch": 20}'

Support

apify@hyperbach.com

This page is generated from the Actor's schemas and a live sample — it cannot describe a field the Actor does not have.