{ "openapi": "3.0.1", "info": { "title": "Google Hotels Price Monitor", "description": "Track hotel prices on Google Hotels for any dates. Schedule it daily and get only the prices that changed since the last run, plus sold-out and back-in-stock alerts.", "version": "0.1", "x-build-id": "P4hcX4aDEywKYA4fe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mouad-abbar~google-hotels-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mouad-abbar-google-hotels-price-monitor", "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/mouad-abbar~google-hotels-price-monitor/runs": { "post": { "operationId": "runs-sync-mouad-abbar-google-hotels-price-monitor", "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/mouad-abbar~google-hotels-price-monitor/run-sync": { "post": { "operationId": "run-sync-mouad-abbar-google-hotels-price-monitor", "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 to track", "type": "array", "description": "Specific hotels to track, one per line. Add the city for accuracy, e.g. 'Savoy Le Grand Hotel Marrakech'. Each hotel returns one price per check-in date.", "items": { "type": "string" } }, "searches": { "title": "Destination searches", "type": "array", "description": "Area searches, e.g. 'hotels in Marrakech' or '5 star hotels in Paris'. Each search returns up to ~20 hotels per check-in date (Google's first results page).", "items": { "type": "string" } }, "checkInDaysAhead": { "title": "Check-in dates (days from today)", "type": "array", "description": "Check-in dates relative to the run date, e.g. [7, 14, 30]. Best for scheduled runs: the dates move forward automatically every day." }, "checkInDates": { "title": "Check-in dates (fixed)", "type": "array", "description": "Fixed check-in dates as YYYY-MM-DD. Past dates are skipped.", "items": { "type": "string" } }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay. Prices are Google's displayed nightly rate for that stay.", "default": 1 }, "onlyChanges": { "title": "Only output changes", "type": "boolean", "description": "Output only prices that are new, went up or down, sold out or came back since the previous run with the same monitor name. Unchanged prices are skipped (and not charged as results).", "default": false }, "minChangePct": { "title": "Minimum change (%)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Price moves smaller than this percentage count as unchanged. Google converts currencies live, so prices drift by cents between runs; 1% filters that noise out. Set 0 to report every cent.", "default": 1 }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same monitor name compare against each other. Use different names for unrelated monitors.", "default": "default" }, "maxHotelsPerSearch": { "title": "Max hotels per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "Cap on hotels kept from each destination search and date.", "default": 20 }, "language": { "title": "Language", "type": "string", "description": "Google interface language code, e.g. en, fr, es.", "default": "en" }, "maxConcurrency": { "title": "Max parallel lookups", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many Google pages to fetch at the same time. Higher is faster but more likely to be rate-limited.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy country decides the price currency (US = USD, GB = GBP). Avoid EU countries: Google shows them a cookie-consent page.", "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 } } } } } } } } } }