# Airbnb Reviews Scraper (`fetch_cat/airbnb-reviews-scraper`) Actor Extract public Airbnb reviews, reviewer details, ratings, dates, host responses, and listing context from room URLs for STR research. - **URL**: https://apify.com/fetch\_cat/airbnb-reviews-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Travel, Real estate, Automation - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.03 / 1,000 review saveds 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 Extract public guest reviews from Airbnb listing URLs. Add one or more room URLs and get structured review text, dates, reviewer metadata, listing ratings, review counts, languages, and host responses when Airbnb makes them public. ### Ready-to-run examples - [Build Airbnb Review Dataset For Analysis](https://apify.com/fetch_cat/airbnb-reviews-scraper/examples/build-airbnb-review-dataset-for-analysis) - [Compare Airbnb Reviews For Two Listings](https://apify.com/fetch_cat/airbnb-reviews-scraper/examples/compare-airbnb-reviews-for-two-listings) - [Scrape Recent Airbnb Listing Reviews](https://apify.com/fetch_cat/airbnb-reviews-scraper/examples/scrape-recent-airbnb-listing-reviews) [View all ready-to-run examples](https://apify.com/fetch_cat/airbnb-reviews-scraper/examples) ### What does Airbnb Reviews Scraper do? Airbnb Reviews Scraper turns public Airbnb room pages into clean review datasets. It is built for teams that need recurring guest feedback, reputation monitoring, competitor research, or market intelligence without copying reviews by hand. The actor accepts Airbnb room URLs such as `https://www.airbnb.com/rooms/20669368` and saves one dataset item per review. ### Who is it for? - 🏡 Property managers tracking guest sentiment across their own listings. - 📊 Short-term rental analysts comparing competing stays in a destination. - ⭐ Reputation teams monitoring recent public guest feedback. - 🧭 Hospitality researchers building review datasets for market studies. - 🤖 Automation teams feeding reviews into BI, CRM, or AI workflows. ### Why use this actor? - Saves structured review rows instead of screenshots or copied text. - Includes listing context with every review for easy exports. - Supports multiple Airbnb URLs in one run. - Lets you cap reviews per listing to control run size and cost. - Filters saved reviews by date, rating, or a keyword without changing the original review data. - Saves a run summary and a resumable pending-listing checkpoint when time runs short. - Works through Apify datasets, API, webhooks, integrations, and MCP. ### Output fields | JSON key | Label | Type | Description | | --- | --- | --- | --- | | `listingUrl` | ListingUrl | string | Output field for listingurl. | | `listingId` | ListingId | string | Output field for listingid. | | `listingTitle` | ListingTitle | string / null | Output field for listingtitle. | | `overallRating` | OverallRating | number / null | Output field for overallrating. | | `reviewCount` | ReviewCount | integer / null | Output field for reviewcount. | | `reviewId` | ReviewId | string | Output field for reviewid. | | `reviewerName` | ReviewerName | string / null | Output field for reviewername. | | `reviewerProfileUrl` | ReviewerProfileUrl | string / null | Output field for reviewerprofileurl. | | `reviewerLocation` | ReviewerLocation | string / null | Output field for reviewerlocation. | | `reviewDate` | ReviewDate | string / null | Output field for reviewdate. | | `rating` | Rating | number / null | Output field for rating. | | `language` | Language | string / null | Output field for language. | | `text` | Text | string | Output field for text. | | `translatedText` | TranslatedText | string / null | Output field for translatedtext. | | `responseText` | ResponseText | string / null | Output field for responsetext. | | `responseDate` | ResponseDate | string / null | Output field for responsedate. | | `scrapedAt` | ScrapedAt | string | Output field for scrapedat. | ### Pricing This Actor uses Apify pay-per-event pricing. A one-time start event is charged when the run begins; a review event is charged only for each review row saved to the dataset. The exact discount tier depends on your Apify plan or agreement. | Event | What is charged | Price | | --- | --- | ---: | | `start` | One-time run start | $0.005 | | `item` — Free | Saved review row | $0.000031745 each ($0.031745 / 1,000) | | `item` — Starter / Bronze | Saved review row | $0.000027604 each ($0.027604 / 1,000) | | `item` — Scale / Silver | Saved review row | $0.000021531 each ($0.021531 / 1,000) | | `item` — Business / Gold | Saved review row | $0.000016563 each ($0.016563 / 1,000) | | `item` — Platinum | Saved review row | $0.000011042 each ($0.011042 / 1,000) | | `item` — Diamond | Saved review row | $0.0000077292 each ($0.0077292 / 1,000) | Apify may also charge platform usage for compute, storage, proxies, or data transfer outside this Actor pricing. Check the Actor run and the Apify Pricing tab for the exact cost shown to your account. ### Quick start 1. Open the actor on Apify. 2. Paste one or more Airbnb room URLs into **Airbnb listing URLs**. 3. Set **Maximum reviews per listing**. 4. Run the actor. 5. Download results from the dataset as JSON, CSV, Excel, XML, or HTML. ### Input ```json { "startUrls": [ { "url": "https://www.airbnb.com/rooms/20669368" } ], "maxReviewsPerListing": 10, "sort": "default", "proxyConfiguration": { "useApifyProxy": true } } ``` ### Input settings | Setting | JSON key | Type / default | Description | | --- | --- | --- | --- | | Airbnb listing URLs | `startUrls` | array, default `[{"url":"https://www.airbnb.com/rooms/20669368"}]` | Public Airbnb room/listing URLs such as https://www.airbnb.com/rooms/20669368. | | Maximum reviews per listing | `maxReviewsPerListing` | integer, default `25` | How many guest reviews to save for each Airbnb listing URL. | | Review sort order | `sort` | string, default `"default"` | Use Airbnb's default order or request recent reviews when available. | | Only reviews on or after | `dateFrom` | optional `YYYY-MM-DD` | Save reviews on or after this inclusive date. | | Only reviews on or before | `dateTo` | optional `YYYY-MM-DD` | Save reviews on or before this inclusive date. | | Minimum / maximum review rating | `minRating`, `maxRating` | optional integer, 1–5 | Save only review rows inside the inclusive star-rating range. | | Review keyword | `keyword` | optional string | Save rows whose review, Airbnb translation, or host reply contains the phrase. | | Resume pending listing URLs | `resumeListingUrls` | optional array | Continue a time-limited run using URLs from `PENDING_LISTINGS`. | | Run safety limit | `runSafetySeconds` | integer, default `270` | Optional early-stop limit for large batches. Completed rows are saved and remaining URLs are recorded before the Actor shuts down. | | Proxy configuration | `proxyConfiguration` | object, default `{"useApifyProxy":true}` | Optional Apify Proxy settings. Datacenter proxy is usually enough for small public-review runs; use residential only if Airbnb blocks your traffic. | ### Example input ```json { "startUrls": [ { "url": "https://www.airbnb.com/rooms/20669368" } ], "maxReviewsPerListing": 10, "sort": "default", "proxyConfiguration": { "useApifyProxy": true } } ``` ### Output example ```json { "listingUrl": "https://www.airbnb.com/rooms/20669368", "listingId": "20669368", "listingTitle": "Little Country Houses - Finley's Fort + hot tub", "overallRating": 4.9, "reviewCount": 308, "reviewId": "1701461540622642748", "reviewerName": "Gabriella", "reviewerProfileUrl": "https://www.airbnb.com/users/show/755284424", "reviewerLocation": null, "reviewDate": "2026-06-05T13:40:21Z", "rating": null, "language": "en", "text": "Our stay here was Superb...", "translatedText": null, "responseText": null, "responseDate": null, "scrapedAt": "2026-06-26T00:00:00.000Z" } ``` ### Tips for best results - Use direct `/rooms/` URLs. - Start with 5-10 reviews per listing for testing. - Remove duplicate URLs before large runs. - Split very large URL lists into smaller batches. - Review the dataset sample before connecting automation. ### Common workflows #### Reputation monitoring Run the actor weekly on your managed listings and send new rows to your dashboard or spreadsheet. #### Market research Collect reviews from competing listings in the same destination and compare guest language, sentiment, and frequency. #### Guest experience analysis Export text to your NLP or LLM pipeline to classify recurring topics such as cleanliness, check-in, location, host communication, and amenities. ### Integrations Apify datasets connect to: - Google Sheets - Make - Zapier - Webhooks - BigQuery exports - S3-compatible storage - Custom API clients ### API usage Run Airbnb Reviews Scraper from your own code with the Apify API. **Node.js** ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const input = { "startUrls": [ { "url": "https://www.airbnb.com/rooms/20669368" } ], "maxReviewsPerListing": 10, "sort": "default", "proxyConfiguration": { "useApifyProxy": true } }; const run = await client.actor('fetch_cat/airbnb-reviews-scraper').call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` **Python** ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ["APIFY_TOKEN"]) run = client.actor("fetch_cat/airbnb-reviews-scraper").call(run_input={ "startUrls": [ { "url": "https://www.airbnb.com/rooms/20669368" } ], "maxReviewsPerListing": 10, "sort": "default", "proxyConfiguration": { "useApifyProxy": true } }) items = client.dataset(run["defaultDatasetId"]).list_items().items print(items) ``` **cURL** ```bash curl -X POST "https://api.apify.com/v2/acts/fetch_cat~airbnb-reviews-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"startUrls":[{"url":"https://www.airbnb.com/rooms/20669368"}],"maxReviewsPerListing":10,"sort":"default","proxyConfiguration":{"useApifyProxy":true}}' ``` ### Use with AI agents via MCP Airbnb Reviews Scraper can be used by AI assistants through the hosted Apify MCP server. **Claude Code setup** ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=fetch_cat/airbnb-reviews-scraper" ``` **Claude Desktop, Cursor, or VS Code JSON config** ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=fetch_cat/airbnb-reviews-scraper" } } } ``` **Example prompts** - "Run Airbnb Reviews Scraper with this input JSON and summarize the dataset." - "Export the latest Airbnb Reviews Scraper results to a table I can review." - "Schedule this Actor for monitoring and tell me what changed between runs." ### Data quality notes Airbnb may not expose every field for every review. For example, per-review star ratings, reviewer location, translated text, or host response can be missing. Missing fields are returned as `null` rather than invented. ### Limitations - Supports public Airbnb room/listing pages only. - Does not access private account data. - Does not bypass login-only, CAPTCHA, or blocked pages. - Availability, prices, and booking calendars are outside this actor's scope. ### Legality Use Airbnb Reviews Scraper responsibly and only for data you are allowed to process. ### Legal and responsible use This actor is intended for public web data. Review Airbnb's terms, privacy requirements, and applicable laws before using scraped data. Do not use the output for spam, harassment, or discriminatory decisions. ### FAQ #### Can it scrape private reviews? No. It only extracts publicly visible review data from public Airbnb listing pages. #### Why are some fields null? Airbnb does not expose every review attribute on every listing. The actor keeps the row and leaves unavailable values as `null`. #### Can I scrape many listings at once? Yes. Add multiple room URLs and set a reasonable per-listing review cap. For large batches, use smaller chunks. #### What if a listing was removed? Removed, private, or blocked listings may return an HTTP error. Check the run log for the affected URL. #### Does it support API and MCP automation? Yes. You can call the actor through the Apify API, schedule it, connect webhooks, or run it via Apify MCP. ### Related actors - [Agoda Reviews Scraper](https://apify.com/fetch_cat/agoda-reviews-scraper) - [Airbnb Listings Scraper](https://apify.com/fetch_cat/airbnb-listings-scraper) - [Apple Maps Places Scraper](https://apify.com/fetch_cat/apple-maps-places-scraper) - [Trip.com Hotels Scraper](https://apify.com/fetch_cat/trip-com-hotels-scraper) - [Agoda Hotels Scraper](https://apify.com/fetch_cat/agoda-hotels-scraper) ### Support Report bugs, wrong output, blocked runs, or missing fields from the Actor page. Include the Apify run ID or run URL, your input JSON, what you expected, what the Actor returned, and one reproducible public URL so the issue can be tested quickly. ### Privacy and data handling This Actor only requests the permissions needed to run the input you provide. It uses your input (such as URLs, search terms, identifiers, filters, and limits) only to fetch the requested public data from the relevant source site or API for this Actor, then writes results to your Apify dataset/key-value store. Data may pass through Apify platform services and Apify Proxy during the run, and requests are sent only to the target site or public data provider required for this Actor's results. FetchCat does not send your inputs or outputs to advertising networks, data brokers, or model-training services, and does not retain run data outside Apify storage after the run except when you explicitly share run details for transient support debugging. You are responsible for using this Actor lawfully, respecting the target site's terms, and avoiding unnecessary personal or sensitive data in inputs. Review the output before storing, sharing, or combining it with other data. # Actor input Schema ## `startUrls` (type: `array`): Public Airbnb room/listing URLs such as https://www.airbnb.com/rooms/20669368. ## `maxReviewsPerListing` (type: `integer`): How many guest reviews to save for each Airbnb listing URL. ## `sort` (type: `string`): Use Airbnb's default order or request recent reviews when available. ## `dateFrom` (type: `string`): Optional inclusive ISO date (YYYY-MM-DD). Useful for collecting new reviews in scheduled runs. ## `dateTo` (type: `string`): Optional inclusive ISO date (YYYY-MM-DD). ## `minRating` (type: `integer`): Optional minimum per-review star rating to save. ## `maxRating` (type: `integer`): Optional maximum per-review star rating to save. ## `keyword` (type: `string`): Optional word or phrase that must appear in the review, its Airbnb translation, or the host response. ## `resumeListingUrls` (type: `array`): Optional continuation URLs from the PENDING\_LISTINGS record after a time-limited run. Normal runs do not need this field. ## `runSafetySeconds` (type: `integer`): Optional early-stop limit for larger batches. The Actor saves completed review rows and a PENDING\_LISTINGS checkpoint before this limit, leaving time for clean shutdown. ## `proxyConfiguration` (type: `object`): Optional Apify Proxy settings. Datacenter proxy is usually enough for small public-review runs; use residential only if Airbnb blocks your traffic. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.airbnb.com/rooms/20669368" } ], "maxReviewsPerListing": 10, "sort": "default", "runSafetySeconds": 270, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `runSummary` (type: `string`): No description ## `pendingListings` (type: `string`): No description # 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 = { "startUrls": [ { "url": "https://www.airbnb.com/rooms/20669368" } ], "maxReviewsPerListing": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/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 = { "startUrls": [{ "url": "https://www.airbnb.com/rooms/20669368" }], "maxReviewsPerListing": 10, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/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 '{ "startUrls": [ { "url": "https://www.airbnb.com/rooms/20669368" } ], "maxReviewsPerListing": 10 }' | apify call fetch_cat/airbnb-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/airbnb-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/9JtqHelNzhr3DlUjU/builds/CiNWgsmJKX3gXoc5l/openapi.json