MCP + API · kestrel/despegar-hotel-ratings

Despegar Hotel Ratings Scraper - Guest Scores, AI Summary

Get Despegar hotel ratings by hotel URL or ID in Latin America. One row per hotel: guest score, review count, six category scores, stars, city and Despegar AI review summary. Free: up to four published comments, not a full review list. Filter minimum rating. Opiniones y calificaciones de hoteles.

Open Actor Download MCP config

Connect this tool

Add this URL as a remote MCP server in your client, then sign in to Apify. For a client-specific setup, use Apify's configurator.

https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/despegar-hotel-ratings
Generic MCP client configuration
{
  "mcpServers": {
    "kestrel-despegar-hotel-ratings": {
      "url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/despegar-hotel-ratings"
    }
  }
}

Understand the output before you run

One row per hotel with its guest rating, category scores and Despegar's own AI summary (charged), plus the up-to-four published comments and a status row per target (both free).

Declared dataset fields and row types · Output locations and dataset links

Use the declared dataset schema for item fields; the output schema describes where results are stored. Optional fields may be null or absent. If an integration shows a sampled schema without an optional field, check this declaration, the Actor instructions and actual returned rows before concluding that the field is unsupported.

Inspect 52 declared output fields
FieldTypeMeaning
typestringhotel | review | status
targetstring / nullThe input value (URL or hotel id) this row came from
hotel_idstring / nullDespegar's numeric hotel id (the number in /h-<id>/); the same id on every Despegar country domain
hotel_namestring / nullHotel name as the chosen Despegar site writes it
hotel_urlstring / nullCanonical hotel page URL on the domain that was read
citystring / nullCity, from the location line under the hotel name (hotel rows)
countrystring / nullCountry of the hotel, in the page's language (hotel rows)
addressstring / nullStreet address as printed in the map section (hotel rows)
latitudenumber / nullLatitude of the hotel marker (hotel rows)
longitudenumber / nullLongitude of the hotel marker (hotel rows)
starsinteger / nullStar rating, counted from the stars printed above the hotel name (hotel rows)
ratingnumber / nullOverall guest rating on Despegar's 0-10 scale, e.g. 8.4
rating_scaleinteger / nullThe scale the rating is on: always 10 (hotel rows)
rating_5number / nullThe same score converted to the 0-5 star scale, e.g. 8.4 -> 4.2
rating_labelstring / nullDespegar's word for the score, e.g. "Muy bueno" / "Very good" (hotel rows)
review_countinteger / nullHow many guest reviews the rating is based on, as Despegar counts them (e.g. 4511) — not how many this actor can deliver (hotel rows)
reviews_showninteger / nullHow many individual comments the page actually publishes: at most four (hotel rows)
score_servicenumber / nullCategory score 0-10: services and installations (hotel rows)
score_staffnumber / nullCategory score 0-10: accommodation staff (hotel rows)
score_locationnumber / nullCategory score 0-10: location (hotel rows)
score_internetnumber / nullCategory score 0-10: internet / Wi-Fi (hotel rows)
score_cleanlinessnumber / nullCategory score 0-10: cleaning (hotel rows)
score_valuenumber / nullCategory score 0-10: price/quality (hotel rows)
category_scoresobject / nullThe same six scores keyed by Despegar's own codes: service, servicePersonal, location, internetAccessAndQuality, cleaning, qualityprice (hotel rows)
summarystring / nullDespegar's own AI-written summary of what guests say about the hotel, generated by Despegar from all its reviews and published on the page — their text, not ours (hotel rows)
verified_notestring / nullDespegar's provenance note for the sample, e.g. "Clientes verificados por Grupo Despegar." (hotel rows)
providersarray / nullWhich review providers the published comments come from; DESPEGAR on every hotel we have seen (hotel rows)
trip_typesarray / nullTraveller profiles Despegar offers to filter the comments by: couple, friends, singles, family (hotel rows)
page_languagestring / nullLanguage the domain served, e.g. es or en (hotel rows)
page_countrystring / nullCountry code of the Despegar site that was read, e.g. AR (hotel rows)
review_idstring / nullDespegar's id for the comment (review rows)
review_datestring / nullThe month the guest wrote the comment, in the page's language, e.g. "Agosto 2023" — Despegar publishes no day (review rows)
review_monthstring / nullThe same date normalised to YYYY-MM (review rows)
textstring / nullThe comment: the good half and the bad half joined; Despegar reviews have no title (review rows)
goodstring / nullWhat the guest liked (review rows)
badstring / nullWhat the guest disliked; absent when they only wrote praise (review rows)
reviewerstring / nullGuest's first name, when they published one (review rows)
reviewer_countrystring / nullGuest's country, when published (review rows)
reviewer_country_codestring / nullTwo-letter code for that country (review rows)
trip_typestring / nullWho was travelling: couple | friends | singles | family (review rows)
trip_type_labelstring / nullThe same, as the page words it, e.g. "En familia" (review rows)
languagestring / nullLanguage the comment was written in (review rows)
providerstring / nullWhich provider supplied the comment, e.g. DESPEGAR (review rows)
provider_labelstring / nullDespegar's badge for that provider, e.g. "Huésped verificado" (review rows)
helpful_votesinteger / nullHow many readers marked the comment useful (review rows)
statusstring / nullok | no_reviews | not_found | filtered | duplicate | blocked | limited | error (status rows)
hotelsinteger / null1 when a hotel row was delivered and charged for this target (status rows)
commentsinteger / nullHow many published comments were delivered for this target, free (status rows)
filteredinteger / null1 when minRating dropped this hotel before billing (status rows)
duplicatesinteger / null1 when this target is the same hotel as an earlier one (status rows)
errorstring / nullWhy a target produced nothing (status rows)
fetched_atstring / nullUTC timestamp of the request

