{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper", "description": "Hotel lists for any destination and per-site prices for the hotels you pick, from Google Hotels. Check many dates at once and see how each price moved since the last run.", "version": "0.1", "x-build-id": "I31ZTLhfAsZ0cUGRU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lyklo~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lyklo-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/lyklo~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-lyklo-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/lyklo~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-lyklo-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": { "searchQueries": { "title": "Destinations", "type": "array", "description": "One destination per line, such as Kyoto, Paris 11th arrondissement or hotels near Times Square. Leave the dates out: they come from the date settings below. Each destination gives a list of hotels with Google's lowest price.", "items": { "type": "string" } }, "hotels": { "title": "Hotels", "type": "array", "description": "Specific hotels to price, one per line: a Google Hotels link, a hotel ID from an earlier run (hotelId, starts with Ch), or the hotel's name. A name is looked up and must match a hotel's name on Google. If none matches, the run log lists the closest hotels and their IDs. These hotels always come with prices from each booking site.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "First check-in date. Leave empty to use the day 14 days after each run, which keeps scheduled runs on future dates." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of each stay.", "default": 1 }, "checkInDays": { "title": "Check-in dates to check", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many check-in dates to check, one day apart, starting from the check-in date. 30 gives a month of prices for every hotel. Each date is a separate result.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Guests per room. Applies to the prices from each booking site. Destination lists without booking-site prices use Google's default of 2 guests.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter code such as USD, EUR or JPY, for the prices from each booking site. Destination lists without booking-site prices come in US dollars. Every result says its currency.", "default": "USD" }, "maxHotelsPerSearch": { "title": "Hotels per destination", "minimum": 1, "maximum": 500, "type": "integer", "description": "Most hotels to return for each destination and check-in date. Google shows about 20 per page.", "default": 20 }, "includePrices": { "title": "Add prices from each booking site to destination lists", "type": "boolean", "description": "Also get every booking site's price (Booking.com, Expedia, the hotel's own site and others), the address and the phone number for each hotel in the destination lists. Charged as an add-on per result. Hotels you list under Hotels always have them.", "default": false }, "trackChanges": { "title": "Compare with the last run", "type": "boolean", "description": "Add how each price changed since the last run with the same watch name: down, up, same, sold out, available again, or new. Free. Use it with a schedule.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Keeps the previous prices apart for different hotel sets. Give each saved task its own name. The previous prices are kept in a named key-value store in your account (google-hotels-scraper-).", "default": "default" } } }, "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 } } } } } } } } } }