{ "openapi": "3.0.1", "info": { "title": "Expedia Hotel Price Scraper & Monitor - Ratings & Price Drops", "description": "For hotel revenue managers, travel agencies and rate shoppers: Expedia hotel prices for any city and dates, with total price incl. taxes, nightly rate, previous price, rooms left, rating, reviews and deals. Monitoring returns only price drops, rises and new hotels. Export as CSV or Excel.", "version": "0.1", "x-build-id": "Sq7MREXEMpuBM0d3z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~expedia-hotel-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-expedia-hotel-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/neverempty~expedia-hotel-price-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-expedia-hotel-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/neverempty~expedia-hotel-price-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-expedia-hotel-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": { "destinations": { "title": "Destinations", "type": "array", "description": "Where to look, written as you would type it into the Expedia search box: a city (Paris), a city with its country (Paris, France), a district or a landmark (Times Square, New York). Each entry is one search. Every row says which place Expedia actually searched (resolvedDestination). Required.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "+N for N days after the run date in UTC (+30 = 30 days from the day the run starts, so a schedule always looks the same distance ahead), or a fixed date YYYY-MM-DD. Dates before yesterday (UTC) and arrivals more than 330 days ahead are refused with a free row before anything is requested. Empty = 30 days from today." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "+N days from the run date or YYYY-MM-DD. Must be after check-in; at most 28 nights. Empty = 1 night after check-in." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 14, "type": "integer", "description": "Guests in one room that the price is for. Empty = 2. Every row repeats the dates and guests Expedia priced (stayAsRequested says whether they match what you asked for)." }, "sortBy": { "title": "Sort by", "enum": [ "recommended", "lowest-price", "highest-price", "guest-rating", "star-rating", "distance" ], "type": "string", "description": "Order Expedia lists hotels in, as the sort menu on the site. Empty = recommended. Each row repeats the order Expedia applied (sortApplied)." }, "maxHotels": { "title": "Max hotels per destination", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many hotels to return for each destination, in Expedia's order. The first page has about 95; more are read 100 at a time. Empty = 100. In monitoring mode this is how many hotels are watched." }, "includeSponsored": { "title": "Include sponsored listings", "type": "boolean", "description": "Keep hotels Expedia marks as Ad. They are flagged with sponsored = true. Empty or on = keep them; off = skip them (they are not charged)." }, "monitoringMode": { "title": "Monitoring mode", "type": "boolean", "description": "Return only hotels that are new to this watch or whose total price moved since the row last returned for them (price-down, price-up, price-shown). Unchanged hotels are not returned. The first run returns every hotel as new. When a run finds no change, one small watch check fee is charged instead of rows." }, "minPriceChangePercent": { "title": "Smallest price change to report (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Monitoring only. A total price counts as changed when it moved at least this much from the price last returned. Empty = 2. 0 reports every change of at least one dollar." }, "resetMonitoringState": { "title": "Reset monitoring state", "type": "boolean", "description": "Forget what this search remembered, so this monitoring run returns every hotel as new. Empty or off = keep the memory." } } }, "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 } } } } } } } } } }