# Despegar Hotel Reviews Scraper (`parsebird/despegar-reviews-scraper`) Actor Scrape Despegar hotel guest reviews by URL or ID: rating, pros and cons, traveler type, verified flag, date, useful votes, plus hotel score, six category scores, AI summary, city, and stars. 7 Latin American markets. Export JSON, CSV, Excel via API. - **URL**: https://apify.com/parsebird/despegar-reviews-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.29 / 1,000 despegar hotel 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 ### Despegar Hotel Reviews Scraper Despegar Hotel Reviews Scraper collects guest reviews from [Despegar](https://www.despegar.com.ar/) for any hotel in Argentina, Mexico, Colombia, Chile, Peru, Uruguay, and Ecuador, with ratings, pros and cons, traveler type, and the hotel's overall and category scores.
Paste Despegar hotel URLs or IDs and get every available guest review with rating, separate pros and cons, trip type, verified flag, and useful votes, plus the hotel's score, six category scores, AI summary, city, address, and stars on each row.
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```text Use Apify Actor parsebird/despegar-reviews-scraper to scrape Despegar hotel guest reviews. Example with ApifyClient (Python): client.actor("parsebird/despegar-reviews-scraper").call(run_input={"startUrls":["https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba"],"maxReviewsPerHotel":200,"includeHotelSummary":True,"reviewsLanguage":"es"}). Inputs: startUrls array of Despegar hotel URLs (…/hoteles/h-/…; country taken from domain); hotelIds array of numeric IDs (used with market); market "AR" (default), "MX", "CO", "CL", "PE", "UY", "EC"; maxReviewsPerHotel integer default 200, 0 = all; includeHotelSummary boolean default true; reviewsLanguage "es" (default), "pt" (translated text), "en" (English labels, original text). Output: one row per review with reviewId, hotelId, hotelName, authorName, authorCountry, ratingPoints (0-10), pros, cons, travelerType, travelerTypeLabel, isVerified, reviewDate, reviewLanguage, usefulVotes, and with the summary: hotelScore, hotelScoreText, totalReviews, scoreLocation, scoreCleanliness, scoreStaff, scoreService, scoreWifi, scoreValue, aiSummary, city, address, stars; plus hotelUrl, market, scrapedAt. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations. ``` ### What is Despegar Hotel Reviews Scraper? **Despegar Hotel Reviews Scraper** is a **Despegar reviews API** alternative that turns any Despegar hotel page into structured guest-review data. Give it a hotel URL such as `https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba` (or just the ID `1051991`) and it returns **every available guest review** with rating, **separate pros and cons**, trip type, and useful votes, enriched with the **hotel's overall score, six category scores, and AI-generated opinion summary**. No Despegar account or API key is needed. The easiest way to try it is to open the actor, keep the prefilled hotel, and click **Start**. ### What can Despegar Hotel Reviews Scraper do? - 💬 **Collect all available reviews** for a hotel, or cap them with `maxReviewsPerHotel`. In our tests, one hotel returned 1,120 reviews in a few seconds. - 👍 **Split feedback into pros and cons**, exactly as guests wrote them on Despegar. - 🧳 **See who traveled**: couple, family, friends, solo, or business trip, with the site's label. - 🏨 **Add hotel context** to every row: overall score and label, review count, location, cleanliness, staff, service, Wi-Fi, and value scores, AI summary, city, address, and star class. - 🌎 **Cover 7 markets**: Argentina, Mexico, Colombia, Chile, Peru, Uruguay, and Ecuador. - 🗣️ **Choose the language**: Spanish, Portuguese (with translated review text), or English labels. - ⏱️ **Monitor hotels** with [Apify schedules](https://docs.apify.com/platform/schedules) to track new reviews and score changes. - 🔌 **Integrate** through the [Apify API](https://docs.apify.com/api/v2), webhooks, and [integrations](https://apify.com/integrations) such as Google Sheets, Make, Zapier, and Slack. - 📁 **Export** as JSON, CSV, Excel, HTML, or XML. ### What data can you extract from Despegar reviews? | Field | Description | |-------|-------------| | `reviewId` | Unique review ID | | `authorName`, `authorCountry` | Reviewer first name and country | | `ratingPoints` | Guest rating out of 10 | | `pros`, `cons` | What the guest liked and disliked | | `travelerType`, `travelerTypeLabel` | Trip type (`couple`, `family`, `friends`, `singles`, `businessTrip`) and its label | | `isVerified` | `true` when Despegar marks the reviewer as a verified guest | | `reviewDate` | Month and year shown with the review, for example `Julio 2024` | | `reviewLanguage` | Language code of the returned review text | | `usefulVotes` | How many users marked the review as useful | | `hotelId`, `hotelName` | Hotel ID and name | | `hotelScore`, `hotelScoreText` | Overall guest score out of 10 and its label (for example `Confortable`) | | `totalReviews` | Review count shown in Despegar's rating summary | | `scoreLocation`, `scoreCleanliness`, `scoreStaff`, `scoreService`, `scoreWifi`, `scoreValue` | Category scores out of 10 | | `aiSummary` | Despegar's AI-generated summary of guest opinions, when available | | `city`, `address`, `stars` | Hotel city, location text, and star class | | `hotelUrl`, `market`, `scrapedAt` | Hotel page, Despegar country site, and scrape time | Hotel fields appear when **Include hotel summary** is on. Fields Despegar does not provide are `null`. ### How to scrape Despegar hotel reviews 1. Open the Despegar site for your country (for example [despegar.com.ar](https://www.despegar.com.ar/) or [despegar.com.mx](https://www.despegar.com.mx/)), search a city, and open a hotel. 2. Copy the address-bar URL. It looks like `…/hoteles/h-1051991/amerian-cordoba-cordoba`. 3. Open [Despegar Hotel Reviews Scraper](https://apify.com/parsebird/despegar-reviews-scraper), click **Try for free** or **Start**, and paste the URL into **Hotel URLs**. Add as many hotels as you like. 4. Optionally set **Max reviews per hotel** (0 = all), **Reviews language**, and **Include hotel summary**. 5. Click **Start**, then open the **Output** tab or export the reviews as JSON, CSV, or Excel. ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrls` | array | One of `startUrls` / `hotelIds` | — | Despegar hotel URLs. The market is taken from the URL's domain. | | `hotelIds` | array | One of `startUrls` / `hotelIds` | — | Numeric hotel IDs (the number after `h-` in the URL), used with `market` | | `market` | string | No | `AR` | `AR`, `MX`, `CO`, `CL`, `PE`, `UY`, `EC` — Despegar country site for `hotelIds` | | `maxReviewsPerHotel` | integer | No | `200` | Maximum reviews per hotel; `0` = all available | | `includeHotelSummary` | boolean | No | `true` | Add hotel scores, AI summary, name, city, address, and stars to every review | | `reviewsLanguage` | string | No | `es` | `es`, `pt` (translated review text), or `en` (English labels; review text stays in its original language) | | `proxyConfiguration` | object | No | Apify Proxy | Proxy for review requests; the default works for most runs | ### Input / Output Example input: ```json { "startUrls": ["https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba"], "market": "AR", "maxReviewsPerHotel": 200, "includeHotelSummary": true, "reviewsLanguage": "es" } ``` Example output row: ```json { "reviewId": "66aa9a6ee61ce8039df19c70", "hotelId": "1051991", "hotelName": "Amerian Córdoba", "authorName": "Javier", "authorCountry": "Argentina", "ratingPoints": 4.2, "pros": "Solo la ubicacion", "cons": "Deben mejorar todo. Mala atencion. No ayudaron a bajar valijas. …", "travelerType": "couple", "travelerTypeLabel": "En pareja", "isVerified": true, "reviewDate": "Julio 2024", "reviewLanguage": "es", "usefulVotes": 7, "hotelScore": 7.9, "hotelScoreText": "Confortable", "totalReviews": 645, "scoreLocation": 9.3, "scoreCleanliness": 8.5, "scoreStaff": 8.2, "scoreService": 7.7, "scoreWifi": 8, "scoreValue": 8.1, "aiSummary": "Tuve una excelente estadía en un hotel espléndido. La atención del personal fue excepcional y la ubicación, perfecta para explorar. …", "city": "Córdoba", "address": "Córdoba, Argentina. A 611 m del centro", "stars": 4, "hotelUrl": "https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba", "market": "AR", "scrapedAt": "2026-09-29T13:16:20.574Z" } ``` Download results in JSON, CSV, Excel, HTML, or XML. ### Python API example ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("parsebird/despegar-reviews-scraper").call(run_input={ "hotelIds": ["1051991"], "market": "AR", "maxReviewsPerHotel": 0, }) for review in client.dataset(run["defaultDatasetId"]).iterate_items(): print(review["ratingPoints"], review["travelerType"], review["pros"], "|", review["cons"]) ``` ### JavaScript API example ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('parsebird/despegar-reviews-scraper').call({ startUrls: ['https://www.despegar.com.mx/hoteles/h-1227651/the-hacienda-at-krystal-grand-puerto-vallarta-puerto'], maxReviewsPerHotel: 100, reviewsLanguage: 'pt', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); const low = items.filter((r) => r.ratingPoints < 6); console.log(`${low.length} low-rated reviews`, low.map((r) => r.cons)); ``` See the [Python client](https://docs.apify.com/api/client/python/) and [JavaScript client](https://docs.apify.com/api/client/js/) docs for more options. ### Use cases - **Hotel reputation management**: track new reviews and category scores for your properties in Latin America. - **Competitor benchmarking**: compare location, cleanliness, staff, service, Wi-Fi, and value scores across hotels. - **Guest feedback analysis**: run sentiment or topic analysis on separate pros and cons. - **Travel research**: see which trip types (families, couples, business travelers) rate a hotel best. - **Market studies**: collect reviews across Argentina, Mexico, Chile, and other Despegar markets. ### How it works 1. The actor reads each hotel URL or ID and works out the hotel ID and Despegar market. 2. It pages through the hotel's guest reviews until all are collected or your limit is reached. 3. With **Include hotel summary** on, it reads the hotel's rating summary and hotel page once per hotel and adds those fields to every review. 4. It saves one row per review and logs any hotel that could not be found. ### How much does it cost to scrape Despegar reviews? **What is the price per Despegar review?** The actor uses pay-per-event pricing: you pay per review saved, and platform usage is included. | Event | Free plan | Bronze | Silver | Gold | |-------|-----------|--------|--------|------| | `review-scraped` | $0.00199 (**$1.99 / 1,000**) | $0.00179 (**$1.79 / 1,000**) | $0.00149 (**$1.49 / 1,000**) | $0.00129 (**$1.29 / 1,000**) | One `review-scraped` event is one review saved to the dataset. The default 200-review run costs about $0.40 on the Free plan; 1,000 reviews cost $1.99. Hotels with no reviews are not charged. Apify's free plan includes monthly platform credits you can use to try the actor. ### Is it legal to scrape Despegar reviews? **Is scraping Despegar hotel reviews legal?** The actor only collects reviews that Despegar shows publicly on hotel pages. Scraping public data is generally legal in many jurisdictions, but reviews contain personal data (first names and countries) protected by laws such as GDPR and Argentina's and Mexico's data-protection laws. Collect only what you need, respect Despegar's terms, and consult your lawyer if unsure. Read more in Apify's guide: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) ### Other review scrapers and related Actors | Actor | Best for | |-------|----------| | [Expedia Reviews Scraper](https://apify.com/parsebird/expedia-reviews-scraper) | Hotel reviews from Expedia | | [Airbnb Reviews Scraper](https://apify.com/parsebird/airbnb-reviews-scraper) | Airbnb listing reviews | | [Trustpilot Reviews Scraper](https://apify.com/parsebird/trustpilot-reviews-scraper) | Company reviews from Trustpilot | | [OpenTable Reviews Scraper](https://apify.com/parsebird/opentable-reviews-scraper) | Restaurant reviews from OpenTable | | [Capterra Review Scraper](https://apify.com/parsebird/capterra-review-scraper) | Software reviews from Capterra | ### FAQ **How many reviews can I get per hotel?** All reviews Despegar lists for the hotel. Set `maxReviewsPerHotel` to `0` to collect them all. `totalReviews` is the count shown in Despegar's rating summary, and the number of reviews listed can differ from it (for example, 1,120 listed reviews for a hotel whose summary shows 645). **Which market should I choose?** For hotel URLs, the market comes from the URL's domain automatically. For hotel IDs, choose the Despegar site the hotel belongs to. Argentina (`AR`) is the default. **What do the language options do?** `es` returns Spanish labels and the original review text. `pt` returns Portuguese labels and Despegar's Portuguese translation of the review text. `en` returns English labels, dates, and AI summary, while the review text stays in its original language. **Why is `aiSummary` empty for some hotels?** Despegar only generates an AI summary for some hotels. When it has none, the field is `null`. **Why are hotel name, city, or address empty?** They come from the hotel page, which is read once per hotel. If that page could not be loaded during the run, those fields are left empty while all review and score fields are still saved. Turn off **Include hotel summary** if you only need review fields. **Can I schedule runs?** Yes. Use [schedules](https://docs.apify.com/platform/schedules) to collect reviews daily or weekly, and connect results with [integrations](https://apify.com/integrations). **Where can I report issues?** Open the **Issues** tab on the actor page with your input and run ID. # Changelog This Actor's version history is a separate document: https://apify.com/parsebird/despegar-reviews-scraper/changelog.md # Actor input Schema ## `startUrls` (type: `array`): Despegar hotel page URLs, for example https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba. The country is taken from the URL's domain. Reviews are collected for each hotel. ## `hotelIds` (type: `array`): Numeric hotel IDs, the number after h- in the URL (for example 1051991). Used with Market. ## `market` (type: `string`): Despegar country site for hotel IDs. Hotel URLs use the country in their domain. ## `maxReviewsPerHotel` (type: `integer`): Maximum reviews saved per hotel. Use 0 to save all available reviews. ## `includeHotelSummary` (type: `boolean`): Add the hotel's overall score, six category scores, review count, AI summary, name, city, address, and stars to every review. ## `reviewsLanguage` (type: `string`): Language of labels and, where Despegar offers a translation, of the review text. Portuguese returns translated review text; English returns English labels with the original review text. ## `proxyConfiguration` (type: `object`): Proxy for review requests. The default (Apify Proxy) works for most runs. ## Actor input object example ```json { "startUrls": [ "https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba" ], "market": "AR", "maxReviewsPerHotel": 10, "includeHotelSummary": true, "reviewsLanguage": "es", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (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 = { "startUrls": [ "https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba" ], "market": "AR", "maxReviewsPerHotel": 10, "reviewsLanguage": "es", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/despegar-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 = { "startUrls": ["https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba"], "market": "AR", "maxReviewsPerHotel": 10, "reviewsLanguage": "es", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("parsebird/despegar-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 '{ "startUrls": [ "https://www.despegar.com.ar/hoteles/h-1051991/amerian-cordoba-cordoba" ], "market": "AR", "maxReviewsPerHotel": 10, "reviewsLanguage": "es", "proxyConfiguration": { "useApifyProxy": true } }' | apify call parsebird/despegar-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/despegar-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/s3epf0ByxpzGGjFo1/builds/x1M05mNZmdoco8QTv/openapi.json