{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper · $2.50/1K · Prices, Taxes & Reviews", "description": "Scrape Google Hotels for any city and dates: price per night and per stay with taxes & fees, ratings, reviews, hotel class, amenities, photos and GPS. Optional prices from each booking site (Booking.com, Expedia, official site). Fast HTTP-only, no browser, pay only per hotel returned.", "version": "0.1", "x-build-id": "mKVTpDvJMqTjK0ADD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/featherscrape~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-featherscrape-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/featherscrape~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-featherscrape-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/featherscrape~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-featherscrape-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": [ "locations" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "Cities, neighborhoods or landmarks to search hotels in, exactly as you would type them on Google Hotels (e.g. \"Paris\", \"Shibuya, Tokyo\", \"near Times Square\").", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "Arrival date (YYYY-MM-DD). Leave both dates empty to let Google pick default dates (usually tonight, 1 night)." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "Departure date (YYYY-MM-DD). Must be after the check-in date." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests. Prices depend on it.", "default": 2 }, "maxResultsPerLocation": { "title": "Max hotels per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of hotels to return for each location. Google shows about 20 hotels per page.", "default": 50 }, "maxResultsTotal": { "title": "Max hotels in total", "minimum": 1, "type": "integer", "description": "Optional cap on the total number of hotels across all locations, to control your spending." }, "includeBookingSites": { "title": "Include prices of each booking site (OTA rates)", "type": "boolean", "description": "Also fetch, for every hotel, the price on each booking site Google lists (Booking.com, Expedia, Agoda, official website…), with booking links. Adds one request per hotel and an extra charge per hotel (see pricing).", "default": false }, "maxBookingSitesPerHotel": { "title": "Max booking sites per hotel", "minimum": 1, "type": "integer", "description": "With booking-site prices enabled, keep only the N cheapest sites for each hotel.", "default": 100 }, "currency": { "title": "Currency", "type": "string", "description": "ISO 4217 currency code for prices (USD, EUR, GBP, JPY…).", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Language of descriptions and labels returned by Google (en, fr, de, es…).", "default": "en" }, "countryCode": { "title": "Country", "type": "string", "description": "Two-letter country code of the Google version to use (us, gb, fr…). It can affect which booking prices are shown.", "default": "us" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach Google. The default Apify Proxy works in most cases.", "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 } } } } } } } } } }