# Airbnb Reviews Scraper (`crawlio/airbnb-reviews-scraper`) Actor

Extract thousands of Airbnb reviews in seconds for just $0.30 per 1,000 reviews. Collect guest feedback, star ratings, stay dates, and host responses for analytics and AI.

- **URL**: https://apify.com/crawlio/airbnb-reviews-scraper.md
- **Developed by:** [Crawlio](https://apify.com/crawlio) (community)
- **Categories:** Travel, Lead generation, AI
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.30 / 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.
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 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

### What does Airbnb Reviews Scraper do?

Airbnb Reviews Scraper extracts review data from public [Airbnb](https://www.airbnb.com) listing URLs.

Airbnb Reviews Scraper can scrape:

- Review text
- Review author first name
- Review date
- Star rating
- Reviewer location and tenure when available
- Host responses when available
- Total review count
- Rating breakdowns such as cleanliness, accuracy, check-in, communication, location, and value

### Why scrape Airbnb reviews?

Airbnb reviews are useful for hospitality research, guest experience analysis, competitor monitoring, and listing quality checks.

Here are some ways you can use the data:

- Track guest sentiment across one or more listings
- Monitor recurring complaints or praised amenities
- Compare review volume and ratings between competing properties
- Build hospitality datasets for analytics or machine learning
- Audit listing quality and guest experience over time

If you would like more inspiration on how scraping Airbnb could help your business or organization, check out our [industry pages](https://apify.com/industries).

### How to scrape Airbnb reviews

It's easy to scrape Airbnb reviews with Airbnb Reviews Scraper. Just follow these steps:

1. Click on **Try for free**.
2. Select operation:
   - **Reviews** -> fetch paginated review records
   - **Reviews summary** -> fetch review count and rating breakdown
3. Enter one Airbnb room URL or a list of URLs.
4. Click on **Run**.
5. When the Actor has finished, preview or download your data from the **Dataset** tab.

### How much will it cost to scrape Airbnb reviews?

Apify gives you $5 free usage credits every month on the [Apify Free plan](https://apify.com/pricing). The `reviews` operation returns one row per scraped review, so usage scales with the number of reviews you request and the number of reviews Airbnb returns.

For regular review monitoring or larger batches, use an Apify paid plan. See [Apify pricing](https://apify.com/pricing) for current options.

### Results

The `reviews` operation returns one dataset row per scraped review.

Here is a sample review item returned by the Actor:

```json
{
  "url": "https://www.airbnb.com/rooms/992970965790772607",
  "review_offset": 0,
  "author": "Amal",
  "date": "2026-05-04",
  "text": "Had a very nice stay here; Lily was helpful and friendly. The room was clean and was tidied daily. I would recommend Lily as a host.",
  "star_rating": "5",
  "reviewer_location": "N/A",
  "reviewer_tenure": "10 years on Airbnb",
  "stay_type": "N/A",
  "avatar_url": "https://a0.muscache.com/im/pictures/user/3e441f05-ab47-49e8-a3b2-773b388dfb08.jpg"
}
```

### Supported operations

The Actor supports two operations:

- `reviews` -> fetch review records from one or more Airbnb listing URLs
- `reviews_summary` -> fetch total review count and rating breakdown

***

#### Reviews

Use this operation when you need individual review records.

The dataset contains one row per review. For example, `limit: 500` can return up to 500 rows for each listing URL. Leave `limit` empty to scrape all available reviews.

**Limit:** Optional. Actual returned reviews may be lower if the listing has fewer reviews or Airbnb stops pagination earlier.

**Example input:**

```json
{
  "operation": "reviews",
  "reviews": {
    "url": "https://www.airbnb.com/rooms/992970965790772607",
    "offset": 0,
    "limit": 20
  }
}
```

**Batch input:**

```json
{
  "operation": "reviews",
  "reviews": {
    "urls": [
      "https://www.airbnb.com/rooms/11710116",
      "https://www.airbnb.com/rooms/22463977"
    ],
    "offset": 0,
    "limit": 10
  }
}
```

***

#### Reviews summary

Use this operation when you only need review counts and rating breakdowns.

**Example input:**

```json
{
  "operation": "reviews_summary",
  "reviews_summary": {
    "url": "https://www.airbnb.com/rooms/992970965790772607"
  }
}
```

**Example summary row:**

```json
{
  "url": "https://www.airbnb.com/rooms/992970965790772607",
  "rating_breakdown": {
    "overall": "4.94",
    "cleanliness": "5.0",
    "accuracy": "4.9",
    "check_in": "4.9",
    "communication": "4.9",
    "location": "4.8",
    "value": "4.9",
    "star_distribution": {}
  },
  "reviews_count": 515
}
```

### Proxy support

Airbnb may show temporary verification pages or rate-limit traffic. If that happens, enable Apify Proxy in the **Proxy configuration** section. The Actor supports Apify proxy configuration and rotates to a fresh proxy session when it detects a temporary upstream block.

### Tips for scraping Airbnb reviews

- Use `limit` to control cost and runtime.
- Leave `limit` empty only when you want all available reviews for each listing.
- Use `offset` to continue from a later review page.
- Use `reviews_summary` first if you only need counts and ratings.
- Use batch URLs when comparing multiple listings.
- Schedule regular runs to monitor changes over time.

### Is it legal to scrape Airbnb?

Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

We also recommend that you read our blog post: [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

# Actor input Schema

## `operation` (type: `string`):

Choose whether to fetch full reviews or a review summary.

## `reviews` (type: `object`):

Configuration for fetching full reviews.

## `reviews_summary` (type: `object`):

Configuration for fetching a review summary without individual reviews.

## `proxyConfiguration` (type: `object`):

Select proxies to be used.

## Actor input object example

```json
{
  "operation": "reviews",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One dataset item per scraped review.

## `runSummary` (type: `string`):

Short summary stored in the OUTPUT record of the default key-value store.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlio/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "proxyConfiguration": { "useApifyProxy": False } }

# Run the Actor and wait for it to finish
run = client.actor("crawlio/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 '{
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call crawlio/airbnb-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlio/airbnb-reviews-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/vzfvjXrRDsCC3nU1V/builds/ZNxzwxllkKtmk2yfe/openapi.json