Start with a small sample

Use call-actor with the JSON below. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Change the target to match your request. This input validates against build 1.0.8; it is not a promise that the source has matching rows today.

{
  "actor": "kestrel/despegar-hotel-ratings",
  "input": {
    "startUrls": [
      "https://www.despegar.com.ar/hoteles/h-265543/riu-cancun"
    ],
    "country": "ar",
    "includeComments": true
  },
  "callOptions": {
    "maxTotalChargeUsd": 0.25,
    "timeout": 300
  },
  "waitSecs": 30
}

After completion, use get-dataset-items with storages.datasets.default.id. If still running, poll get-actor-run using the returned runId. Check status rows and errors before treating an empty dataset as no matches.

Call from Python, JavaScript or REST

Python SDK 3 example · JavaScript SDK 2 example · curl + jq example. Each uses this same small input, reads APIFY_TOKEN from your environment, sets a five-minute run timeout and exports all dataset row types as JSON Lines. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Inspect the run and source status before treating results as complete. Installation and usage.

Pricing and limits

Current listed event prices in USD. Some Actors charge for successful source checks even when no output rows match. The event descriptions below define those differences.

EventUSD eachWhat is charged
hotel$0.004One Despegar hotel: the 0-10 guest rating with its review count, six category scores (service, staff, location, Wi-Fi, cleanliness, value), Despegar's AI summary of what guests say, stars, city, country and coordinates (row keys hotel_id, rating, review_count, score_service, score_staff, score_location, score_internet, score_cleanliness, score_value, summary, stars, city, country, latitude, longitude): $4 per 1,000 hotels. Free: the up-to-four comments the page publishes (whatever the review count says; there is no full review list), hotels with no rating, unknown ids, hotels below minRating, duplicates, status rows. No start fee; proxy and compute are included in the event price. The run stops at the maximum cost per run you set (Apify run option maxTotalChargeUsd), never above it.

Contracts for agents

Public contract checked 2026-11-11. Active build: 1.0.8. Refresh live details before a large or recurring run.