Google Hotels Scraper - Prices, Booking Sites & Reviews
Pricing
from $1.50 / 1,000 hotels
Google Hotels API alternative: hotels in any city with live prices, every booking site's rate (Booking.com, Expedia, Agoda, official site) across a date range, room rates, free-cancellation deadlines and guest reviews. Rate parity and hotel price monitoring. From $1.50 per 1,000.
You can access the Google Hotels Scraper - Prices, Booking Sites & Reviews programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "vr0fQUFnBDblvM14N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alom~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alom-google-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/alom~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-alom-google-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/alom~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-alom-google-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What to scrape", "enum": [ "search", "hotelPrices", "reviews" ], "type": "string", "description": "<b>Search</b>: one row per hotel for a destination. <b>Hotel prices</b>: one row per hotel x check-in date x booking site (Booking.com, Expedia, the official site...). <b>Reviews</b>: one row per guest review of the hotels you list (Google reviews plus Tripadvisor / TrustYou reviews shown on Google).", "default": "search" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "For <b>search</b> mode. Anything you would type into Google Hotels: <code>hotels in Paris</code>, <code>Lisbon</code>, <code>resorts in Cancun</code>, <code>hotels near Times Square</code>.", "items": { "type": "string" } }, "maxResults": { "title": "Max hotels per query", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop after this many hotels per search query. Google's list for a big city runs into the hundreds.", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "lowest_price", "highest_rating", "most_reviewed" ], "type": "string", "description": "Order of search results.", "default": "relevance" }, "minPrice": { "title": "Min price per night", "minimum": 0, "type": "integer", "description": "In the chosen currency. Hotels without a price are left out when a price filter is set." }, "maxPrice": { "title": "Max price per night", "minimum": 0, "type": "integer", "description": "In the chosen currency." }, "minRating": { "title": "Min guest rating", "enum": [ "3.5", "4", "4.5" ], "type": "string", "description": "Only hotels rated at least this (1-5)." }, "hotelClass": { "title": "Hotel class (stars)", "type": "array", "description": "Only hotels with these star ratings.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "amenities": { "title": "Amenities", "type": "array", "description": "Only hotels with all of these (filtered by Google).", "items": { "type": "string", "enum": [ "free_wifi", "free_breakfast", "free_parking", "pool", "indoor_pool", "outdoor_pool", "fitness_center", "spa", "restaurant", "bar", "room_service", "kid_friendly", "pet_friendly", "beach_access", "air_conditioned", "wheelchair_accessible", "all_inclusive", "ev_charger" ], "enumTitles": [ "Free Wi-Fi", "Free breakfast", "Free parking", "Pool", "Indoor pool", "Outdoor pool", "Fitness center", "Spa", "Restaurant", "Bar", "Room service", "Kid-friendly", "Pet-friendly", "Beach access", "Air conditioning", "Wheelchair accessible", "All-inclusive", "EV charger" ] } }, "freeCancellation": { "title": "Free cancellation only", "type": "boolean", "description": "Only hotels with a free-cancellation offer.", "default": false }, "includeVacationRentals": { "title": "Include vacation rentals", "type": "boolean", "description": "Google mixes apartments and holiday homes into hotel results. Turn off for hotels only.", "default": true }, "onlyDeals": { "title": "Only hotels with a deal", "type": "boolean", "description": "Google's <i>Special offers</i> filter: only hotels with a deal for your dates (e.g. \"22% less than usual\", in <code>dealLabel</code>).", "default": false }, "maxImages": { "title": "Photos per hotel", "minimum": 0, "maximum": 100, "type": "integer", "description": "Photo URLs per hotel (1024 px). Search cards carry ~9; with booking-site prices or in hotel-prices mode the full gallery (hotel, guest and booking-site photos, often 20+) is available.", "default": 5 }, "includeProviderPrices": { "title": "Add every booking site's price to each hotel", "type": "boolean", "description": "Adds <code>offers</code> to each hotel row: price per booking site (Booking.com, Expedia, official site...) with booking links. One extra request per hotel; still billed as one result.", "default": false }, "hotels": { "title": "Hotels", "type": "array", "description": "For <b>hotel prices</b> and <b>reviews</b> modes. Google Hotels links (<code>google.com/travel/hotels/entity/...</code>), entity tokens (<code>ChcI...</code>, from the <code>entityToken</code> field of a search), or hotel names with the city (<code>Hilton Paris Opera</code>). Names are only accepted when Google finds a confident match.", "items": { "type": "string" } }, "lastCheckInDate": { "title": "Last check-in date (price calendar)", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|today|tomorrow|\\+\\d{1,3})$", "type": "string", "description": "Price every check-in date from <b>Check-in date</b> to this one (inclusive), e.g. 30 days of prices. Same formats as Check-in date." }, "checkInDates": { "title": "Specific check-in dates", "type": "array", "description": "Alternative to a range: a list of check-in dates (<code>2026-12-24</code>, <code>+30</code>). Past dates are skipped with a warning, so a scheduled run keeps working.", "items": { "type": "string" } }, "providers": { "title": "Only these booking sites", "type": "array", "description": "Optional. Keep only offers whose site name contains one of these (<code>booking.com</code>, <code>expedia</code>). <code>official</code> = the hotel's own website.", "items": { "type": "string" } }, "includeRoomRates": { "title": "Room types & rates", "type": "boolean", "description": "Adds <code>roomRates</code> to the offers of Google's featured booking sites (usually 3-5 per hotel, e.g. Booking.com, Expedia): every room type x rate with price, free cancellation (+ deadline), breakfast included and max guests. No extra requests; rows get larger. Every offer always carries <code>freeCancellation</code> as Google states it.", "default": false }, "includeReviews": { "title": "Include guest reviews", "type": "boolean", "description": "Also fetch guest reviews for every hotel delivered (search and hotel-prices modes; mode <b>Reviews</b> always does). Each review is its own row (<code>type: review</code>): text, rating, date, source (Google, Tripadvisor...), trip type / travel group, room/service/location sub-ratings and the hotel's response. Charged per review.", "default": false }, "maxReviews": { "title": "Max reviews per hotel", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many reviews per hotel (100 per request).", "default": 50 }, "reviewsSort": { "title": "Review order", "enum": [ "newest", "relevance", "highest", "lowest" ], "type": "string", "description": "Which reviews come first (and are kept when capped by Max reviews).", "default": "newest" }, "checkInDate": { "title": "Check-in date", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|today|tomorrow|\\+\\d{1,3})$", "type": "string", "description": "<code>2026-11-10</code>, or relative: <code>+14</code> (14 days from today), <code>today</code>, <code>tomorrow</code>. Relative dates keep scheduled runs valid. Default: 7 days from today." }, "checkOutDate": { "title": "Check-out date", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|today|tomorrow|\\+\\d{1,3})$", "type": "string", "description": "Optional; otherwise check-in + <b>Nights</b>. Google allows stays of up to 30 nights." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay when no check-out date is given (also for every date of a price calendar).", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Adult guests.", "default": 2 }, "childrenAges": { "title": "Children's ages", "type": "array", "description": "One age (0-17) per child, e.g. <code>[7, 12]</code>. Fewer sites sell rooms for families, so expect fewer offers." }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of rooms.", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "3-letter code: USD, EUR, GBP, JPY, INR, AUD...", "default": "USD" }, "country": { "title": "Market (country of the visitor)", "type": "string", "description": "Google shows prices as seen from this country (e.g. US prices exclude taxes and add a with-taxes figure; EU prices include taxes; some sites only sell in some countries). <b>US</b> is fastest. Other countries use residential IPs there.", "default": "US" }, "deltaMode": { "title": "Only changed prices (monitoring)", "type": "boolean", "description": "For scheduled runs: deliver only hotels / offers that are new or whose price changed since the previous run with the same monitor name, with the previous price. Unchanged prices are skipped and not charged.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate memory per monitor, e.g. <code>paris-weekly</code>. Default: <code>default</code>." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel queries / hotels.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave the default: US datacenter proxies, or residential proxies in the chosen market's country. Explicit settings here are used as given.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Google Hotels Scraper - Prices, Booking Sites & Reviews from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: