{ "openapi": "3.0.1", "info": { "title": "Expedia Hotel Prices", "description": "One search, one flat table: hotel name, id, neighbourhood, all-in price for the stay, nightly rate, guest score and review count, and the Expedia URL.", "version": "0.1", "x-build-id": "TFwHzZOo5DBUlFtzs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~expedia-hotels/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-expedia-hotels", "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/superslowsloth~expedia-hotels/runs": { "post": { "operationId": "runs-sync-superslowsloth-expedia-hotels", "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/superslowsloth~expedia-hotels/run-sync": { "post": { "operationId": "run-sync-superslowsloth-expedia-hotels", "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": [ "destination" ], "properties": { "destination": { "title": "Destination", "type": "string", "description": "A city, region, district or landmark such as Bangkok, Osaka, Bali or Times Square. Expedia resolves the text on its own side and answers almost any string with some region, so a typo can return a real but unrelated destination. Every output row carries requested_destination, resolved_destination and destination_matched so you can tell the difference." }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date as YYYY-MM-DD. Defaults to 30 days from the day the run starts." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay in nights. The check-out date is derived from it.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 14, "type": "integer", "description": "Number of adult guests per room. Prices are quoted for this occupancy.", "default": 2 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 8, "type": "integer", "description": "Number of rooms requested. Expedia prices the same party once per room, so the total scales with this.", "default": 1 }, "currency": { "title": "Currency", "enum": [ "USD", "GBP", "EUR", "CAD", "AUD", "NZD", "SGD", "MYR", "THB", "HKD", "INR", "JPY", "PHP" ], "type": "string", "description": "Three-letter currency code the prices are quoted in. Expedia sets currency per point of sale rather than per request, so this also picks which Expedia site is searched: USD, GBP, EUR, CAD, AUD, NZD, SGD, MYR, THB, HKD, INR, JPY, PHP. Anything else stops the run instead of quietly returning USD. Property names and price labels are requested in English on every one of them.", "default": "USD" }, "maxResults": { "title": "Max hotels", "minimum": 1, "maximum": 100, "type": "integer", "description": "Stop after this many hotels have been delivered. Properties with no price for those dates do not count against it. Expedia serves 50 per page and only two distinct pages per search, so 100 is the real ceiling for one destination and one set of dates - ask for more and the run simply ends early rather than charging you for repeats.", "default": 50 }, "includeUnpriced": { "title": "Include hotels with no price", "type": "boolean", "description": "Off by default. When on, properties with nothing bookable for those dates are emitted too, with a null price - they are never given a price of 0.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Required in practice, and residential is what works. Expedia rate limits per exit address and answers a throttled one with HTTP 429, or occasionally with an HTML interstitial served as HTTP 200; both are cleared by a different address, which the actor rotates to automatically." } } }, "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 } } } } } } } } } }