{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper: Hotel Rates & Price Comparison, No Login", "description": "Get Google Hotels prices for any city, dates and guests, and compare every booking site's rate (Booking.com, Expedia, Agoda, the hotel's own site). Ratings, amenities, address and phone included. Track price changes on a schedule. No login, no API key.", "version": "0.1", "x-build-id": "beAOjbW3aKczRo6na" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/headply~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-headply-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/headply~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-headply-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/headply~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-headply-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": "Places or searches", "type": "array", "description": "Where to look, one per line: a city or area (\"Austin, TX\", \"Shibuya, Tokyo\") or a full Google Hotels search (\"pet friendly hotels near Times Square\"). Place names are searched as \"hotels in \". Leave empty when you only use hotel URLs.", "default": [], "items": { "type": "string" } }, "hotelUrls": { "title": "Hotel URLs (optional)", "type": "array", "description": "Google Hotels hotel pages (https://www.google.com/travel/hotels/entity/...) to fetch directly, e.g. a fixed list of competitor hotels to track. Each returns full details and every booking site's price.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD, or a number of days from the run date (\"14\" = two weeks ahead, so scheduled runs keep looking the same distance ahead). Leave empty for Google's default dates.", "default": "" }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD or days from the run date. Leave empty to use check-in plus \"Nights\".", "default": "" }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay when no check-out date is given (1–30).", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests; prices are for this party size.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for all prices (USD, EUR, GBP, INR, JPY…).", "default": "USD" }, "maxHotelsPerQuery": { "title": "Max hotels per place", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many hotels for each place or search. Google shows about 20 per page; large cities have 1,000+.", "default": 20 }, "includeOffers": { "title": "Include every booking site's price", "type": "boolean", "description": "Also load each hotel's page for the price on every booking site (Booking.com, Expedia, Hotels.com, Agoda, the hotel's own site…) with booking links, plus address, phone, Google Places id and the full amenity list. Slower and billed as an extra event per hotel.", "default": false }, "mode": { "title": "Mode", "enum": [ "all", "newOrChanged" ], "type": "string", "description": "\"All hotels\" returns everything found. \"Only new or changed price\" remembers the last price of every hotel per search and returns (and bills) only hotels that are new or whose price moved since the previous run with the same monitor name. Use it with a schedule for price alerts.", "default": "all" }, "includeNewHotels": { "title": "Also report hotels new to the search", "type": "boolean", "description": "Only used in \"new or changed\" mode. The first run always returns every hotel as the baseline. After that, by default only price changes are returned, because Google reshuffles its ranking between visits and many \"new\" hotels are just reordering. Turn this on to also get hotels that were never seen before in this search.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Only used in \"new or changed\" mode. Separate schedules with different names keep separate memories.", "default": "default" }, "maxImages": { "title": "Photos per hotel", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many photo URLs to include per hotel (0–50).", "default": 10 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages to load at once. The default is fast and safe.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy with US exits works well. The exit country sets the market Google prices for.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } }, "selfTest": { "title": "Self-test (maintainers)", "type": "boolean", "description": "Fail the run if the output looks broken. Used by the daily health check.", "default": 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 } } } } } } } } } }