{ "openapi": "3.0.1", "info": { "title": "Google Hotels Price Tracker", "description": "Track hotel prices on Google Hotels for every check-in date up to a year ahead. Lowest price per night, taxes and booking-site prices. JSON, CSV, API.", "version": "0.0", "x-build-id": "7YPozKkHsWoYt1n1A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stayscope~google-hotels-price-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stayscope-google-hotels-price-tracker", "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/stayscope~google-hotels-price-tracker/runs": { "post": { "operationId": "runs-sync-stayscope-google-hotels-price-tracker", "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/stayscope~google-hotels-price-tracker/run-sync": { "post": { "operationId": "run-sync-stayscope-google-hotels-price-tracker", "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": [ "hotels" ], "properties": { "hotels": { "title": "Hotels", "minItems": 1, "maxItems": 100, "type": "array", "description": "One hotel per line: its Google Hotels link (open the hotel on google.com/travel/hotels and copy the address bar), or its name with the city, for example \"Marina Bay Sands Singapore\". Links are the most precise.", "default": [ "Marina Bay Sands Singapore" ], "items": { "type": "string" } }, "startDate": { "title": "First check-in date", "pattern": "^\\s*(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?\\s*$|^\\s*(\\d+)\\s*(day|week|month|year)s?\\s*$", "type": "string", "description": "A fixed date (YYYY-MM-DD) or a date relative to the day of the run, such as \"1 day\" (tomorrow). Relative dates keep scheduled runs pointed at the future.", "default": "1 day" }, "days": { "title": "Number of check-in dates", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many consecutive check-in dates to track, starting from the first check-in date. Up to 365 (a full year).", "default": 30 }, "nights": { "title": "Nights per stay", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of the stay priced for each check-in date.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "currency": { "title": "Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "3-letter currency code for all prices, for example USD, EUR, GBP, SGD or MYR.", "default": "USD" }, "includeProviderPrices": { "title": "Add prices from every booking site", "type": "boolean", "description": "Also opens the hotel's Google Hotels page for each priced date to add the price from every booking site (Booking.com, Expedia, Agoda, the hotel's own site and more). Much slower and billed at a higher price per date. Leave off to get the lowest price per date only.", "default": false }, "maxConcurrency": { "title": "Parallel hotel pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many hotel pages to open at once when booking-site prices are on.", "default": 5 }, "language": { "title": "Language", "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z]{2,4})?$", "type": "string", "description": "Google interface language code, for example en, de, fr or ja.", "default": "en" }, "country": { "title": "Country", "pattern": "^[a-zA-Z]{2}$", "type": "string", "description": "2-letter country code Google uses for the search, for example us, gb or sg.", "default": "us" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google blocks data-center IPs quickly, so residential proxies are recommended.", "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 } } } } } } } } } }