{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper", "description": "Scrape Google Hotels data: prices, ratings, star class, amenities, coordinates, photos and booking links for any city or hotel. Compare rates by dates, guests and currency. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "AWFT1yG7zlh37M2m0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insights_data~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insights_data-google-hotels-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/insights_data~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-insights_data-google-hotels-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/insights_data~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-insights_data-google-hotels-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": [ "urls" ], "properties": { "urls": { "title": "🔗 Google Hotels URLs or places", "minItems": 1, "type": "array", "description": "One search per line. Paste a Google Hotels search link (a city or area search copied from the address bar, for example https://www.google.com/travel/hotels/Paris) or just type a place name such as Paris or New York. Links that already contain stay dates, guests or a currency use those values for that search. Links to a single hotel are not supported.", "items": { "type": "string" } }, "checkInDate": { "title": "📅 Check-in date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "First night of the stay in YYYY-MM-DD format. Leave empty to use 30 days from today." }, "checkOutDate": { "title": "📅 Check-out date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Day you leave, in YYYY-MM-DD format. It must be after the check-in date. Leave empty to stay 2 nights." }, "maxResults": { "title": "🔢 Max hotels per search", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of hotels to return for each link or place. 0 means everything Google lists for that place. Free plan: up to 10 hotels per run in total. Paid plans have no limit.", "default": 10 }, "maxPagesPerLocation": { "title": "🔢 Max result pages per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard stop on how many result pages are read for one search, even if more hotels are available.", "default": 10 }, "adults": { "title": "🎯 Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult guests the prices are quoted for (1 to 9).", "default": 2 }, "pastDatePolicy": { "title": "🔧 Past dates handling", "enum": [ "shift", "error", "googleDefault" ], "type": "string", "description": "What to do when the check-in date is today or earlier. Shift moves the stay forward by whole years until it is in the future, Stop with an error refuses to run, and Let Google choose uses the dates Google picks itself (every row reports the dates Google actually priced).", "default": "shift" }, "currency": { "title": "🎯 Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "Three-letter currency code prices are shown in, for example USD, EUR or GBP. Unsupported codes fall back to USD.", "default": "USD" }, "languageCode": { "title": "🌍 Language code", "pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$", "type": "string", "description": "Language of hotel descriptions and labels, for example en, fr, de or es.", "default": "en" }, "countryCode": { "title": "📍 Country code", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter country Google Hotels is searched from, for example us, gb or de. Prices and availability can differ by country.", "default": "us" }, "requestTimeoutSecs": { "title": "⏳ Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each request before it counts as failed.", "default": 30 }, "maxRetries": { "title": "🔁 Max retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times a failed or blocked request is retried. After the Actor has moved to residential proxy it always retries at least 3 times.", "default": 3 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "By default requests are sent without a proxy. If Google blocks a request, the Actor switches to Apify datacenter proxy, then to residential proxy, and stays on the stronger proxy for the rest of the run. Choose a proxy here only if you want to start on it.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }