{ "openapi": "3.0.1", "info": { "title": "Google Hotels Prices — Every Booking Site, Any Dates", "description": "Unofficial Google Hotels scraper & Google Travel hotel prices API: type a city or paste hotel links and get every booking site's price for any check-in dates. Per night and total stay, with and without taxes, plus the official site's rate. Pay only for results with prices. Hotel price comparison.", "version": "0.1", "x-build-id": "Xab9CbgHaxqpRqatL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~google-hotels-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-google-hotels-prices", "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/highbrow_fame~google-hotels-prices/runs": { "post": { "operationId": "runs-sync-highbrow_fame-google-hotels-prices", "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/highbrow_fame~google-hotels-prices/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-google-hotels-prices", "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": { "places": { "title": "Places (city search)", "maxItems": 100, "type": "array", "description": "One place per line — a city, a district or a landmark, e.g. \"Paris\", \"Barcelona city center\", \"hotels near Times Square\". The Actor searches Google for \"hotels in \" (or your text as it is, when it already says hotels) and prices the hotels Google lists, up to \"Max hotels per place\". Each record then has \"place\" and \"placeRank\" (Google's order). Leave empty to price only the hotels listed under \"Hotels\"; remove the example hotel there if you only want the place's hotels.", "items": { "type": "string" } }, "maxHotelsPerPlace": { "title": "Max hotels per place", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many of the hotels Google lists for each place are priced (in Google's order). Each hotel and check-in date is one result.", "default": 20 }, "hotels": { "title": "Hotels", "maxItems": 1000, "type": "array", "description": "One hotel per line: its Google Hotels link (open the hotel on Google Hotels and copy the link — it contains /entity/), its Google Maps link (contains !1s0x…), its Google Hotels ID (starts with Ch) or its Google Maps CID. Optional when you search a place above.", "items": { "type": "string" } }, "checkInDate": { "title": "First check-in date", "type": "string", "description": "YYYY-MM-DD. Empty: 14 days from today." }, "numberOfDates": { "title": "Number of check-in dates", "minimum": 1, "maximum": 180, "type": "integer", "description": "Consecutive check-in dates from the first one: 1 = only that date, 30 = a month of daily prices. Each hotel and date is one result.", "default": 1 }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of each stay. Every result has the price per night and the price of the whole stay.", "default": 1 }, "checkInDates": { "title": "Specific check-in dates (optional)", "type": "array", "description": "YYYY-MM-DD, one per line — for example every Friday of a season. When you fill this in, it is used instead of the first check-in date and the number of dates.", "items": { "type": "string" } }, "adults": { "title": "Adults", "minimum": 1, "maximum": 10, "type": "integer", "description": "Guests in the room.", "default": 2 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "NZD", "JPY", "CHF", "SEK", "NOK", "DKK", "PLN", "CZK", "HUF", "RON", "TRY", "INR", "SGD", "HKD", "THB", "KRW", "CNY", "TWD", "IDR", "MYR", "PHP", "AED", "SAR", "ILS", "ZAR", "MXN", "BRL", "ARS", "CLP", "COP" ], "type": "string", "description": "Google converts every booking site's price into this currency.", "default": "USD" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "US residential by default: Google Hotels then shows the US market's booking sites and prices. A refused request is tried once more on the same connection, never from a new IP.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }