{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper", "description": "Hotel price API for Google Hotels: nightly and total prices for your dates, ratings, reviews, stars, amenities, coordinates and deals for any city. Fast, cheap, no browser, built not to fail.", "version": "1.0", "x-build-id": "j67AZgtImdWmaMfz8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-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/rel8ble~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-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/rel8ble~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-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", "properties": { "queries": { "title": "Search queries", "type": "array", "description": "What you would type into Google Hotels, one search per line. Each search returns up to \"Max results per query\" hotels. Examples: \"hotels in Paris\", \"hotels near Times Square\", \"boutique hotels in Lisbon\", or a hotel name like \"Hilton Charlotte University Place\".", "default": [ "hotels in Charlotte" ], "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Arrival date in YYYY-MM-DD format, e.g. 2026-10-15. Must not be in the past. Leave empty to let Google pick its default dates (usually a one-night stay in the next few days)." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Departure date in YYYY-MM-DD format, e.g. 2026-10-18. Must be after check-in; maximum stay is 30 nights. Leave empty for a one-night stay after check-in." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests, 1-12. Prices change with occupancy, so set this to match the stay you want to price.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "3-letter ISO currency code for all prices, e.g. USD, EUR, GBP, JPY.", "default": "USD" }, "maxResults": { "title": "Max results per query", "minimum": 0, "type": "integer", "description": "Stop each search after this many unique hotels. Google usually has 150-250 unique hotels per search. 0 = as many as Google will page through.", "default": 50 }, "includeVacationRentals": { "title": "Include vacation rentals", "type": "boolean", "description": "Google mixes apartments and houses from rental partners into hotel results. On = include them (propertyType \"vacation_rental\"); off = hotels only.", "default": false }, "includeDetails": { "title": "Include address and phone (slower)", "type": "boolean", "description": "Opens each hotel's Google Hotels page to add the full street address and phone number. Adds one extra request per hotel, so runs are slower and use more proxy traffic.", "default": false }, "language": { "title": "Language (hl)", "type": "string", "description": "Google interface language (hl), e.g. en, fr, de. Amenity and deal labels come in this language; keep \"en\" for the most complete labels.", "default": "en" }, "country": { "title": "Country (gl)", "type": "string", "description": "2-letter country code (gl) Google should search from, e.g. us, gb, fr. Affects which booking partners and prices are shown.", "default": "us" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages to fetch in parallel, 1-20. Different searches run in parallel; pages within one search run in order.", "default": 5 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many times to retry a failed page, 0-20. Blocked requests are retried on a fresh proxy session (new IP).", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is recommended and on by default. If the log shows repeated \"Blocked by Google\" retries, switch to the RESIDENTIAL proxy group.", "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 } } } } } } } } } }