# Expedia Reviews Scraper (`parsebird/expedia-reviews-scraper`) Actor Scrape Expedia hotel guest reviews by URL or hotel ID. Extract rating, review text, stay date, traveler name, sentiment themes, guest photos, and management responses. JSON, CSV, Excel. - **URL**: https://apify.com/parsebird/expedia-reviews-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.29 / 1,000 guest reviews This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### Expedia Reviews Scraper Expedia Reviews Scraper extracts guest reviews from any [Expedia](https://www.expedia.com) hotel listing — ratings, review text, stay dates, traveler details, sentiment themes, guest photos, and management responses — without touching Expedia's private API or copy-pasting reviews by hand.
Turn any Expedia hotel page into structured review data — ratings, sentiment themes, stay dates, and management responses — sorted by relevance, recency, or rating, ready for JSON, CSV, or Excel export.

##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` Use the Apify actor "parsebird/expedia-reviews-scraper" (Expedia Reviews Scraper) via the apify-client library: from apify_client import ApifyClient; client = ApifyClient(""); run = client.actor("parsebird/expedia-reviews-scraper").call(run_input={"startUrl": "https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information", "results_wanted": 20, "max_pages": 8, "review_sort": "most_recent"}); items = client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: startUrl (string, an Expedia Hotel-Information URL), hotelId (string, Expedia hotel ID, overrides startUrl if both are given and disagree), results_wanted (integer, default 20, max review records to save), max_pages (integer, default 8, max review pages of up to 25 reviews each), review_sort (string: none, most_relevant, most_recent, highest_rating, lowest_rating), proxyConfiguration (object, defaults to Apify Proxy RESIDENTIAL group, country US). Output: one JSON record per review with hotel_id, hotel_name, review_id, rating, title, review_text, published_date, stay_date, traveler_name, traveler_type, traveler_location, language, helpful_votes, review_sentiments, guest_photos, management_response_title, response_text, property_url, source_url, scraped_at. Full API reference: https://apify.com/parsebird/expedia-reviews-scraper/api. Get an API token at https://console.apify.com/account/integrations. ``` ### What does Expedia Reviews Scraper do? Expedia Reviews Scraper is a review-extraction tool for [Expedia.com](https://www.expedia.com) hotel listings. Give it a hotel's Hotel-Information URL or just its numeric hotel ID, and it returns every guest review it can find — as structured JSON, ready to filter, chart, or feed into a sentiment model — instead of Expedia's read-only web page. - 🏨 Works with any Expedia hotel — paste the Hotel-Information URL or just the hotel ID - ⭐ Captures the full review payload: rating, title, text, sentiment themes, stay date, and guest photos - 💬 Pulls hotel management responses to reviews when the property replies - 🔀 Sort collected reviews by relevance, recency, highest rating, or lowest rating - ⏱️ Runs on Apify's infrastructure with scheduling, API access, and webhooks — no server or Expedia API key required ### What data can you extract from Expedia reviews? | Field | Description | |-------|-------------| | `hotel_id` | Expedia hotel identifier | | `hotel_name` | Hotel name | | `review_id` | Unique review identifier, when available | | `rating` | Guest rating value (out of 10) | | `title` | Review headline | | `review_text` | Main review body | | `published_date` | Date the review was published | | `stay_date` | Month or date of the guest stay | | `traveler_type` | Traveler category, such as family, couple, or business traveler | | `traveler_name` | Reviewer display name | | `traveler_location` | Reviewer location, when shown | | `language` | Review language or locale | | `helpful_votes` | Helpful vote count, when available | | `review_sentiments` | Review theme labels and sentiment highlights | | `guest_photos` | Guest photo URLs, when included with the review | | `management_response_title` | Heading for the property's response | | `response_text` | Management response text | | `property_url` | Expedia hotel page used for the run | | `source_url` | Source URL recorded for traceability | | `scraped_at` | Timestamp when the record was collected | ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | startUrl | string | No | Example Expedia hotel URL | Expedia hotel listing page. Hotel-Information URLs are recommended. | | hotelId | string | No | — | Expedia hotel ID. Use this when you don't want to provide a full URL. | | review\_sort | string | No | none | Review order: `none`, `most_relevant`, `most_recent`, `highest_rating`, `lowest_rating`. | | results\_wanted | integer | No | 20 | Maximum number of review records to save. | | max\_pages | integer | No | 8 | Maximum number of review pages to request for the selected hotel. | | proxyConfiguration | object | No | Apify Proxy, RESIDENTIAL group, country US | Proxy settings for reliable runs. | At least one of `startUrl` or `hotelId` must identify the hotel. If both are provided and don't match, the actor uses `hotelId`. ### How to scrape Expedia hotel reviews 1. Open **Expedia Reviews Scraper** on the [Apify Store](https://apify.com/parsebird/expedia-reviews-scraper) and click **Try for free**. 2. Paste the hotel's Expedia URL — the Hotel-Information page — into **Hotel URL**, or type its numeric **Hotel ID** if you already know it. 3. Optionally set **Review order**, **Max reviews**, and **Max review pages**. 4. Click **Start** and wait for the run to finish. 5. Download results as JSON, CSV, Excel, or HTML, or read them straight from the Dataset API. #### Python ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("parsebird/expedia-reviews-scraper").call(run_input={ "startUrl": "https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information", "results_wanted": 50, "review_sort": "most_recent", }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["rating"], item["review_text"]) ``` #### JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('parsebird/expedia-reviews-scraper').call({ startUrl: 'https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information', results_wanted: 50, review_sort: 'most_recent', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### Output example ```json { "hotel_id": "438504", "hotel_name": "London Heathrow Marriott Hotel", "review_id": "6a53be57ba249f2d22dfa6de", "rating": 10, "review_text": "Very good hotel and friendly staff excellent breakfast enjoyed our stay", "published_date": "2026-07-12", "stay_date": "2026-06", "traveler_name": "Afreen", "language": "en_CA", "review_sentiments": [ "Liked: cleanliness, staff & service, amenities, property conditions & facilities" ], "management_response_title": "Response from Ansh on Jul 18, 2026", "response_text": "Dear Afreen, Thank you for your wonderful review! We're delighted to hear you enjoyed your stay.", "property_url": "https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information", "scraped_at": "2026-07-22T13:00:11.692Z" } ``` Fields that Expedia doesn't show for a given review (such as `title`, `traveler_type`, or `guest_photos`) are simply left out of that record instead of being sent as empty values. Download the full dataset in JSON, CSV, Excel, or HTML from the Apify Console, or pull it via the [Dataset API](https://docs.apify.com/api/v2#/reference/datasets). ### Use cases - Hotel reputation monitoring for revenue managers and hoteliers - Competitive benchmarking of guest sentiment across nearby properties - Feeding review text into sentiment analysis or NLP pipelines - Travel research tools and review-aggregation apps - Tracking how quickly (and how well) a property responds to guest feedback ### How it works 1. The actor resolves your hotel from the URL or hotel ID and opens its Expedia listing. 2. It reads the hotel's guest review feed in the order you chose (`review_sort`). 3. It pages through reviews — up to `max_pages` pages of 25 reviews each — until it reaches `results_wanted` or runs out of reviews. 4. Each review is normalized into a flat JSON record and pushed to the dataset as it's collected. 5. Requests automatically back off and retry if Expedia briefly rate-limits a run, so transient hiccups don't fail the whole job. ### How much does it cost to scrape Expedia reviews with this actor? **Pay-per-event (PPE)** pricing — you pay only for review records actually returned, not for compute time. | Event | Price per event | Price per 1,000 | |-------|-----------------|------------------| | review-scraped | $0.00199 | **$1.99** | Collecting 20 reviews (the default) costs about $0.04; a deeper run of 1,000 reviews costs about $1.99 at the free-tier rate. Apify subscription plans (bronze, silver, gold) unlock lower per-event pricing on the same actor. ### FAQ **Do I need an Expedia account or API key?** No. Expedia Reviews Scraper reads publicly visible guest reviews from the hotel's listing page — no login or Expedia API access required. **Can I search for hotels by city or keyword?** Not directly. This actor takes one specific hotel per run (via `startUrl` or `hotelId`). Find the hotel's Expedia URL first, then feed it into this actor to pull its reviews. **What if `startUrl` and `hotelId` point to different hotels?** The actor uses `hotelId` and logs a warning — see [Input parameters](#input-parameters). **Why did a run return fewer reviews than `results_wanted`?** Either the hotel has fewer reviews than requested, or Expedia briefly rate-limited the request. The actor retries automatically with backoff; for large `results_wanted` values, consider increasing `max_pages` or re-running. **Can I schedule recurring runs?** Yes. Use Apify's [Scheduler](https://docs.apify.com/platform/schedules) to run this actor daily, weekly, or at any interval to track new reviews over time. **Can I access this actor programmatically?** Yes, via the [Apify API](https://docs.apify.com/api/v2), the `apify-client` Python/JavaScript libraries, or [integrations](https://apify.com/integrations) with Make, Zapier, Google Sheets, and more. **I found a bug or missing field — where do I report it?** Open an issue on the actor's Issues tab in Apify Console. Include the hotel URL/ID and run ID so it can be reproduced quickly. ### Is it legal to scrape Expedia reviews? Scraping publicly available data — such as guest reviews shown on a public Expedia hotel page — is generally legal, but you're responsible for how you use the collected data. Avoid scraping personal data beyond what's needed, respect Expedia's Terms of Service, and don't use the data in ways that could harm individuals or violate applicable law (such as GDPR or CCPA where relevant). See Apify's [blog post on the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) for a fuller discussion. ### Related Actors - [Airbnb Reviews Scraper](https://apify.com/parsebird/airbnb-reviews-scraper) — extract guest reviews from Airbnb listings - [Airbnb Scraper & API](https://apify.com/parsebird/airbnb-scraper) — extract Airbnb listing details, pricing, and availability - [Trustpilot Reviews Scraper](https://apify.com/parsebird/trustpilot-reviews-scraper) — extract company reviews from Trustpilot # Changelog This Actor's version history is a separate document: https://apify.com/parsebird/expedia-reviews-scraper/changelog.md # Actor input Schema ## `startUrl` (type: `string`): An Expedia hotel listing page. Hotel-Information URLs are recommended, e.g. https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information ## `hotelId` (type: `string`): Expedia hotel ID, e.g. 438504. Use this instead of a full URL if you already know the ID. If both Hotel URL and Hotel ID are set and point to different hotels, Hotel ID wins. ## `review_sort` (type: `string`): Order guest reviews are collected in. ## `results_wanted` (type: `integer`): Maximum number of review records to save. You are only charged for reviews actually returned. ## `max_pages` (type: `integer`): Maximum number of review pages to request for the hotel. Expedia returns up to 25 reviews per page, so this caps how deep pagination goes even if Max reviews is higher. ## `proxyConfiguration` (type: `object`): Expedia is protected by Akamai bot detection. The default is Apify Proxy, RESIDENTIAL group, country US, for reliable runs. ## Actor input object example ```json { "startUrl": "https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information", "review_sort": "none", "results_wanted": 20, "max_pages": 8, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrl": "https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information", "results_wanted": 20, "max_pages": 8, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/expedia-reviews-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrl": "https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information", "results_wanted": 20, "max_pages": 8, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("parsebird/expedia-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrl": "https://www.expedia.com/London-Hotels-London-Heathrow-Marriott-Hotel.h438504.Hotel-Information", "results_wanted": 20, "max_pages": 8, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call parsebird/expedia-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/expedia-reviews-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/mpXGPDW1phQQzj28X/builds/C6bexrhKugjnlJykt/openapi.json