{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper", "description": "Google Hotels Scraper — Extract hotel data from Google Hotels, including names, prices, ratings, reviews, locations, amenities, availability, booking options, and hotel URLs. Useful for hotel research, price comparison, travel analysis, and market research.", "version": "0.9", "x-build-id": "VXmN3FEi6ioSoCtyS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fastdataapi~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fastdataapi-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/fastdataapi~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-fastdataapi-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/fastdataapi~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-fastdataapi-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": [ "searchQuery" ], "properties": { "searchQuery": { "title": "🔎 Search terms", "type": "array", "description": "One or more cities, areas or hotel search phrases, typed as you would in Google Hotels, e.g. 'Prague hotels', 'Paris center', 'Manhattan NYC'. Each entry is searched separately; repeated entries are searched once. Every hotel row keeps the entry that found it in the searchQuery field.", "items": { "type": "string" } }, "maxResults": { "title": "🔢 Max hotels per search", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of hotels saved for each search entry (1–5000). The run never saves more than this per entry; it can save fewer when Google Hotels lists fewer hotels. Free plan: up to 20 hotels per run (all search entries together) and 200 per month; paid plans have no limit.", "default": 10 }, "checkInDate": { "title": "📅 Check-in date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Arrival date in YYYY-MM-DD format. It must be today or later; a past date stops the run with a clear message. Prices depend on the dates you choose.", "default": "2027-06-01" }, "checkOutDate": { "title": "📅 Check-out date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Departure date in YYYY-MM-DD format. It must be after the check-in date and at most 30 nights later. Prices are for the whole stay.", "default": "2027-06-05" }, "numberOfAdults": { "title": "🔢 Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests (1–16). Affects which offers and prices are shown.", "default": 2 }, "numberOfChildren": { "title": "🔢 Children", "minimum": 0, "maximum": 16, "type": "integer", "description": "Number of children (0–16). Google Hotels needs an age for each child to show prices; this input only takes a count, so every child is searched as 8 years old.", "default": 0 }, "currencyCode": { "title": "🔧 Currency", "minLength": 3, "maxLength": 3, "type": "string", "description": "Three-letter currency code for all prices, e.g. EUR, USD, GBP, BRL, TRY. If Google Hotels answers a search in a different currency, that search entry is skipped with a warning in the log and the run continues with the next entry.", "default": "EUR" }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Off by default: requests go out directly and blocked requests are retried with fresh connections; the run does not switch to a proxy on its own. Turn on Apify Proxy to send every request through it (residential proxies when no group is chosen), or add your own proxy URLs." } } }, "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 } } } } } } } } } }