{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper: Prices, Ratings and Amenities", "description": "Scrape Google Hotels for any city and dates. Get hotel name, nightly price, star class, rating, review count, amenities and the Google Hotels link, up to 200 hotels per destination. No login, no browser, no API key. Pay only for hotels delivered, about $4 per 1,000.", "version": "0.1", "x-build-id": "qUZDs8Funl8QFqvcV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oski~google-hotels-prices-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oski-google-hotels-prices-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/oski~google-hotels-prices-scraper/runs": { "post": { "operationId": "runs-sync-oski-google-hotels-prices-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/oski~google-hotels-prices-scraper/run-sync": { "post": { "operationId": "run-sync-oski-google-hotels-prices-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": { "destinations": { "title": "Destinations", "type": "array", "description": "Cities, areas or landmarks, one per line, the way you would type them into Google Hotels. A pasted Google Hotels search link also works and is fetched exactly as pasted.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in", "type": "string", "description": "First night. Leave both dates empty for the coming weekend (Friday to Sunday). Typed dates such as 10/11/2026 work too." }, "checkOut": { "title": "Check-out", "type": "string", "description": "Last morning. Leave empty to use Check-in plus Nights." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Used only when one of the two dates is empty.", "default": 1 }, "maxHotelsPerDestination": { "title": "Hotels per destination", "minimum": 1, "maximum": 200, "type": "integer", "description": "Google shows 18 hotels per search page, so the scraper runs several differently worded searches (star classes, budget, luxury, areas) until it has this many unique hotels or runs out of new results. 40 hotels cost about $0.16; 200 about $0.80.", "default": 40 }, "country": { "title": "Search as from country", "enum": [ "GB", "US", "IE", "CA", "AU", "NZ", "DE", "FR", "ES", "IT", "NL", "PT", "PL", "CH", "AT", "SE", "DK", "NO", "AE", "SG", "IN", "JP", "BR", "MX", "ZA" ], "type": "string", "description": "The Google country edition to ask (the gl parameter). It shapes which hotels Google ranks first. Prices arrive in the currency Google picks for the request, reported in the currency field.", "default": "GB" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is enough (tested clean). Choose the RESIDENTIAL group only if Google starts refusing; it adds about $0.003 per search page.", "default": { "useApifyProxy": true } }, "concurrency": { "title": "Destinations fetched at once", "minimum": 1, "maximum": 6, "type": "integer", "description": "How many destinations run in parallel.", "default": 3 }, "stallAfter": { "title": "Stop after this many searches without new hotels", "minimum": 1, "maximum": 10, "type": "integer", "description": "Extra searches that add fewer than 2 new hotels count as stalled; the destination stops after this many in a row.", "default": 3 } } }, "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 } } } } } } } } } }