{ "openapi": "3.0.1", "info": { "title": "Google Hotels API: Hotel Prices, Ratings & Every Booking Site", "description": "Hotel prices from Google Hotels for any dates and guests: nightly and total price with taxes, rating, reviews, class, amenities, location, plus every booking site's price (Booking.com, Expedia, hotel's own site). By city, area or hotel. $2 per 1,000 hotels.", "version": "0.1", "x-build-id": "U1GszfFIQYlrZY8LQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sauliusautomatesit~google-hotels-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sauliusautomatesit-google-hotels-api", "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/sauliusautomatesit~google-hotels-api/runs": { "post": { "operationId": "runs-sync-sauliusautomatesit-google-hotels-api", "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/sauliusautomatesit~google-hotels-api/run-sync": { "post": { "operationId": "run-sync-sauliusautomatesit-google-hotels-api", "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": [ "queries" ], "properties": { "queries": { "title": "Searches or Google Hotels URLs", "type": "array", "description": "One per line. A place (`hotels in Lisbon`, `Shibuya Tokyo`, `hotels near Times Square`) returns the hotels Google lists there. A hotel name (`Hilton Paris Opera`) puts that hotel first, so with `Max hotels per search` = 1 you track one exact hotel. A Google Hotels URL works too: a hotel page (`google.com/travel/hotels/entity/...`) or a search page.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Leave empty for 14 days from today." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay. Ignored when a check-out date is set.", "default": 1 }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "Optional, YYYY-MM-DD. Sets the number of nights from the check-in date." }, "checkInDays": { "title": "Check-in dates to cover (rate calendar)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Repeat every search for this many consecutive check-in dates, starting at the check-in date. `30` gives a 30-day rate calendar for each hotel. Each date is charged as its own hotel rows.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 8, "type": "integer", "description": "Guests per room. Prices change with the number of guests.", "default": 2 }, "maxHotelsPerQuery": { "title": "Max hotels per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many hotels for each search and date, in Google's order. Google shows about 20 per page and stops after roughly 700 for a big city; split a large city into areas to get more.", "default": 20 }, "includeBookingSites": { "title": "Add the price on every booking site", "type": "boolean", "description": "Open each hotel's Google page and add every booking site's nightly and total price (Booking.com, Expedia, Hotels.com, Agoda, Trip.com, the hotel's own site and more), the cheapest site, plus the full address and phone. Charged as a separate `booking-sites` event per hotel.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Google interface language, for example `en-US`, `de`, `fr`. Affects hotel descriptions and names where Google translates them. Prices are always in US dollars.", "default": "en-US" }, "country": { "title": "Country of the searcher", "type": "string", "description": "Two-letter country code Google uses for the searcher, for example `us`, `gb`, `de`.", "default": "us" }, "concurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at the same time.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used by default. You do not need to change this.", "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 } } } } } } } } } }