{ "openapi": "3.0.1", "info": { "title": "Google Hotels Rate Comparison Scraper", "description": "Compare what every booking site charges for the same hotel room-night: 17-25 OTA quotes per hotel with provider, price, taxes, cancellation terms and deep links, plus Google's own price, rating, star class and deal flag. No login.", "version": "0.0", "x-build-id": "pEmYikQo2HA3VJCeB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~google-hotels-rate-comparison-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-google-hotels-rate-comparison-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/fanndev~google-hotels-rate-comparison-scraper/runs": { "post": { "operationId": "runs-sync-fanndev-google-hotels-rate-comparison-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/fanndev~google-hotels-rate-comparison-scraper/run-sync": { "post": { "operationId": "run-sync-fanndev-google-hotels-rate-comparison-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "hotel", "rates", "sponsored", "reference" ], "type": "string", "description": "search = find hotels for a query and get their cards (price, rating, star class, deal flag). hotel = full detail for specific hotels, with every OTA quote nested under 'rates'. rates = the same quotes flattened to one record each, which is the shape you want for rate-parity analysis. sponsored = the paid placements shown on a hotel's page, which are quotes for OTHER hotels. reference = check the source and report what it returns, including the winning TLS profile and the currency your proxy produces.", "default": "search" }, "searchQuery": { "title": "Search query (search mode)", "type": "string", "description": "A destination or hotel name, e.g. 'hotels in Singapore' or 'hotels near Ubud Bali'. Google returns about 21 hotels per query and offers no deeper pages, so use several narrower queries to cover a city rather than expecting pagination." }, "searchQueries": { "title": "Search queries (search mode)", "type": "array", "description": "Several queries in one run. One request each.", "items": { "type": "string" } }, "fetchRates": { "title": "Also fetch OTA rates (search mode)", "type": "boolean", "description": "Search cards already carry Google's own price, rating, star class and deal flag. Turn this on to also pull each hotel's full cross-OTA rate table - one extra request per hotel, so roughly 21x the requests of a bare search.", "default": false }, "hotelId": { "title": "Hotel entity ID or URL (hotel/rates/sponsored modes)", "type": "string", "description": "A Google Hotels entity ID, or the https://www.google.com/travel/hotels/entity/ URL it came from. Run mode 'search' first to collect IDs." }, "hotelIds": { "title": "Hotel entity IDs or URLs (hotel/rates/sponsored modes)", "type": "array", "description": "Several hotels in one run. One request each.", "items": { "type": "string" } }, "languageCode": { "title": "Language", "type": "string", "description": "Google's 'hl' parameter. Controls the language of labels such as 'Free cancellation' and '5-star hotel'. It does NOT control the currency.", "default": "en" }, "countryCode": { "title": "Country", "type": "string", "description": "Google's 'gl' parameter. Influences which OTAs Google lists. It does NOT control the currency - see the proxy note.", "default": "us" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum records per run. A search query yields about 21 hotels; a single hotel yields up to about 25 OTA quotes in mode 'rates'.", "default": 200 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many hotel pages to fetch in parallel. Google tolerates far less parallelism than a typical site; 3 is a deliberate default.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is on by default and is effectively required: Google gates on the exit IP as well as the TLS fingerprint, and datacenter addresses get challenges instead of pages. The proxy country also decides the CURRENCY of every price, because Google ignores 'curr', 'currency' and 'gl' on this surface - so pick a proxy country matching the currency you want to report in.", "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 } } } } } } } } } }