{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper – Prices, Ratings & Booking Sites", "description": "Scrape Google Hotels for any city worldwide: nightly and total prices for your dates, any currency, star class, ratings and review aspects, GPS, photos, and prices from every booking site (Booking.com, Agoda, Expedia, official site).", "version": "0.1", "x-build-id": "6ehRR4Sh1MqM1byi4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/smoldesk~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-smoldesk-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/smoldesk~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-smoldesk-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/smoldesk~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-smoldesk-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": { "locations": { "title": "Locations", "type": "array", "description": "Cities, neighbourhoods, landmarks or full queries anywhere in the world, e.g. Paris, Shibuya Tokyo, near Times Square, beach resorts in Bali. One search per line.", "items": { "type": "string" } }, "hotelUrls": { "title": "Hotel links (optional)", "type": "array", "description": "Google Hotels links (https://www.google.com/travel/hotels/entity/Ch…) or entity IDs from earlier results. Returns the booking-site prices Google lists for that hotel and your dates.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Empty = 14 days from today." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD. Empty = 2 nights after check-in." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "childrenAges": { "title": "Children's ages", "type": "array", "description": "One age per child (0–17), e.g. 5 and 9. Leave empty for no children.", "items": { "type": "string" } }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for all prices: USD, EUR, GBP, JPY, AUD, SGD, MYR, INR, …", "default": "USD" }, "maxResultsPerLocation": { "title": "Max hotels per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many hotels for each location (Google lists up to ~1,000+ per big city).", "default": 20 }, "includePrices": { "title": "Booking-site prices", "type": "boolean", "description": "For each hotel, also get the prices that Google lists from booking sites (typically 3–6 of Expedia, Hotels.com, Booking.com, Priceline, Agoda, Trip.com or the official site) with notes like free cancellation, plus the cheapest listed site. Which sites Google shows varies. One extra page per hotel, charged as 'hotel prices' only when prices are found.", "default": false }, "minRating": { "title": "Minimum guest rating", "enum": [ "0", "3.5", "4", "4.5" ], "type": "string", "description": "Only hotels with at least this Google rating.", "default": "0" }, "minHotelClass": { "title": "Minimum hotel class", "enum": [ "0", "2", "3", "4", "5" ], "type": "string", "description": "Only hotels with at least this star class.", "default": "0" }, "maxPricePerNight": { "title": "Max price per night", "minimum": 0, "type": "integer", "description": "Only hotels at or under this nightly price (in your currency). Hotels without a price for your dates are skipped when this is set." }, "onlyWithPrice": { "title": "Only hotels with a price", "type": "boolean", "description": "Skip hotels that show no price for your dates (sold out or not bookable on Google).", "default": false }, "maxPhotos": { "title": "Photos per hotel", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many photo URLs to include per hotel.", "default": 5 }, "language": { "title": "Language", "type": "string", "description": "Google interface language (hl), e.g. en, de, fr, ja, es. Hotel names and descriptions follow it.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Google country (gl), e.g. us, gb, de, jp. Affects which booking sites are shown.", "default": "us" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed — the Actor switches to Apify datacenter proxies on its own if Google rate-limits the run. Residential proxies are ignored.", "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 } } } } } } } } } }