{ "openapi": "3.0.1", "info": { "title": "Google Hotels Price Calendar – Nightly Rates by Date", "description": "Hotel price calendar from Google Hotels: the cheapest nightly rate for every check-in date up to a year ahead, for any hotel by name or link, any currency and stay length. Optional prices per booking site (Booking.com, Expedia, official site…) for each date.", "version": "0.1", "x-build-id": "GqcCUniGgRK5pbfIF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/smoldesk~google-hotel-price-calendar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-smoldesk-google-hotel-price-calendar", "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/smoldesk~google-hotel-price-calendar/runs": { "post": { "operationId": "runs-sync-smoldesk-google-hotel-price-calendar", "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/smoldesk~google-hotel-price-calendar/run-sync": { "post": { "operationId": "run-sync-smoldesk-google-hotel-price-calendar", "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": { "hotels": { "title": "Hotels", "type": "array", "description": "One hotel per line: its name (add the city if the name is common, e.g. Hilton Paris Opera), a Google Hotels link (https://www.google.com/travel/hotels/entity/Ch…) or a bare entity ID from earlier results.", "default": [ "Hilton Paris Opera" ], "items": { "type": "string" } }, "startDate": { "title": "First check-in date", "type": "string", "description": "YYYY-MM-DD. Empty = tomorrow." }, "days": { "title": "Number of check-in dates", "minimum": 1, "maximum": 366, "type": "integer", "description": "How many consecutive check-in dates to price, starting at the first check-in date (up to 366, about a year ahead). One result per hotel per date.", "default": 30 }, "endDate": { "title": "Last check-in date (optional)", "type": "string", "description": "YYYY-MM-DD. Overrides 'Number of check-in dates' when set." }, "nights": { "title": "Nights per stay", "minimum": 1, "maximum": 28, "type": "integer", "description": "Length of stay for each check-in date (1–28). Prices are per night; the total covers the whole stay.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "childrenAges": { "title": "Children's ages", "type": "array", "description": "One age per child (0–17), e.g. 5 and 9. Leave empty for no children.", "items": { "type": "string" } }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for all prices: USD, EUR, GBP, JPY, AUD, SGD, MYR, INR, …", "default": "USD" }, "onlyAvailableDates": { "title": "Only dates with a price", "type": "boolean", "description": "Skip check-in dates where Google shows no rate (sold out, closed or not bookable). Skipped dates are not charged. Turn off to get a row for every date, with available = false where there's no rate (useful to track sell-outs).", "default": true }, "includeBookingSites": { "title": "Booking-site prices for each date", "type": "boolean", "description": "For every date with a price, also get the rate each booking site lists (Booking.com, Expedia, Hotels.com, Agoda, Trip.com, the official site…) with notes like free cancellation, plus the cheapest site. One extra page per date, charged as 'booking-site prices' only when sites are found. Which sites Google shows depends on the country.", "default": false }, "maxBookingSiteDates": { "title": "Max dates with booking-site prices (per hotel)", "minimum": 0, "maximum": 366, "type": "integer", "description": "Only fetch booking-site prices for the first N dates with a price of each hotel. Empty or 0 = all dates." }, "language": { "title": "Language", "type": "string", "description": "Google interface language (hl), e.g. en, de, fr, ja, es.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Google country (gl), e.g. us, gb, de, jp. Affects price formatting and which booking sites are shown.", "default": "us" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Usually not needed: requests go out from the run's own IP. Turn on Apify datacenter proxy to send them through one proxy session instead. Residential proxies are ignored.", "default": { "useApifyProxy": 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 } } } } } } } } } }