{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper - Hotel Prices Across Every Booking Site", "description": "Search Google Hotels by destination and dates: hotel listings plus the price every booking site quoted for the same stay.", "version": "0.0", "x-build-id": "BWwTKrJT7XB4oDjZ9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~google-hotels/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-google-hotels", "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/lanternlab318~google-hotels/runs": { "post": { "operationId": "runs-sync-lanternlab318-google-hotels", "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/lanternlab318~google-hotels/run-sync": { "post": { "operationId": "run-sync-lanternlab318-google-hotels", "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": [ "queries" ], "properties": { "queries": { "title": "Destinations or hotel names", "type": "array", "description": "One destination per line: a city (\"Paris\"), a district (\"Shibuya, Tokyo\"), a region, or the name of one hotel. Every entry is searched separately and its rows are labelled with it. A hotel that matches several entries is returned once and charged once. Google serves one page of about 20 hotels per destination, so use several narrower entries when you need more of a big city.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in day as YYYY-MM-DD, for example 2026-11-10. Leave empty for tomorrow. Google Hotels only prices future stays, at most 330 days ahead." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out day as YYYY-MM-DD. Leave empty for the day after check-in. Must be after check-in, at most 30 nights later - that is Google's own limit." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 6, "type": "integer", "description": "Number of adults the rooms are priced for, 1 to 6. The prices Google shows depend on it.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter code the prices are returned in, for example USD, EUR, GBP, RUB, JPY. Google converts the booking sites' own quotes into it. Left alone, prices come back in USD regardless of where the run exits to the internet.", "default": "USD" }, "gl": { "title": "Country (gl)", "type": "string", "description": "Two-letter country code of the Google Travel edition to search, for example \"us\", \"de\", \"ru\". It changes which booking sites Google lists and sometimes the ranking.", "default": "us" }, "hl": { "title": "Language (hl)", "type": "string", "description": "Interface language as a BCP-47 tag: \"en\", \"ru\", \"de\", \"ja\", \"pt-BR\". It is the language of the text fields - amenity names, the hotel class sentence and the description.", "default": "en" }, "maxItems": { "title": "Max hotels", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on the hotel rows the whole run may produce. Google returns about 20 hotels per destination and offers no way to page past that without a browser session, so the row count is often Google's ceiling rather than this setting - the run says which, per destination.", "default": 100 }, "includeProviderPrices": { "title": "Include every booking site's price", "type": "boolean", "description": "With this on, every hotel also gets prices[]: each booking site Google listed for your dates, its nightly price, its stay total and Google's own outbound link, plus the hotel's street address. That needs one extra request per hotel and moves about 25 times more data than the hotel list alone, which is the main thing driving the cost of a run. Turn it off for a fast, cheap run that keeps the cheapest price Google showed and leaves prices[] empty and address null.", "default": true }, "maxUpstreamRequests": { "title": "Max Google requests", "minimum": 1, "type": "integer", "description": "Hard ceiling on the HTTP requests this run sends to Google: search pages, hotel pages and retries together. At the ceiling collection stops - the destinations not reached are written with partialReason \"upstream_request_cap\" and the run then ends normally. Leave empty and the Actor works a ceiling out from your destinations and limits, so a run is never unbounded." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the requests to Google go through. The default (Apify Proxy, datacenter) is the cheapest and is what this Actor is measured on; Google Travel serves its public hotel pages over it without a bot check.", "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 } } } } } } } } } }