# Google Hotels Extractor Fast & affordable (`kawsar/google-hotels-extractor-fast-affordable`) Actor Google Hotels scraper that pulls live prices, guest ratings, review counts, and locations for any city and date range. No login or API key needed. It walks the full result list and exports clean JSON or CSV for price tracking, travel research, and SEO work. - **URL**: https://apify.com/kawsar/google-hotels-extractor-fast-affordable.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** Travel, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Hotels Extractor: Scrape Hotel Prices, Ratings, and Reviews Google Hotels Extractor pulls live hotel listings straight from Google Hotels search results. Give it a city and your travel dates, and it returns hotel names, nightly prices, star ratings, review counts, map coordinates, descriptions, and photos as structured data you can download in JSON, CSV, or Excel, or send to another app. It runs on plain HTTP requests, not a browser. That makes it fast, cheap to run, and free of logins, cookies, or API keys. A typical search finishes in seconds, and one run can collect hundreds of unique hotels per location. ### What data does this actor extract? For every hotel in the search results you get: - Hotel name and star class (for example, 4-star hotel) - Nightly price for your dates, as displayed and as a plain number, in your chosen currency - A reference rate when Google shows one, so you can spot deals - Guest rating out of 5 and the total review count - Latitude, longitude, and the Google place id - A short description and the main photo URL - A Google Maps link and a Google Hotels link for the exact property - The search location, your check-in and check-out dates, and a scrape timestamp ### Use cases - **Hotel price tracking**: watch how nightly rates for a city move across different check-in and check-out dates - **Travel market research**: compare hotel prices, ratings, and star classes across several cities in one run - **Revenue management**: benchmark your property against nearby competitors on price and guest rating - **SEO and content work**: pull real hotel data for travel guides, comparison pages, and destination articles - **Lead generation**: build lists of hotels with locations and ratings for a target market - **Data science**: feed clean, structured hotel data into pricing models and dashboards ### Input | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `locations` | array | ["New York"] | One or more places to search, one per line. Cities work best; neighborhoods work too. | | `checkInDate` | string | 2026-08-01 | Check-in date in YYYY-MM-DD format. Prices are returned for this stay. | | `checkOutDate` | string | 2026-08-03 | Check-out date in YYYY-MM-DD format. Must be after check-in. | | `adults` | integer | 2 | Number of adult guests. | | `currency` | string | USD | Three-letter currency code for prices: USD, EUR, GBP, JPY, BDT, and any other code Google supports. | | `languageCode` | string | en | Interface language for results, for example en, fr, de, es. | | `countryCode` | string | us | Two-letter search region, for example us, gb, fr, bd. | | `maxResults` | integer | 20 | Upper limit on hotels stored per location. Raise it up to 1000 for large extractions. | | `requestTimeoutSecs` | integer | 30 | Timeout for each request to Google. | | `proxyConfiguration` | object | Datacenter (Anywhere) | Proxy type and location for requests. Supports Datacenter, Residential, Special, and custom proxies. Optional; the actor falls back to a direct connection if the proxy fails. | #### Example input ```json { "locations": ["New York", "Paris"], "checkInDate": "2026-08-01", "checkOutDate": "2026-08-03", "adults": 2, "currency": "USD", "languageCode": "en", "countryCode": "us", "maxResults": 100, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output The actor stores results in a dataset. Each hotel is one record: ```json { "name": "The Manhattan at Times Square Hotel", "price": "$196", "priceValue": 196.22, "currency": "USD", "compareRate": 350, "rating": 3.0, "reviewCount": 10116, "hotelClass": "4-star hotel", "starRating": 4, "latitude": 40.7622856, "longitude": -73.9826404, "placeId": "0x89c258f88254f2c3:0xe0e14597c5400022", "hotelDescription": "Polished hotel offering streamlined rooms & suites, plus a marble-clad lobby lounge & a gym.", "imageUrl": "https://lh5.googleusercontent.com/proxy/...", "googleMapsUrl": "https://www.google.com/maps?cid=16204681299999999999", "googleHotelsUrl": "https://www.google.com/travel/search?q=The+Manhattan+at+Times+Square+Hotel+New+York", "location": "New York", "checkInDate": "2026-08-01", "checkOutDate": "2026-08-03", "scrapedAt": "2026-07-11T10:34:32+00:00" } ``` | Field | Type | Description | |-------|------|-------------| | `name` | string | Hotel name. | | `price` | string | Nightly price with currency symbol. | | `priceValue` | number | Nightly price as a plain number, ready for spreadsheets and models. | | `currency` | string | Currency the price is quoted in. | | `compareRate` | number | Reference rate Google compares the deal against, when shown. | | `rating` | number | Average guest rating out of 5, computed from the review breakdown. | | `reviewCount` | integer | Total number of guest reviews. | | `hotelClass` | string | Star class label, for example 4-star hotel. | | `starRating` | integer | Numeric star class from 1 to 5, when published. | | `latitude` | number | Hotel latitude. | | `longitude` | number | Hotel longitude. | | `placeId` | string | Google place identifier, useful for joining with other Google data. | | `hotelDescription` | string | Short description of the hotel. | | `imageUrl` | string | Main hotel photo URL. | | `googleMapsUrl` | string | Google Maps link to the exact property. | | `googleHotelsUrl` | string | Google Hotels search link for the property, to compare rates and book. | | `location` | string | Search location the hotel was returned for. | | `checkInDate` | string | Check-in date used for the price. | | `checkOutDate` | string | Check-out date used for the price. | | `scrapedAt` | string | UTC time the record was collected. | ### How it works 1. For each location, the actor loads Google's hotel search page once and reads the current search configuration from it, so nothing is hardcoded and the actor keeps working when Google changes internal identifiers. 2. It then calls the same data endpoint the Google Hotels page itself uses, with your dates, guests, currency, language, and region. 3. It follows Google's own next-page tokens to walk through the full result list, about 20 hotels per page. 4. If the list ends before your `maxResults`, it runs extra passes with different serving orders. Each order surfaces hotels the previous pass never showed. 5. Every record is deduplicated by place id, cleaned, and stored in your dataset. ### How to use 1. Open the actor on Apify and press **Try for free**. 2. Enter one or more locations, your dates, and the number of hotels you want. 3. Press **Start**. A run for the default 20 hotels takes well under a minute. 4. Download the results from the **Dataset** tab as JSON, CSV, Excel, or HTML, or fetch them through the Apify API. You can also schedule the actor to run daily or weekly to track prices over time, and connect a webhook to get notified when results are ready. ### Tips for better results - Ask for what you need. `maxResults: 20` answers most questions in seconds; `maxResults: 500` is there when you need depth. - Prices depend on dates. Weekend and holiday stays often price higher, so keep dates consistent when comparing runs. - Set `currency` and `countryCode` together for the cleanest localized results, for example EUR with fr, or BDT with bd. - Several small areas can beat one big one. Searching "Manhattan", "Brooklyn", and "Queens" separately gives finer control than "New York" alone. - The default Datacenter proxy is fine for most runs. If you see request failures, switch to Residential in the proxy section. ### FAQ **Do I need a Google account or API key?** No. The actor works without any login, cookies, or key. **How many hotels can it return per location?** As many as Google serves for that search, up to your `maxResults`. The actor walks the full paginated list and then widens coverage with extra passes, so even a single neighborhood search can produce 500+ unique hotels. If a small town only has 40 hotels, you get all 40. **Are the prices real?** Prices come from the same data Google shows on its own Hotels page for your exact dates, guests, and currency. They include the nightly display price and a numeric value. Availability and rates change constantly, so treat each run as a snapshot in time. **Can I search more than one city at once?** Yes. Add several entries to `locations` and the actor searches each one in turn, tagging every record with its search location. **Which currencies and languages work?** Any currency code Google Hotels supports (USD, EUR, GBP, JPY, BDT, INR, and more) and any interface language through `languageCode`. **Does it use a browser?** No. It uses direct HTTP requests, which keeps runs fast and compute costs low compared to browser-based scrapers. **What happens if my proxy fails?** The actor retries with a fresh proxy, then falls back to a direct connection, so a bad proxy does not produce an empty run. **Is scraping Google Hotels legal?** The actor collects publicly available data only: prices, ratings, and facts that anyone can see without logging in. It stores no personal data. Still, you are responsible for how you use the results, so check the rules that apply to your project and jurisdiction. ### Integrations Connect Google Hotels Extractor with other apps and services using [Apify integrations](https://apify.com/integrations). You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and many more. You can also use [webhooks](https://docs.apify.com/integrations/webhooks) to trigger actions whenever results are available, for example a Slack alert when a competitor drops prices. Start pulling Google Hotels prices, ratings, and reviews in one run. No browser, no account, no API key required. # Actor input Schema ## `locations` (type: `array`): One or more places to search hotels in. Enter a city, neighborhood, or landmark (for example New York, Paris, Tokyo). The actor searches 'Hotels in ' for each entry. ## `checkInDate` (type: `string`): Check-in date in YYYY-MM-DD format. Prices and availability are returned for this stay. ## `checkOutDate` (type: `string`): Check-out date in YYYY-MM-DD format. Must be after the check-in date. ## `adults` (type: `integer`): Number of adult guests per room. ## `currency` (type: `string`): Three-letter currency code for prices (for example USD, EUR, GBP, JPY). ## `languageCode` (type: `string`): Interface language for the results (hl parameter), for example en, fr, de. ## `countryCode` (type: `string`): Two-letter country code for the search region (gl parameter), for example us, gb, fr. ## `maxResults` (type: `integer`): Upper limit on hotels to store per location. The actor pages through Google's results, and runs extra passes when needed, until it reaches this number or Google has nothing new left. Raise it up to 1000 for large extractions. ## `requestTimeoutSecs` (type: `integer`): Timeout for each HTTP request to Google. ## `proxyConfiguration` (type: `object`): Select proxies to use for requests. Helps avoid IP blocking and rate limits. Datacenter proxies are fastest; Residential proxies are harder to detect. ## Actor input object example ```json { "locations": [ "New York", "Paris" ], "checkInDate": "2026-08-01", "checkOutDate": "2026-08-03", "adults": 2, "currency": "USD", "languageCode": "en", "countryCode": "us", "maxResults": 20, "requestTimeoutSecs": 30, "proxyConfiguration": { "useApifyProxy": true } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "locations": [ "New York" ], "checkInDate": "2026-08-01", "checkOutDate": "2026-08-03", "adults": 2, "currency": "USD", "languageCode": "en", "countryCode": "us", "maxResults": 20, "requestTimeoutSecs": 30, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/google-hotels-extractor-fast-affordable").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "locations": ["New York"], "checkInDate": "2026-08-01", "checkOutDate": "2026-08-03", "adults": 2, "currency": "USD", "languageCode": "en", "countryCode": "us", "maxResults": 20, "requestTimeoutSecs": 30, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("kawsar/google-hotels-extractor-fast-affordable").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "locations": [ "New York" ], "checkInDate": "2026-08-01", "checkOutDate": "2026-08-03", "adults": 2, "currency": "USD", "languageCode": "en", "countryCode": "us", "maxResults": 20, "requestTimeoutSecs": 30, "proxyConfiguration": { "useApifyProxy": true } }' | apify call kawsar/google-hotels-extractor-fast-affordable --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/google-hotels-extractor-fast-affordable", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Hotels Extractor Fast & affordable", "description": "Google Hotels scraper that pulls live prices, guest ratings, review counts, and locations for any city and date range. No login or API key needed. It walks the full result list and exports clean JSON or CSV for price tracking, travel research, and SEO work.", "version": "0.0", "x-build-id": "hEveyrsRxcY8kDdO1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~google-hotels-extractor-fast-affordable/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-google-hotels-extractor-fast-affordable", "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/kawsar~google-hotels-extractor-fast-affordable/runs": { "post": { "operationId": "runs-sync-kawsar-google-hotels-extractor-fast-affordable", "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/kawsar~google-hotels-extractor-fast-affordable/run-sync": { "post": { "operationId": "run-sync-kawsar-google-hotels-extractor-fast-affordable", "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", "required": [ "locations", "checkInDate", "checkOutDate" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "One or more places to search hotels in. Enter a city, neighborhood, or landmark (for example New York, Paris, Tokyo). The actor searches 'Hotels in ' for each entry.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Prices and availability are returned for this stay." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Must be after the check-in date." }, "adults": { "title": "Adults", "type": "integer", "description": "Number of adult guests per room.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for prices (for example USD, EUR, GBP, JPY).", "default": "USD" }, "languageCode": { "title": "Language code", "type": "string", "description": "Interface language for the results (hl parameter), for example en, fr, de.", "default": "en" }, "countryCode": { "title": "Country code", "type": "string", "description": "Two-letter country code for the search region (gl parameter), for example us, gb, fr.", "default": "us" }, "maxResults": { "title": "Max results per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper limit on hotels to store per location. The actor pages through Google's results, and runs extra passes when needed, until it reaches this number or Google has nothing new left. Raise it up to 1000 for large extractions.", "default": 20 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Timeout for each HTTP request to Google.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to use for requests. Helps avoid IP blocking and rate limits. Datacenter proxies are fastest; Residential proxies are harder to detect." } } }, "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 } } }, "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 } } } } } } } } } } ```