{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper - Prices, Ratings & Amenities", "description": "Scrape Google Hotels: nightly and total prices for your dates, rating, review count, star class, amenities, coordinates and website, following Google's result pages (about 20 hotels each) when Google serves them. Pay only for hotels returned. Not affiliated with Google.", "version": "1.0", "x-build-id": "hNK8thC4OKCZgtWvH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bao-labs~google-hotel-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bao-labs-google-hotel-prices", "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/bao-labs~google-hotel-prices/runs": { "post": { "operationId": "runs-sync-bao-labs-google-hotel-prices", "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/bao-labs~google-hotel-prices/run-sync": { "post": { "operationId": "run-sync-bao-labs-google-hotel-prices", "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" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "Where to look for hotels, one location per line, as you would type it into Google Hotels: a city (\"Paris\"), an area (\"Shibuya Tokyo\") or a phrase (\"hotels near Eiffel Tower\"). Be specific with ambiguous names, e.g. \"Paris Texas\". Each location is searched separately.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "First night of the stay, in YYYY-MM-DD format, e.g. 2026-11-18. Prices are the ones Google shows for these dates. Leave both dates empty to use 30 days after the day of the run." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Day you leave, in YYYY-MM-DD format, e.g. 2026-11-20. Must be after the check-in date. Leave both dates empty to stay 2 nights from the default check-in." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests (1-12). Prices depend on it. Example: 2.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for the prices, e.g. USD, EUR, GBP, JPY, VND.", "default": "USD" }, "maxResults": { "title": "Maximum hotels per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop a location after this many hotels (1-1000). Google returns about 20 per page; further pages are fetched automatically. We tested up to 100 per location. You pay only for hotels returned.", "default": 50 }, "country": { "title": "Country of the location (recommended)", "pattern": "^([A-Za-z]{2})?$", "type": "string", "description": "Two-letter code of the country the locations are in, e.g. VN for Hoi An. Recommended: Google places some locations only when asked from inside their country, and without it such a search can come back empty (in our test, \"Hoi An\" returned no hotels from a US address and 18 from a Vietnamese one). Leave empty only for well-known places." }, "language": { "title": "Language", "type": "string", "description": "Interface language code for texts such as amenities and star class, e.g. en, de, fr, vi. Example: en.", "default": "en" }, "maxRetries": { "title": "Retries per page", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times (0-10) a blocked or failed page is retried on a new proxy session.", "default": 3 }, "browserFallback": { "title": "Open JavaScript-loaded results in a browser", "type": "boolean", "description": "For some places Google sends a loading page and fetches the hotels with JavaScript. Open only those in a real browser (slower, uses more proxy traffic, returns that page's hotels only). Leave on unless you want such searches to fail.", "default": true }, "saveFailedPages": { "title": "Save pages that fail", "type": "boolean", "description": "Store the raw HTML of pages that could not be read in the run's key-value store, for troubleshooting. Leave off unless support asks for it.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy. Leave the country empty to let the scraper choose per search: an IP in the location's country, except the EEA, UK and Switzerland, where a US IP is used because those IPs get a cookie-consent page.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }