{ "openapi": "3.0.1", "info": { "title": "Expedia & Hotels.com Scraper - Hotels, Prices & Reviews", "description": "Scrape Expedia and Hotels.com: hotel search results with nightly price, stay total, guest score, star class, amenities, address and coordinates, plus guest reviews with score, text, trip type and hotel reply. 30 Expedia sites, Expedia filters, monitor. $2.30 per 1,000 hotels, $2 per 1,000 reviews.", "version": "0.1", "x-build-id": "zTOD3WH9zKENylSUE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/topapi~expedia-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-topapi-expedia-hotels-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/topapi~expedia-hotels-scraper/runs": { "post": { "operationId": "runs-sync-topapi-expedia-hotels-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/topapi~expedia-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-topapi-expedia-hotels-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": { "mode": { "title": "Mode", "enum": [ "auto", "hotels", "reviews", "hotelsAndReviews" ], "type": "string", "description": "Auto: destinations -> hotel search rows, hotels -> their reviews. Hotels: hotel rows only (a hotel link gives its row with the lead room price). Reviews: reviews only (of the hotels you list, or of the top hotels of each destination). Hotels + reviews: both.", "default": "auto" }, "locations": { "title": "📍 Destinations", "type": "array", "description": "Cities, neighborhoods, landmarks or airports (by name or code, e.g. \"Heathrow Airport\", \"JFK\"), as you would type them on Expedia, e.g. \"Lisbon\", \"Times Square, New York\", \"Dublin, Ireland\". For a name several places share, add the state or country (\"Dublin, Ohio\"); without it the place with its own major airport is used (Dublin -> Dublin, Ireland), then the lowest Expedia region id, and RUN_SUMMARY notes list the others with their region ids. Each gives up to \"Max hotels per destination\" hotel rows.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Hotel or search links / ids", "type": "array", "description": "Expedia or Hotels.com hotel links (any regional site, also Travelocity / Orbitz / Wotif / CheapTickets / ebookers), Hotel-Search links, expe.app.link share links, bare Expedia hotel ids (Hotels.com links need the hotel name in them), e.g. \"https://www.expedia.com/London-Hotels-Strand-Palace-Hotel.h179.Hotel-Information\", \"179\".", "items": { "type": "string" } }, "hotelNames": { "title": "🏨 Hotel names", "type": "array", "description": "Hotel names with their city, e.g. \"Four Seasons Hotel Ritz Lisbon\". Matched on Expedia's own search; a name without a confident match is listed in RUN_SUMMARY and not guessed.", "items": { "type": "string" } }, "regionIds": { "title": "Region ids", "type": "array", "description": "Expedia region ids (the regionId= of a search link), e.g. \"2114\" for London. Skips the destination lookup.", "items": { "type": "string" } }, "googleMapsInputs": { "title": "Google Maps links", "type": "array", "description": "Google Maps place links of hotels, e.g. \"https://www.google.com/maps/place/Strand+Palace+Hotel/@51.51,-0.12,17z\". The hotel name and position are matched against Expedia's hotels (within 2 km).", "items": { "type": "string" } }, "site": { "title": "Expedia site", "enum": [ "expedia.com", "hotels.com", "expedia.co.uk", "expedia.ca", "expedia.com.au", "expedia.co.nz", "expedia.ie", "expedia.co.in", "expedia.com.sg", "expedia.com.my", "expedia.com.ph", "expedia.com.hk", "expedia.de", "expedia.at", "expedia.ch", "expedia.fr", "expedia.be", "expedia.nl", "expedia.es", "expedia.it", "expedia.se", "expedia.dk", "expedia.no", "expedia.fi", "expedia.co.jp", "expedia.co.kr", "expedia.co.th", "expedia.com.tw", "expedia.mx", "expedia.com.br" ], "type": "string", "description": "Which Expedia site prices the stay. Prices come in that site's currency (expedia.co.uk -> GBP). Hotels.com gives Hotels.com links.", "default": "expedia.com" }, "checkIn": { "title": "Check-in", "type": "string", "description": "YYYY-MM-DD or relative, e.g. \"2026-12-20\", \"30 days\", \"tomorrow\". Empty = 30 days from today." }, "checkOut": { "title": "Check-out", "type": "string", "description": "YYYY-MM-DD or nights after check-in, e.g. \"2026-12-22\" or \"3 days\". Empty = 2 nights." }, "adults": { "title": "Adults per room", "minimum": 1, "maximum": 14, "type": "integer", "description": "Adults in each room.", "default": 2 }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 8, "type": "integer", "description": "Number of rooms (each with the adults above).", "default": 1 }, "childrenAges": { "title": "Children ages", "type": "array", "description": "One age (0-17) per child, e.g. \"5\", \"9\". Children stay in the first room.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "RECOMMENDED", "PRICE_LOW_TO_HIGH", "PRICE_HIGH_TO_LOW", "DISTANCE", "REVIEW", "REVIEW_RELEVANT", "PROPERTY_CLASS" ], "type": "string", "description": "Expedia's own sort orders.", "default": "RECOMMENDED" }, "minPrice": { "title": "Min nightly price", "minimum": 0, "type": "integer", "description": "Lowest nightly price in the site's currency, e.g. 80." }, "maxPrice": { "title": "Max nightly price", "minimum": 0, "type": "integer", "description": "Highest nightly price in the site's currency, e.g. 300." }, "starRatings": { "title": "Star rating", "type": "array", "description": "Only these property classes. Empty = any.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "minGuestRating": { "title": "Guest rating", "enum": [ "ANY", "7", "8", "9" ], "type": "string", "description": "Expedia's guest-score filter.", "default": "ANY" }, "amenities": { "title": "Amenities", "type": "array", "description": "Only properties with all of these.", "items": { "type": "string", "enum": [ "POOL", "PETS", "WIFI", "AIR_CONDITIONING", "FREE_AIRPORT_TRANSPORTATION", "HOT_TUB", "SPA_ON_SITE", "WASHER_DRYER", "KITCHEN_KITCHENETTE", "ELECTRIC_CAR", "GYM", "CRIB", "FREE_PARKING", "BALCONY_OR_TERRACE", "RESTAURANT_IN_HOTEL", "bed_linens_provided", "balcony_patio", "indoor_fireplace", "outdoor_grill", "kids_high_chair", "heated_pool" ], "enumTitles": [ "Pool", "Pet friendly", "Wifi included", "Air conditioned", "Airport shuttle included", "Hot tub", "Spa", "Washer and dryer", "Kitchen", "Electric car charging station", "Gym", "Cribs", "Parking", "Outdoor space", "Restaurant", "Bed linens provided", "Balcony or patio", "Indoor fireplace", "Grill", "Kids' high chair", "Heated pool" ] } }, "propertyTypes": { "title": "Property type", "type": "array", "description": "Only these property types. Empty = any.", "items": { "type": "string", "enum": [ "HOTEL", "HOTEL_RESORT", "apartment_or_condo", "APART_HOTEL", "HOSTEL", "BED_AND_BREAKFAST", "GUEST_HOUSE", "MOTEL", "INN", "VILLA", "VACATION_HOME", "COTTAGE", "CHALET", "CABIN", "LODGE", "COUNTRY_HOUSE", "HOSTAL", "PENSION", "POUSADA_BRAZIL", "POUSADA_PORTUGAL", "RESIDENCE", "PALACE", "RYOKAN", "CASTLE", "CRUISE", "AGRITOURISM", "HOLIDAY_PARK", "CARAVAN_PARK", "RANCH", "TREE_HOUSE", "HOUSE_BOAT", "boat", "RIAD", "TOWNHOUSE", "CAPSULE_HOTEL", "SAFARI", "RV" ], "enumTitles": [ "Hotel", "Resort", "Apartment or condo", "Aparthotel", "Hostel/Backpacker accommodation", "Bed & breakfast", "Guesthouse", "Motel", "Inn", "Villa", "Private vacation home", "Cottage", "Chalet", "Cabin", "Lodge", "Country house", "Hostal", "Pension", "Pousada (Brazil)", "Pousada", "Residence", "Palace", "Ryokan", "Castle", "Cruise", "Farm", "Holiday park", "Camping", "Ranch", "Tree house", "Houseboat", "Boat", "Riad", "Townhouse", "Capsule hotel", "Safari", "RV" ] } }, "stayType": { "title": "Type of place", "enum": [ "any", "hotels", "homes" ], "type": "string", "description": "Expedia's \"Type of place\" switch.", "default": "any" }, "mealPlans": { "title": "Meal plan", "type": "array", "description": "Only properties offering these meal plans.", "items": { "type": "string", "enum": [ "FREE_BREAKFAST", "HALF_BOARD", "FULL_BOARD", "ALL_INCLUSIVE" ], "enumTitles": [ "Breakfast included", "Half board", "Full board", "All inclusive" ] } }, "freeCancellation": { "title": "Fully refundable only", "type": "boolean", "description": "Only properties with a fully refundable rate.", "default": false }, "payLater": { "title": "Reserve now, pay later", "type": "boolean", "description": "Only properties that let you pay at the property.", "default": false }, "deals": { "title": "Deals and programmes", "type": "array", "description": "Expedia's One Key / deals filters.", "items": { "type": "string", "enum": [ "MEMBER_ONLY", "VIP", "discounted_property" ], "enumTitles": [ "Member prices", "VIP Access properties", "Discounted properties" ] } }, "propertyName": { "title": "Property name contains", "type": "string", "description": "Expedia's \"Search by property name\" filter, e.g. \"marriott\"." }, "showAvailableOnly": { "title": "Available only", "type": "boolean", "description": "Hide sold-out properties.", "default": false }, "neighborhoodId": { "title": "Neighborhood id", "type": "string", "description": "Limit a search to one neighborhood (its Expedia region id, e.g. \"179463\" for Baixa, Lisbon)." }, "customFilters": { "title": "More Expedia filters", "type": "object", "description": "More Expedia filters by their id: accessibility, travelerType, bedroomFilter, hotel_brand, neighborhood, room_views_group, room_amenities_group, beach_access_group, nearby_activities_group, amenities_facilities_group, or Expedia's ids for the filters above (star, guestRating, amenities, lodging, categorySearch, mealPlan, paymentType, rewards, availableFilter). Any other id is ignored with a note in RUN_SUMMARY. E.g. {\"accessibility\": [\"ELEVATOR\"], \"travelerType\": [\"family_friendly\"], \"bedroomFilter\": [\"2\"], \"hotel_brand\": [\"2680\"]}." }, "minReviews": { "title": "Min review count", "minimum": 0, "type": "integer", "description": "Drop hotels with fewer guest reviews, e.g. 50." }, "onlyWithPrice": { "title": "Only hotels with a price", "type": "boolean", "description": "Drop hotels Expedia shows without a price for your dates.", "default": false }, "reviewsFrom": { "title": "Reviews from", "type": "string", "description": "Only reviews written on or after this day: YYYY-MM-DD, or how far back from today, e.g. \"2026-01-01\", \"30 days\" (the last 30 days), \"6 months\"." }, "reviewsTo": { "title": "Reviews to", "type": "string", "description": "Only reviews written on or before this day: YYYY-MM-DD, or how far back from today, e.g. \"2026-06-30\", \"7 days\"." }, "minRating": { "title": "Min review score", "minimum": 1, "maximum": 10, "type": "integer", "description": "Only reviews scoring at least this (Expedia's 1-10 scale)." }, "maxRating": { "title": "Max review score", "minimum": 1, "maximum": 10, "type": "integer", "description": "Only reviews scoring at most this, e.g. 4 for complaints." }, "onlyWithText": { "title": "Only reviews with text", "type": "boolean", "description": "Skip score-only reviews.", "default": false }, "reviewLanguages": { "title": "Review languages", "type": "array", "description": "Two-letter codes, e.g. \"en\", \"fr\". Empty = all. Matched on the row's language: the one Expedia marks on a review written in another language than the site's, otherwise en, the site's language (a few untranslated non-English reviews read en too). Score-only reviews have no language, so this filter drops them.", "items": { "type": "string" } }, "maxReviewsPerHotel": { "title": "Max reviews per hotel", "minimum": 0, "type": "integer", "description": "0 = every review Expedia serves (all 5,759 of Strand Palace Hotel in a test).", "default": 50 }, "reviewSort": { "title": "Review order", "enum": [ "newest", "relevant", "highest", "lowest", "mostHelpful" ], "type": "string", "description": "Expedia's own review orders.", "default": "newest" }, "travelerType": { "title": "Traveler type", "enum": [ "all", "couples", "families", "families_with_young_children", "business", "groups", "solo", "with_pets" ], "type": "string", "description": "Expedia's traveler-type review filter.", "default": "all" }, "reviewKeyword": { "title": "Review keyword", "type": "string", "description": "Expedia's \"Search reviews\" box, e.g. \"breakfast\"." }, "maxHotelsPerSearch": { "title": "Hotels per destination (reviews)", "minimum": 0, "type": "integer", "description": "In Reviews mode, how many top hotels of each destination have their reviews read.", "default": 10 }, "includeReviewPhotos": { "title": "Review photos", "type": "boolean", "description": "Photo links guests attached.", "default": true }, "includeOwnerResponses": { "title": "Hotel responses", "type": "boolean", "description": "The property's reply and its date.", "default": true }, "includeReviewMarkdown": { "title": "Markdown copy", "type": "boolean", "description": "Adds reviewMarkdown: the review as one markdown block for LLM / RAG pipelines.", "default": false }, "stripPersonalData": { "title": "Strip personal data", "type": "boolean", "description": "ON: authorName, reviewerName and hotelResponseAuthor are empty, and the greeting name, the reviewer's name and the staff name in the sign-off are taken out of hotelResponse (and reviewMarkdown). A name staff write elsewhere in a reply can remain; turn off Hotel responses to leave replies out. OFF: names are filled and replies are kept as written.", "default": true }, "includeDetails": { "title": "Hotel details (paid add-on)", "type": "boolean", "description": "Adds to each hotel row: amenities by category, policies, important info, scores by category, rating histogram, AI review summary, highlights, nearby places, photo gallery, rooms and rates. Charged as hotel-details at $0.00095 per hotel.", "default": false }, "includeRooms": { "title": "Rooms and rates in details", "type": "boolean", "description": "Room types with size, beds, photos and every rate (meal plan, price, payment options) for your dates. Part of hotel details.", "default": true }, "maxPropertyImages": { "title": "Max gallery photos", "minimum": 0, "type": "integer", "description": "Cap the gallery in hotel details, e.g. 20. 0 = all.", "default": 0 }, "ratePositionReport": { "title": "Rate-position report", "type": "boolean", "description": "One report row per destination (up to 5 per run): nightly-rate and guest-score spread, prices by star class, and where your hotel ranks. Charged as rate-position-report at $0.14 per report; never charged when fewer than 3 hotels have a price.", "default": false }, "ratePositionSubject": { "title": "Your hotel (report subject)", "type": "string", "description": "Part of your hotel's name or its Expedia id, e.g. \"Strand Palace\"." }, "monitorMode": { "title": "Only new rows", "type": "boolean", "description": "Skip hotels and reviews delivered by earlier runs: hotels per search, or for hotels you list per list and stay (dates and guests); reviews per hotel, whichever search or list delivered them. Hotels come back when their stay price changes (see below). Use a separate monitor store per schedule. A rate-position report is rebuilt and charged on every run.", "default": false }, "monitorPriceChanges": { "title": "Re-deliver price changes", "type": "boolean", "description": "In monitor mode, deliver a hotel again when its stay price changed (changeType \"priceChanged\" + previousTotalPrice).", "default": true }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that remembers delivered rows. Use one per schedule: review memory is per hotel, so schedules sharing a store share it. Default: expedia-hotels-monitor." }, "maxResults": { "title": "Max hotels per destination", "minimum": 0, "type": "integer", "description": "0 = all Expedia serves for the search (about 500 hotels per destination, measured on London and Lisbon). Split a city into neighborhoods to go deeper. Hotels you list (links, ids, names) are not capped: each gets its row.", "default": 100 }, "compact": { "title": "Compact rows", "type": "boolean", "description": "Core fields only, sized for AI agents and MCP. Details fields stay when hotel details are on.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Expedia answers residential connections only (datacenter proxies are refused). Keep RESIDENTIAL.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel requests.", "default": 3 } } }, "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 } } } } } } } } } }