# Airbnb Reviews Scraper — Ratings, Sentiment & Insights (`malikgen/airbnb-reviews-scraper`) Actor Scrape Airbnb reviews by city, URL, or ID — text, ratings, dates, reviewer & host, host replies, media, trip type, plus free sentiment and a per-listing insights rollup (category ratings, top keywords, response rate). Part of the Airbnb suite (Search, Listing Details, Revenue Calculator). - **URL**: https://apify.com/malikgen/airbnb-reviews-scraper.md - **Developed by:** [Malik Mazhar Ali](https://apify.com/malikgen) (community) - **Categories:** Travel, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $2.60 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Airbnb Reviews Scraper — Ratings, Sentiment & Insights Export every guest review from any Airbnb listing — **or an entire city** — with full text, ratings, dates, reviewer details, host replies, photos, trip type, and language. Then go further than any other scraper: **built-in sentiment, aspect tags, and a per-listing insights rollup** (category sub-ratings, rating distribution, top keywords, review velocity, host-response rate). All in clean, stable JSON. > 🏠 **Part of the Airbnb suite** — works alongside the **[Airbnb Search Scraper](https://apify.com/malikgen/airbnb-scraper)**, **[Listing Details Scraper](https://apify.com/malikgen/airbnb-listing-details)**, and **[Revenue & Occupancy Calculator](https://apify.com/malikgen/airbnb-revenue-calculator)**. --- ### Why this one — more data, ~20% cheaper | Capability | Typical Airbnb review scrapers | **This actor** | |---|:---:|:---:| | Review text, rating, date | ✅ | ✅ | | Reviewer name & photo | ✅ | ✅ | | Reviewer **location** | partial | ✅ (cleaned) | | Reviewer **tenure** ("4 years on Airbnb") | ❌ | ✅ | | Host reply + host details | ✅ | ✅ | | Review **photos / media** | some | ✅ | | **Trip type** (group, family, solo…) | ❌ | ✅ | | Language + localized text | some | ✅ | | **Sentiment + score** (free, no API key) | rare/opt-in | ✅ default | | **Aspect tags** (cleanliness, location…) | ❌ | ✅ | | **Scrape by CITY** (no URLs needed) | ❌ **nobody** | ✅ | | **Per-listing insights rollup** | ❌ **nobody** | ✅ | | ↳ category sub-ratings (6) | ❌ | ✅ | | ↳ rating distribution (5★→1★) | ❌ | ✅ | | ↳ sentiment split % | ❌ | ✅ | | ↳ top positive / negative keywords | ❌ | ✅ | | ↳ review velocity & host-response rate | ❌ | ✅ | | Price per 1,000 reviews (Bronze) | ~$4.10 (market leader) | **~$3.30** | **~15 data dimensions vs the usual ~8 — for less money.** Reliable by design (residential proxy + Airbnb's own reviews API, paginated). --- ### Quick start Pick **any one** input: - **City** — type `Austin, TX` (we auto-find the top listings and scrape their reviews). *No URLs required — unique to this actor.* - **Listing URLs** — paste `https://www.airbnb.com/rooms/`. - **Listing IDs** — paste numeric IDs. Then set **Max reviews per listing** (0 = all), **Sort** (most recent / relevant / highest / lowest), optional **Since date** for incremental runs, and **Start**. --- ### Input | Field | Type | Description | |---|---|---| | `location` | string | City to scrape (auto-finds listings). | | `listingUrls` | array | Airbnb room URLs. | | `listingIds` | array | Numeric listing IDs. | | `maxListings` | integer | City mode: how many listings (default 10). | | `maxReviewsPerListing` | integer | Per listing; 0 = all (default 100). | | `sortBy` | enum | `most-recent` / `most-relevant` / `highest-rated` / `lowest-rated`. | | `sinceDate` | string | Only reviews on/after `YYYY-MM-DD` (great for incremental). | | `locale` | enum | Language/region for localized text. | | `includeInsights` | boolean | Add the per-listing rollup (default true, free). | | `webhookUrl` | string | POST results when the run finishes. | | `proxyConfiguration` | object | Residential (US) by default — recommended. | Provide at least one of `location`, `listingUrls`, or `listingIds`. --- ### Output Two record types in one dataset (filter on `recordType`): **`review`** — one per guest review: `reviewId, rating, comment, localizedComment, language, date (ISO) + dateFormatted, reviewerName, reviewerLocation, reviewerTenure, reviewerPhotoUrl, hostReply, hostName, tripType, reviewHighlight, highlightedSentences[], media[], sentiment, sentimentScore, aspects[], listingId, listingUrl, scrapedAt`. **`listing_insights`** — one per listing (when `includeInsights`): `totalReviewsAvailable, reviewsAnalyzed, avgRating, categoryRatings{cleanliness,accuracy,check-in,communication,location,value}, ratingDistribution{5..1}, sentimentSplitPct{positive,neutral,negative}, topPositiveKeywords[], topNegativeKeywords[], languagesBreakdown, hostResponseRatePct, reviewsPerMonth, firstReviewDate, lastReviewDate`. All fields always present (`null`/empty when unavailable). Full sample: [`docs/example-output-reviews.json`](docs/example-output-reviews.json). --- ### Run via API ```bash curl -X POST "https://api.apify.com/v2/acts/malikgen~airbnb-reviews-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"listingUrls":["https://www.airbnb.com/rooms/12937"],"maxReviewsPerListing":100}' ```` Works with the Apify clients, n8n, Make, and Zapier. Set `webhookUrl` to push results into your workflow. *** ### Pricing Pay per review (set in Console). Headline **≈ $3.30 / 1,000 reviews** (Bronze) — about **20% under the market leader**, with more fields. The per-listing insights rollup is **included free**. *** ### FAQ **Can I really scrape a whole city?** Yes — enter a city and we find the listings and pull their reviews automatically. No other Airbnb reviews scraper does this. **Do I need an API key for sentiment?** No. Sentiment, scores, and aspect tags are computed in-actor at no extra cost. **How do incremental runs work?** Set `sortBy: most-recent` + `sinceDate` — only newer reviews are returned. Pair with `webhookUrl` for ongoing reputation monitoring. **Why residential proxy?** Airbnb is Cloudflare-protected and reviews load via a warmed session. Leave the default proxy on. *** ### 🏠 The Airbnb suite | Actor | Use it for | |---|---| | **[Airbnb Search Scraper](https://apify.com/malikgen/airbnb-scraper)** | Find listings by city — price, rating, coordinates, superhost. | | **[Airbnb Listing Details Scraper](https://apify.com/malikgen/airbnb-listing-details)** | Full property detail from URLs — description, amenities, host, photos. | | **[Airbnb Revenue & Occupancy Calculator](https://apify.com/malikgen/airbnb-revenue-calculator)** | Occupancy %, ADR, estimated revenue — the AirDNA alternative. | | **Airbnb Reviews Scraper** *(this actor)* | Reviews + sentiment + per-listing insights. | *** ### Changelog - **0.1** — Initial release. City / URL / ID input; paginated `StaysPdpReviewsQuery`; per-review sentiment + aspects; per-listing insights rollup (category ratings, distribution, sentiment split, keywords, velocity, response rate); reviewer location/tenure split; incremental `sinceDate`. *** *Not affiliated with, endorsed by, or sponsored by Airbnb. Scrapes publicly available review data for legitimate research, sentiment analysis, and reputation monitoring. Respect Airbnb's Terms of Service and applicable laws.* # Actor input Schema ## `location` (type: `string`): Scrape reviews for the top listings in a whole city — e.g. "Austin, TX", "Lisbon, Portugal". Our unique mode: no URLs needed. Leave blank if you provide listing URLs or IDs. ## `listingUrls` (type: `array`): Airbnb room URLs (https://www.airbnb.com/rooms/). ## `listingIds` (type: `array`): Numeric Airbnb listing IDs (alternative to URLs). ## `maxListings` (type: `integer`): When using a city, how many listings to pull reviews from. ## `maxReviewsPerListing` (type: `integer`): Limit reviews scraped per listing. Set 0 for ALL reviews. ## `sortBy` (type: `string`): Order in which reviews are scraped. ## `sinceDate` (type: `string`): Only scrape reviews on/after this date. Best with sort = Most recent (enables incremental runs). ## `locale` (type: `string`): Language/region for localized review text and dates. ## `includeInsights` (type: `boolean`): Add one summary record per listing: category ratings, rating distribution, sentiment split, top keywords, review velocity, host-response rate. Free. ## `webhookUrl` (type: `string`): POST the full result set here when the run finishes (n8n / Make / Zapier). ## `proxyConfiguration` (type: `object`): Airbnb requires residential proxies. Leave the default (Apify Residential, US). ## Actor input object example ```json { "location": "Austin, TX", "maxListings": 10, "maxReviewsPerListing": 100, "sortBy": "most-recent", "locale": "en", "includeInsights": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `overview` (type: `string`): Key identity, price, rating, and location per listing ## `full` (type: `string`): All fields including amenities, images, host info, and price breakdown # 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 = { "location": "Austin, TX", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("malikgen/airbnb-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 = { "location": "Austin, TX", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("malikgen/airbnb-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "location": "Austin, TX", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call malikgen/airbnb-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=malikgen/airbnb-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Reviews Scraper — Ratings, Sentiment & Insights", "description": "Scrape Airbnb reviews by city, URL, or ID — text, ratings, dates, reviewer & host, host replies, media, trip type, plus free sentiment and a per-listing insights rollup (category ratings, top keywords, response rate). Part of the Airbnb suite (Search, Listing Details, Revenue Calculator).", "version": "0.0", "x-build-id": "7GRPFMcjk68GZJuEE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malikgen~airbnb-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malikgen-airbnb-reviews-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/malikgen~airbnb-reviews-scraper/runs": { "post": { "operationId": "runs-sync-malikgen-airbnb-reviews-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/malikgen~airbnb-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-malikgen-airbnb-reviews-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": { "location": { "title": "City / location (optional)", "type": "string", "description": "Scrape reviews for the top listings in a whole city — e.g. \"Austin, TX\", \"Lisbon, Portugal\". Our unique mode: no URLs needed. Leave blank if you provide listing URLs or IDs." }, "listingUrls": { "title": "Listing URLs", "type": "array", "description": "Airbnb room URLs (https://www.airbnb.com/rooms/).", "items": { "type": "string" } }, "listingIds": { "title": "Listing IDs", "type": "array", "description": "Numeric Airbnb listing IDs (alternative to URLs).", "items": { "type": "string" } }, "maxListings": { "title": "Max listings (city mode)", "minimum": 1, "maximum": 200, "type": "integer", "description": "When using a city, how many listings to pull reviews from.", "default": 10 }, "maxReviewsPerListing": { "title": "Max reviews per listing", "minimum": 0, "type": "integer", "description": "Limit reviews scraped per listing. Set 0 for ALL reviews.", "default": 100 }, "sortBy": { "title": "Sort reviews by", "enum": [ "most-recent", "most-relevant", "highest-rated", "lowest-rated" ], "type": "string", "description": "Order in which reviews are scraped.", "default": "most-recent" }, "sinceDate": { "title": "Only reviews since (YYYY-MM-DD)", "type": "string", "description": "Only scrape reviews on/after this date. Best with sort = Most recent (enables incremental runs)." }, "locale": { "title": "Locale", "enum": [ "en", "en-US", "en-GB", "de-DE", "fr-FR", "es-ES", "it-IT", "pt-BR", "nl-NL", "pl-PL", "ru-RU", "ja-JP", "ko-KR", "zh-CN" ], "type": "string", "description": "Language/region for localized review text and dates.", "default": "en" }, "includeInsights": { "title": "Include per-listing insights rollup", "type": "boolean", "description": "Add one summary record per listing: category ratings, rating distribution, sentiment split, top keywords, review velocity, host-response rate. Free.", "default": true }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "POST the full result set here when the run finishes (n8n / Make / Zapier)." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Airbnb requires residential proxies. Leave the default (Apify Residential, US).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } }, "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 } } } } } } } } } } ```