Airbnb Reviews Scraper

Extract public reviews from one or more Airbnb listing URLs. The Actor opens Airbnb's reviews route in a real browser, follows the reviews panel's incremental loading, and falls back to public JSON-LD when browser extraction is unavailable.

What it returns

Each review record can include:

• Listing context: ID, URL, title, accommodation type, location, capacity, bedrooms, beds, bathrooms, description, cover image, amenity count, overall rating, category ratings, and star distribution.
• Reviewer context: display name, public profile URL and ID, location or Airbnb tenure, and avatar URL.
• Review content: stable review ID when exposed, rating, displayed date, stay type, full text, and one-based result position.
• Host response context: response text, response author/profile, response date, and a hasHostResponse flag.
• Provenance: pageType, found, extractionMethod, fallbackMode, and scrapedAt.

The dataset contains review rows only. A machine-readable OUTPUT key reports success, verified empty results, limits, fallback use, and sanitized failures. Unverifiable empty or blocked runs fail explicitly.

Input options

Field	Type	Default	Description
productUrls	array of strings	—	Required Airbnb /rooms/<id> listing URLs.
maxReviewsPerListing	integer	0	Maximum reviews per listing. 0 means no per-listing cap.
maxTotalReviews	integer	0	Overall review cap across all listing URLs.
includeHostResponses	boolean	true	Include host response fields when available.
includeListingMetadata	boolean	true	Include extended listing and host context.
includeReviewerDetails	boolean	true	Include public reviewer profile, location/tenure, and avatar fields.
reviewSearch	string	""	Optional phrase entered into Airbnb's “Search all reviews” control.
reviewSort	enum	BEST_QUALITY	BEST_QUALITY, MOST_RECENT, HIGHEST_RATED, or LOWEST_RATED.
maxConcurrency	integer	2	Browser concurrency from 1 to 5.
maxRequestRetries	integer	1	Crawlee retries for failed listing requests.
requestDelayMs	integer	0	Delay before processing each listing, from 0 to 10,000 ms.
requestTimeoutSecs	integer	60	Listing/reviews navigation timeout, from 15 to 180 seconds.
saveDebugHtml	boolean	false	Opt in to saving debug-<listing>.html when the reviews panel cannot be opened.
proxyConfiguration	object	Residential	Proxy used consistently by the browser and HTTP fallback.

maxItems is also accepted as a backwards-compatible alias for maxTotalReviews.

Example input

{
  "productUrls": [
    "https://www.airbnb.com/rooms/1234567890123456789"
  ],
  "maxReviewsPerListing": 25,
  "maxTotalReviews": 100,
  "includeHostResponses": true,
  "reviewSort": "MOST_RECENT",
  "reviewSearch": "clean",
  "maxConcurrency": 1,
  "saveDebugHtml": false
}

Example output

{
  "listingId": "1234567890123456789",
  "listingUrl": "https://www.airbnb.com/rooms/1234567890123456789",
  "listingTitle": "Example apartment near the city center",
  "listingType": "Entire apartment",
  "location": "Example City, Example Country",
  "overallRating": 4.87,
  "totalReviewCount": 128,
  "categoryRatings": {
    "cleanliness": 4.9,
    "accuracy": 4.8,
    "checkIn": 4.9,
    "communication": 4.9,
    "location": 4.7,
    "value": 4.6
  },
  "reviewIndex": 1,
  "reviewId": "9876543210987654321",
  "authorName": "Example Reviewer",
  "reviewerLocation": "Example City, Example Country",
  "reviewerUrl": "https://www.airbnb.com/users/profile/123456789",
  "rating": 5,
  "date": "January 2026",
  "stayType": "Stayed a few nights",
  "reviewText": "The apartment was clean, comfortable, and close to public transport.",
  "hasHostResponse": true,
  "hostResponse": "Thank you for your thoughtful feedback. We hope to welcome you again.",
  "source": "Airbnb listing reviews",
  "pageType": "review",
  "found": true,
  "extractionMethod": "playwright_dom",
  "fallbackMode": "browser",
  "scrapedAt": "2026-01-15T12:00:00.000Z"
}

Notes

• Only public Airbnb pages are requested with bounded retries and pacing. The configured proxy is applied consistently; login, CAPTCHA solving, and access-control bypasses are not attempted. CAPTCHA/access-denied/rate-limit responses fail closed and are summarized in OUTPUT.
• Airbnb may expose translated or relative date text; date preserves the text shown on the page.
• Debug HTML is stored in the default key-value store only when saveDebugHtml is enabled and browser extraction fails.
• Every dataset row is a verified pageType: "review" record with a reviewer name and review text.