# Airbnb Reviews Scraper — Ratings, Comments & Host Replies (`khadinakbar/airbnb-reviews-scraper`) Actor Scrape all reviews for any Airbnb listing — rating, comment, date, reviewer, host response, photos, and topic tags. HTTP-only, MCP-ready. - **URL**: https://apify.com/khadinakbar/airbnb-reviews-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Travel, MCP servers, Real estate - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 review scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Scrape **every review for any Airbnb listing** — star rating, full comment text, review date, reviewer name + location, Superhost flag, the host's public reply, review photos, and topic tags. Give it a listing URL or a room ID and get back one clean JSON record per review. HTTP-only, fast, and built to be called by AI agents (MCP-ready). ### What it does For each Airbnb listing you provide, this actor pulls the complete public review history straight from Airbnb's own review API and returns it as structured data. No browser automation, no login, no cookies — just reliable, paginated JSON. ### When to use it - **Sentiment & topic analysis** — feed thousands of guest reviews into an LLM or sentiment model. - **Competitor & market research** — compare review volume, ratings, and recurring complaints across listings. - **Property management QA** — monitor what guests say about your portfolio and how hosts respond. - **Academic / data science** — build datasets of hospitality reviews at scale. - **AI agents** — a single listing URL in, structured reviews out, with predictable per-review pricing. **Not** for: Airbnb search/result pages, Experiences, or host profile data. For listing prices, amenities, and host metadata use the companion [Airbnb Scraper](https://apify.com/khadinakbar/airbnb-scraper). ### Output One record per review: | Field | Description | |-------|-------------| | `listingId` | Numeric Airbnb room ID | | `listingUrl` | Listing URL | | `listingTitle` | Listing/room title | | `listingReviewsCount` | Total public reviews on the listing | | `reviewId` | Unique review ID | | `rating` | Star rating 1–5 | | `comments` | Full original review text | | `localizedReview` | Airbnb auto-translated text (when available) | | `language` | Review language code | | `createdAt` | Review date (ISO 8601) | | `localizedDate` | Human date ("1 week ago") | | `reviewerId` | Reviewer's user ID | | `reviewerName` | Reviewer first name | | `reviewerLocation` | Reviewer geographic location (when Airbnb shows a place) | | `reviewerTenure` | Reviewer account tenure when shown instead of a location (e.g. "2 months on Airbnb") | | `reviewerIsSuperhost` | Whether the reviewer is a Superhost | | `reviewerPictureUrl` | Reviewer profile photo URL | | `reviewerProfileUrl` | Reviewer profile URL | | `hostResponse` | Host's public reply (null if none) | | `hostResponseDate` | When the host replied | | `reviewPhotoUrls` | Array of guest review photo URLs | | `highlightType` | Airbnb review highlight tag | | `channel` | Booking channel | | `scrapedAt` | Scrape timestamp (ISO 8601) | #### Example record ```json { "listingId": "20669368", "listingUrl": "https://www.airbnb.com/rooms/20669368", "listingTitle": "Cosy Cotswold Cabin", "listingReviewsCount": 308, "reviewId": "1701461540622642748", "rating": 5, "comments": "Our stay here was superb. The cabin was lovely, very clean and stylish...", "language": "en", "createdAt": "2026-06-05T13:40:21Z", "localizedDate": "1 week ago", "reviewerName": "Gabriella", "reviewerLocation": "London, United Kingdom", "reviewerIsSuperhost": false, "hostResponse": null, "reviewPhotoUrls": [], "scrapedAt": "2026-06-18T09:00:00Z" } ```` ### Pricing **Pay-per-event:** - **Actor start:** $0.00005 per run - **Review scraped:** $0.004 per review A listing with 100 reviews costs about **$0.40**. Use **Max reviews per listing** to cap spend exactly — it also limits how many reviews are billed. ### Input | Field | Type | Description | |-------|------|-------------| | `listingUrls` | array | Airbnb listing URLs (e.g. `https://www.airbnb.com/rooms/20669368`) | | `listingIds` | array | Numeric room IDs (alternative to URLs) | | `maxReviewsPerListing` | integer | Cap per listing; `0` = all reviews. Default `100` | | `sortBy` | enum | `MOST_RECENT`, `RATING_DESC` (highest first), `RATING_ASC` (lowest first) | | `language` | string | Locale for dates/translations. Default `en` | | `includeHostResponse` | boolean | Include host replies. Default `true` | | `proxyConfiguration` | object | Defaults to Apify Datacenter (US) | #### Example input ```json { "listingUrls": ["https://www.airbnb.com/rooms/20669368"], "maxReviewsPerListing": 100, "sortBy": "MOST_RECENT", "includeHostResponse": true } ``` ### Usage #### Apify API (JavaScript) ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('khadinakbar/airbnb-reviews-scraper').call({ listingUrls: ['https://www.airbnb.com/rooms/20669368'], maxReviewsPerListing: 200, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Apify API (Python) ```python from apify_client import ApifyClient client = ApifyClient("YOUR_TOKEN") run = client.actor("khadinakbar/airbnb-reviews-scraper").call(run_input={ "listingUrls": ["https://www.airbnb.com/rooms/20669368"], "maxReviewsPerListing": 200, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` #### MCP (AI agents) Exposed in the Apify MCP server as `khadinakbar/airbnb-reviews-scraper`. An agent passes a listing URL and gets structured reviews back, billed per review. ### FAQ **How many reviews can it get?** All public reviews on a listing — listings with thousands of reviews are paginated automatically. **Do I need cookies or a login?** No. It uses Airbnb's public review API. No account, no cookies. **Can I scrape multiple listings at once?** Yes — pass many URLs/IDs. Reviews are de-duplicated by review ID. **What proxies does it use?** Apify datacenter proxies (US) by default, which work reliably against Airbnb's public review API. You can switch to Residential in the proxy settings for very large jobs if needed. **What if a listing has no reviews?** You get a clean, successful run with zero billed reviews for that listing. ### Legal & compliance This actor collects only **publicly available** review data. It does not access private data or bypass authentication. You are responsible for using the data in compliance with Airbnb's Terms of Service, applicable laws (including GDPR/CCPA where relevant), and for any further processing of personal data contained in reviews. Use for lawful purposes only. # Actor input Schema ## `listingUrls` (type: `array`): List of Airbnb listing (room) page URLs to scrape reviews from (e.g. 'https://www.airbnb.com/rooms/20669368'). Accepts full URLs with or without query parameters; the room ID is extracted automatically. Use this OR 'Listing IDs' — provide at least one. This is NOT for search/results pages or experience URLs, only individual stay listings. ## `listingIds` (type: `array`): Numeric Airbnb room IDs as an alternative to full URLs (e.g. '20669368'). Each ID is the number after '/rooms/' in a listing URL. Use this OR 'Airbnb listing URLs'. NOT a host ID, review ID, or experience ID — only stay-listing room IDs. ## `maxReviewsPerListing` (type: `integer`): Maximum number of reviews to scrape per listing, newest-first by default. Set to 0 to scrape ALL available reviews for each listing. Defaults to 100. Each scraped review is billed, so this also caps your cost per listing. ## `sortBy` (type: `string`): Order in which reviews are fetched. 'MOST\_RECENT' returns newest first (default), 'RATING\_DESC' highest-rated first, 'RATING\_ASC' lowest-rated first. Affects which reviews you get when 'Max reviews per listing' is below the listing's total. ## `language` (type: `string`): ISO locale used for localized review dates and Airbnb auto-translations (e.g. 'en', 'es', 'fr', 'de'). Original review text is always returned in 'comments'; the translated text, when available, is returned in 'localizedReview'. Defaults to 'en'. ## `includeHostResponse` (type: `boolean`): When enabled, includes the host's public reply to each review in the 'hostResponse' field (null when the host did not reply). Disable to keep output smaller and cheaper to process. Defaults to true. ## `proxyConfiguration` (type: `object`): Proxy settings used to reach Airbnb. Defaults to Apify datacenter proxies in the US, which work reliably against Airbnb's public review API. If you have access to Residential proxies and hit rate limits on very large jobs, you can switch to them here. ## Actor input object example ```json { "listingUrls": [ "https://www.airbnb.com/rooms/20669368" ], "listingIds": [ "20669368" ], "maxReviewsPerListing": 100, "sortBy": "MOST_RECENT", "language": "en", "includeHostResponse": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `reviews` (type: `string`): All reviews scraped across the provided Airbnb listings. # 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 = { "listingUrls": [ "https://www.airbnb.com/rooms/20669368" ], "maxReviewsPerListing": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/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 = { "listingUrls": ["https://www.airbnb.com/rooms/20669368"], "maxReviewsPerListing": 100, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/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 '{ "listingUrls": [ "https://www.airbnb.com/rooms/20669368" ], "maxReviewsPerListing": 100 }' | apify call khadinakbar/airbnb-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/airbnb-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Reviews Scraper — Ratings, Comments & Host Replies", "description": "Scrape all reviews for any Airbnb listing — rating, comment, date, reviewer, host response, photos, and topic tags. HTTP-only, MCP-ready.", "version": "0.1", "x-build-id": "uE3hFa0EE4UVzUxNu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~airbnb-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~airbnb-reviews-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~airbnb-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": { "listingUrls": { "title": "Airbnb listing URLs", "type": "array", "description": "List of Airbnb listing (room) page URLs to scrape reviews from (e.g. 'https://www.airbnb.com/rooms/20669368'). Accepts full URLs with or without query parameters; the room ID is extracted automatically. Use this OR 'Listing IDs' — provide at least one. This is NOT for search/results pages or experience URLs, only individual stay listings.", "items": { "type": "string" } }, "listingIds": { "title": "Listing IDs", "type": "array", "description": "Numeric Airbnb room IDs as an alternative to full URLs (e.g. '20669368'). Each ID is the number after '/rooms/' in a listing URL. Use this OR 'Airbnb listing URLs'. NOT a host ID, review ID, or experience ID — only stay-listing room IDs.", "items": { "type": "string" } }, "maxReviewsPerListing": { "title": "Max reviews per listing", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to scrape per listing, newest-first by default. Set to 0 to scrape ALL available reviews for each listing. Defaults to 100. Each scraped review is billed, so this also caps your cost per listing.", "default": 100 }, "sortBy": { "title": "Sort order", "enum": [ "MOST_RECENT", "RATING_DESC", "RATING_ASC" ], "type": "string", "description": "Order in which reviews are fetched. 'MOST_RECENT' returns newest first (default), 'RATING_DESC' highest-rated first, 'RATING_ASC' lowest-rated first. Affects which reviews you get when 'Max reviews per listing' is below the listing's total.", "default": "MOST_RECENT" }, "language": { "title": "Language / locale", "type": "string", "description": "ISO locale used for localized review dates and Airbnb auto-translations (e.g. 'en', 'es', 'fr', 'de'). Original review text is always returned in 'comments'; the translated text, when available, is returned in 'localizedReview'. Defaults to 'en'.", "default": "en" }, "includeHostResponse": { "title": "Include host responses", "type": "boolean", "description": "When enabled, includes the host's public reply to each review in the 'hostResponse' field (null when the host did not reply). Disable to keep output smaller and cheaper to process. Defaults to true.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings used to reach Airbnb. Defaults to Apify datacenter proxies in the US, which work reliably against Airbnb's public review API. If you have access to Residential proxies and hit rate limits on very large jobs, you can switch to them here.", "default": { "useApifyProxy": true, "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 } } } } } } } } } } ```