{ "openapi": "3.0.1", "info": { "title": "Expedia Hotels Scraper — Prices, Ratings & Reviews", "description": "Scrape hotels from Expedia by destination and dates: name, nightly price, guest rating, reviews count, location, deals and link. Optionally attach real guest reviews per hotel (text, score, date, reviewer, manager replies). Export JSON/CSV for rate shopping, price intelligence and review analysis.", "version": "0.1", "x-build-id": "7scajP8mzvXE0NXdk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~expedia-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-expedia-scraper", "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/haketa~expedia-scraper/runs": { "post": { "operationId": "runs-sync-haketa-expedia-scraper", "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/haketa~expedia-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-expedia-scraper", "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": "Pick one or more popular destinations to search hotels in. Leave everything empty to get a ready-made sample of hotels from top cities.", "items": { "type": "string", "enum": [ "New York", "Las Vegas", "Orlando", "Los Angeles", "Miami", "Chicago", "San Francisco", "Honolulu", "Washington, D.C.", "Boston", "Seattle", "New Orleans", "San Diego", "Nashville", "Austin", "London", "Paris", "Rome", "Barcelona", "Amsterdam", "Dubai", "Tokyo", "Bangkok", "Cancun", "Toronto" ], "enumTitles": [ "New York, USA", "Las Vegas, USA", "Orlando, USA", "Los Angeles, USA", "Miami, USA", "Chicago, USA", "San Francisco, USA", "Honolulu, Hawaii, USA", "Washington, D.C., USA", "Boston, USA", "Seattle, USA", "New Orleans, USA", "San Diego, USA", "Nashville, USA", "Austin, USA", "London, UK", "Paris, France", "Rome, Italy", "Barcelona, Spain", "Amsterdam, Netherlands", "Dubai, UAE", "Tokyo, Japan", "Bangkok, Thailand", "Cancun, Mexico", "Toronto, Canada" ] } }, "customDestinations": { "title": "Other destinations (optional)", "type": "array", "description": "Search any city or place not in the list above — just type its name, e.g. 'Reykjavik', 'Bali', 'Cape Town'. One entry per line.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Leave empty to use Expedia's default upcoming dates." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Leave empty to use Expedia's default upcoming dates." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 14, "type": "integer", "description": "Number of adults per room.", "default": 2 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 8, "type": "integer", "description": "Number of rooms.", "default": 1 }, "sortBy": { "title": "Sort results by", "enum": [ "RECOMMENDED", "PRICE_LOW_TO_HIGH", "PRICE_HIGH_TO_LOW", "REVIEW", "DISTANCE" ], "type": "string", "description": "How the hotel results should be ordered.", "default": "RECOMMENDED" }, "maxItemsPerSearch": { "title": "Max hotels per destination", "minimum": 0, "type": "integer", "description": "Cap how many hotels to collect per destination. 0 = all hotels on the results page.", "default": 0 }, "scrapeReviews": { "title": "Scrape guest reviews", "type": "boolean", "description": "Also fetch real guest review text (with score, date, author, themes and manager responses) for each hotel. Adds time per hotel.", "default": false }, "maxReviewsPerHotel": { "title": "Max reviews per hotel", "minimum": 0, "type": "integer", "description": "How many recent guest reviews to fetch per hotel when 'Scrape guest reviews' is on.", "default": 10 }, "startUrls": { "title": "Start URLs (advanced)", "type": "array", "description": "Optional: paste Expedia Hotel-Search URLs with your own filters instead of using the destination picker above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "US residential proxy is strongly recommended for reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel browser pages. Keep at 1 for the most reliable results and lowest cost; raise to scrape faster.", "default": 1 } } }, "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 } } } } } } } } } }