# Airbnb Reviews Scraper (`scrapeai/airbnb-reviews-scraper`) Actor Collect every review from Airbnb properties with automatic pagination, detailed category ratings, overall star distribution, and host response tracking. - **URL**: https://apify.com/scrapeai/airbnb-reviews-scraper.md - **Developed by:** [ScrapeAI](https://apify.com/scrapeai) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Collect every customer review from Airbnb property listings, including reviewer names, star scores, written feedback, dates, helpfulness metrics, and host reply messages. ### What you can do with this scraper - **All-review extraction for Airbnb listings** — scrape every guest review from a single listing URL - **Capture host interactions** — collect responses from property hosts for sentiment analysis - **Unlimited review pagination** — supports deep crawling across all available review pages - **Enhanced review metadata** — extracts reviewer profiles, timestamps, language, votes, and category ratings - **Listing performance metrics** — retrieves star breakdowns and scores for cleanliness, check-in, communication, and more ### Who is this for? - **Airbnb property owners** — evaluate listing performance and guest sentiment against local competitors - **Vacation rental managers** — collect and organize reviews from multiple properties in a single export - **Research professionals** — examine hospitality trends, guest expectations, and review sentiment patterns - **Travel journalists and bloggers** — use guest feedback to create data-driven travel content and recommendations ### Example input ```json { "productUrls": [ "https://www.airbnb.com/rooms/1104883308160967951" ], "maxReviewsPerListing": 1 } ```` ### Example output ```json { "listingUrl": "https://www.airbnb.com/rooms/1104883308160967951", "listingTitle": "Parisian getaway in the heart of Montmartre!", "overallRating": 4.97, "totalReviewCount": 95, "starDistribution": { "5_star": 97, "4_star": 3, "3_star": 0, "2_star": 0, "1_star": 0 }, "categoryRatings": { "cleanliness": 5, "accuracy": 5, "checkIn": 5, "communication": 5, "location": 4.9, "value": 4.9 }, "reviewIndex": 6, "authorName": "Bob-Shevawn", "authorInfo": "Franklin, Tennessee", "authorAvatar": "https://a0.muscache.com/im/pictures/user/User/original/62904214-beb7-4f2f-af9e-e3493491f8d6.jpeg?im_w=720", "rating": 5, "date": "March 2026", "stayType": "Stayed a few nights", "reviewText": "Yuna was a great place to stay in Montmartre! It was updated and clean. The bed was on the firm side but comfortable. The staff was extremely helpful and friendly. The luggage storage for before and after the trip was super easy to use. I highly recommend this place if you go to Paris.", "hostResponse": "Hello,\nThank you very much for your wonderful review. We are delighted to hear that you enjoyed your stay at Yuna Montmartre and appreciated the cleanliness, the comfort of the apartment, and the friendliness of our team.\nWe’re also glad that the luggage storage was convenient for you before and after your stay. Your recommendation truly means a lot to us.\nWe hope to have the pleasure of welcoming you again on your next visit to Paris.\nBest regards,\nManon - Yuna Team" } ``` # Actor input Schema ## `productUrls` (type: `array`): Airbnb listing URLs to scrape reviews from (e.g. https://www.airbnb.com/rooms/12345). ## `maxReviewsPerListing` (type: `integer`): Maximum number of reviews to scrape per listing. Set 0 for all reviews. ## `includeHostResponses` (type: `boolean`): If true, include the host's response for each review (if any). ## `proxyConfiguration` (type: `object`): Proxy configuration for the scraper. ## Actor input object example ```json { "productUrls": [ "https://www.airbnb.com/rooms/1104883308160967951" ], "maxReviewsPerListing": 0, "includeHostResponses": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "productUrls": [ "https://www.airbnb.com/rooms/1104883308160967951" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeai/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 = { "productUrls": ["https://www.airbnb.com/rooms/1104883308160967951"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapeai/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 '{ "productUrls": [ "https://www.airbnb.com/rooms/1104883308160967951" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scrapeai/airbnb-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeai/airbnb-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Reviews Scraper", "description": "Collect every review from Airbnb properties with automatic pagination, detailed category ratings, overall star distribution, and host response tracking.", "version": "1.0", "x-build-id": "hk3CW4h7zMA6wi7nI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeai~airbnb-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeai-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/scrapeai~airbnb-reviews-scraper/runs": { "post": { "operationId": "runs-sync-scrapeai-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/scrapeai~airbnb-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeai-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", "required": [ "productUrls" ], "properties": { "productUrls": { "title": "Listing URLs", "type": "array", "description": "Airbnb listing URLs to scrape reviews from (e.g. https://www.airbnb.com/rooms/12345).", "items": { "type": "string" } }, "maxReviewsPerListing": { "title": "Max Reviews Per Listing", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per listing. Set 0 for all reviews.", "default": 0 }, "includeHostResponses": { "title": "Include Host Responses", "type": "boolean", "description": "If true, include the host's response for each review (if any).", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy configuration for the scraper." } } }, "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 } } } } } } } } } } ```