{ "openapi": "3.0.1", "info": { "title": "Hotel Rate Parity Checker — OTA Price Comparison", "description": "Hotel rate parity checker on Google Hotels prices: one row per property and stay with every OTA and the official site side by side (Booking.com, Expedia, Agoda, Hotels.com, Trip.com), the cheapest source, the spread and how far direct is undercut. Rate shopping for revenue managers. Pay per row.", "version": "1.0", "x-build-id": "9bdqlAI14znSoeTdL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kestrel~hotel-rate-parity/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kestrel-hotel-rate-parity", "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/kestrel~hotel-rate-parity/runs": { "post": { "operationId": "runs-sync-kestrel-hotel-rate-parity", "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/kestrel~hotel-rate-parity/run-sync": { "post": { "operationId": "run-sync-kestrel-hotel-rate-parity", "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": [ "checkIn" ], "properties": { "hotels": { "title": "Properties (Google Hotels URLs or entity tokens)", "uniqueItems": true, "type": "array", "description": "The properties to check: Google Hotels URLs (https://www.google.com/travel/hotels/entity/ChkI…) or bare entity tokens, one per line. Find a URL by opening the property on google.com/travel/hotels; the entity_id of any earlier row works too. One offers call per property and stay — no search, so nothing unrelated is ever billed.", "items": { "type": "string" } }, "hotelNames": { "title": "Properties by name", "uniqueItems": true, "type": "array", "description": "Property names, e.g. \"Hyatt Regency Lisbon\", \"Brown's Avenue Hotel Lisbon\". Each name costs one place search; the listing is kept only when its name matches most of the words you typed (at least two of them), otherwise the status row says not_found and nothing is billed. Add the city to a generic name.", "default": [], "items": { "type": "string" } }, "checkIn": { "title": "Check-in", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|\\+?\\s*\\d+\\s*(d|days?|w|weeks?|m|months?|y|years?)|today|tomorrow)$", "type": "string", "description": "Check-in date: absolute YYYY-MM-DD, or relative to the run date so a schedule never goes stale: \"30 days\", \"6 weeks\", \"+30d\", today, tomorrow. Past dates are rejected before anything is fetched." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay in nights (1–30). Check-out = check-in + nights.", "default": 1 }, "sweepDays": { "title": "Sweep check-in over N more days", "minimum": 0, "maximum": 60, "type": "integer", "description": "0 = only the stay above. N = also check the same length of stay starting on each of the next N days (7 = a week of check-in dates per property, one parity row each).", "default": 0 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 6, "type": "integer", "description": "Adults per room. Rates scale with occupancy exactly as on Google, so compare like with like.", "default": 2 }, "childrenAges": { "title": "Children (ages)", "type": "array", "description": "Ages of children sharing the room, e.g. [4, 9]. Leave empty for none.", "default": [] }, "currency": { "title": "Currency", "pattern": "^[A-Z]{3}$", "minLength": 3, "maxLength": 3, "type": "string", "description": "3-letter currency code for every price (USD, EUR, GBP, JPY, AED, …).", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Google UI language (hl); affects source labels.", "default": "en" }, "country": { "title": "Market", "type": "string", "description": "Google market (gl): which country's Google Hotels answers. Sources, prices and whether taxes are included differ by market — use the market you sell in.", "default": "us" }, "minSpreadPct": { "title": "Only keep spreads of at least N %", "minimum": 0, "maximum": 1000, "type": "number", "description": "0 = deliver every property. N = deliver only properties whose spread between the cheapest and dearest source is at least N % — the violations-only feed. Properties below the threshold get a free status row (status filtered) and are never billed.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google accepts Apify datacenter proxies for these calls; keep the default. Residential is unnecessary.", "default": { "useApifyProxy": true } }, "sessions": { "title": "Parallel proxy sessions", "minimum": 1, "maximum": 16, "type": "integer", "description": "Concurrent egress IPs; each is paced at perIp requests per second.", "default": 4 }, "perIp": { "title": "Requests per second per IP", "minimum": 0.1, "maximum": 2, "type": "number", "description": "Pace per proxy session. 0.5 is safe; raise carefully.", "default": 0.5 } } }, "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 } } }, "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 } } } } } } } } } }