# Airbnb Scraper: Listings, Prices, Reviews & Calendar (`panix/airbnb-scraper`) Actor

Scrape Airbnb listings without login: price for your dates, rating, beds, location, photos, host, amenities, house rules, availability calendar and guest reviews. Splits big cities into map areas for thousands of listings. For short-term rental market research, pricing and travel apps.

- **URL**: https://apify.com/panix/airbnb-scraper.md
- **Developed by:** [PANIX AI LAB](https://apify.com/panix) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 listings

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Airbnb Scraper: listings, prices, reviews and availability calendar

Analyse short-term rental markets, price your own listing or compare stays. Give it a city or an Airbnb link and get prices for your dates, ratings, occupancy and listing details as clean rows.

- **Real prices for your dates**: total, per night, discount and fees, plus rating, reviews, bedrooms, beds and coordinates.
- **Whole cities, not just ~270 results**: big cities are split into map areas, so one search can return thousands of listings.
- **Details, availability calendar and reviews in the same run** when you switch them on. No Airbnb account, cookies or API key.

**Try it now:** the input is already filled in (listings in Lisbon, Portugal, 20 listings). Click **Start** and the results appear in a table you can export to Excel, CSV or JSON. That example run costs a few cents, which the $5 of free monthly credit on Apify's free plan covers.

**Price:** from **$0.70 per 1,000 listings**, and you pay only for results you get. The full price table is in the Pricing section below.

### Example result

One result, shortened. Every field is described in the Output section below.

```json
{
  "type": "listing",
  "id": "43858970",
  "url": "https://www.airbnb.com/rooms/43858970",
  "name": "East Austin Treehouse",
  "propertyLabel": "Guesthouse in East Austin",
  "rating": 4.99,
  "reviewsCount": 368,
  "isGuestFavorite": true,
  "bedrooms": 1,
  "beds": 3,
  "guests": 4,
  "priceTotal": 544.0,
  "pricePerNight": 181.27,
  "nights": 3,
  "currency": "EUR",
  "checkIn": "2026-12-18",
  "checkOut": "2026-12-21"
}
```

### What you get

Scrape Airbnb listings by place name, Airbnb search link or listing link into clean rows: **price for your dates** (total, per night, discount, fees), rating, review count, bedrooms, beds, baths, coordinates, photos and badges. Add the **listing page details** (description, every amenity, host, house rules, rating per category, sleeping arrangements, registration number), a **day-by-day availability calendar** with an occupancy summary, and **guest reviews**, all in the same run. Big cities are **split into map areas**, so one search can return thousands of listings instead of the ~270 Airbnb shows. It reads Airbnb's public pages, so you need **no Airbnb account, no cookies and no API key**.

You pay only for what you get. Listings left out by your filters, duplicates, failed pages and listing links Airbnb no longer has are free.

### What it does

1. Searches Airbnb for each place you type (for example `Lisbon, Portugal`), or opens the search and listing links you paste, with your dates, guests and filters.
2. Reads every results page. When a place has more listings than Airbnb lists for one search, it searches smaller map areas one by one and merges them without duplicates.
3. Optionally opens each listing's page for the full details, reads its availability calendar and collects its guest reviews.
4. Delivers one row per listing (and per review) to the dataset (JSON, CSV, Excel, Google Sheets, API), with a status line per input and a run summary.

### Who uses it

- **Short-term rental investors and analysts**: supply, prices, ratings and occupancy of a whole city or neighborhood, for market sizing and revenue estimates.
- **Hosts and property managers**: compare your listing's nightly price, rating and amenities with nearby competitors for the same dates, and track how full their calendars are.
- **Pricing and revenue-management tools**: nightly prices for chosen dates and guest counts, with discounts and fees, on a schedule.
- **Travel apps, agencies and comparison sites**: listing names, photos, prices, coordinates and ratings for any destination.
- **Researchers and city planners**: how many entire homes vs rooms, registration numbers, hosts with many listings, prices by area.
- **Review and sentiment analysis**: guest reviews with stars, dates, languages and host responses, newest or lowest-rated first.
- **AI agents and RAG pipelines**: callable from the Apify API or MCP server.

### Why this Airbnb scraper

- **A whole city, not just the first page.** Airbnb lists at most about 270 listings per search, even when a city has 10,000. With *Split the map* on (the default), the Actor searches smaller map areas until each fits, and merges them without duplicates. In our test 1,500 Lisbon listings took about 75 seconds.
- **Prices for your dates, as numbers.** `priceTotal`, `pricePerNight`, `priceOriginalTotal` (before discount), `nights`, `currency` and the fee and discount breakdown, in any of 44 currencies.
- **Search data, details, calendar and reviews in one Actor.** No separate search, detail, calendar and review scrapers. Turn each on with one switch; rows for the same listing share the listing ID.
- **Occupancy summary included.** With the calendar on, every listing gets `calendarSummary`: available days, booked or blocked days, occupancy rate and next available date.
- **Filters Airbnb applies itself.** Dates, adults, children, infants, pets, price range, type of place, minimum bedrooms, beds and bathrooms, plus a minimum star rating and *no hotels*. Filtered listings are never charged.
- **Pay for the data you choose.** Search data only is the cheapest; listing page details, calendar and reviews are separate, lower prices than bundled plans. Free error rows for removed listings.
- **Fast and light.** Plain HTTP, no browser, 512 MB. Failed pages are retried on another IP, and on residential IPs if needed, at no extra cost.

### Coming from another Airbnb scraper?

| Common problem in this category | How this Actor handles it |
|---|---|
| Only ~240-270 listings per city | Map splitting returns thousands of listings per search, without duplicates |
| Prices only as text like "$544 for 3 nights" | Total, per-night, before-discount price and breakdown as numbers |
| Listings, details, reviews and calendar need four scrapers | All in one run and one dataset (`type` tells rows apart) |
| Currency changes with the server's location | Currency is always sent (USD by default, 44 to choose from) |
| Calendar data with no summary | `calendarSummary` with occupancy rate and next free date |
| Charged for listings that no longer exist | Removed or private listings come back as free error rows |
| Every listing charged at the full detail price | Search data only is the default; details are an option |

### How to use it

1. Type one or more **Places** (as you would in Airbnb's search box) or paste **Airbnb links**: search links (`airbnb.com/s/...`) with your own filters or map area, and listing links (`airbnb.com/rooms/12345`).
2. Set **Max listings per search**, and if you want **dates**, guests and filters.
3. Turn on **Read listing pages**, **Availability calendar** or **Reviews per listing** if you need them.
4. Click **Start**, then download the dataset or connect it to Google Sheets, Make, n8n, Zapier or your code.

### Input examples

A city with dates and guests, 500 listings:

```json
{ "locationQueries": ["Lisbon, Portugal"], "checkIn": "2026-12-10", "checkOut": "2026-12-14", "adults": 2, "maxResultsPerSearch": 500 }
```

Entire homes with 2+ bedrooms under 250 EUR a night, rated 4.8 or better, no hotels:

```json
{
  "locationQueries": ["Paris, France"],
  "roomType": "entire", "minBedrooms": 2, "maxPrice": 250, "currency": "EUR",
  "minRating": 4.8, "includeHotels": false,
  "checkIn": "2026-12-18", "checkOut": "2026-12-21", "maxResultsPerSearch": 200
}
```

Competitor research: details, 3 months of availability and 20 newest reviews per listing:

```json
{
  "locationQueries": ["Austin, TX"],
  "maxResultsPerSearch": 50,
  "includeDetails": true,
  "calendarMonths": 3,
  "maxReviewsPerListing": 20
}
```

Your own Airbnb search link (its filters and map area are kept):

```json
{ "startUrls": ["https://www.airbnb.com/s/Lisbon--Portugal/homes?ne_lat=38.72&ne_lng=-9.13&sw_lat=38.708&sw_lng=-9.145&search_by_map=true&adults=2"], "maxResultsPerSearch": 100 }
```

Listing links or IDs with their lowest-rated reviews:

```json
{ "startUrls": ["https://www.airbnb.com/rooms/9092386", "43858970"], "maxReviewsPerListing": 200, "reviewsSort": "lowest_rated" }
```

### Output

One row per listing. A real row from a run with details and calendar on (lists shortened):

```json
{
  "type": "listing",
  "id": "43858970",
  "url": "https://www.airbnb.com/rooms/43858970",
  "name": "East Austin Treehouse",
  "propertyLabel": "Guesthouse in East Austin",
  "cardHeadline": "Private balcony, backyard, and kitchen",
  "isHotel": false,
  "rating": 4.99,
  "reviewsCount": 368,
  "isGuestFavorite": true,
  "badges": ["Guest favorite"],
  "bedrooms": 1,
  "beds": 3,
  "bathrooms": 1.0,
  "guests": 4,
  "latitude": 30.25688,
  "longitude": -97.73317,
  "priceTotal": 544.0,
  "priceOriginalTotal": 658.0,
  "pricePerNight": 181.27,
  "nights": 3,
  "currency": "EUR",
  "priceLabel": "€544 for 3 nights, originally €658",
  "priceBreakdown": [{ "description": "3 nights x €181.27", "amount": 543.8 }],
  "checkIn": "2026-12-18",
  "checkOut": "2026-12-21",
  "thumbnail": "https://a0.muscache.com/im/pictures/hosting/Hosting-U3RheVN1cHBseUxpc3Rpbmc6NDM4NTg5NzA=/original/99263221-b35e-46e3-87f7-f7e8323ebeb9.jpeg",
  "photos": ["https://a0.muscache.com/im/pictures/hosting/...", "..."],
  "paymentMessages": ["Pay €0 today", "Free cancellation"],
  "detailsIncluded": true,
  "title": "Entire guesthouse in Austin, Texas",
  "propertyType": "Entire guesthouse",
  "roomType": "Entire home/apt",
  "description": "This luxury guesthouse was built to feature the beautiful, old growth pecan trees located on the property. The space is like your own private Boutique Hotel...",
  "highlights": [{ "title": "Top 1% of homes", "text": "This home is one of the highest ranked based on ratings, reviews, and reliability." }, "..."],
  "sleepingArrangements": [{ "room": "Bedroom", "beds": ["1 queen bed"] }, { "room": "Living room", "beds": ["2 single beds", "1 couch"] }],
  "ratingCategories": { "accuracy": 4.99, "checkin": 4.99, "communication": 5, "value": 4.93, "cleanliness": 5, "location": 4.97 },
  "ratingDistribution": { "5": 0.9946, "4": 0.0027, "3": 0.0027, "2": 0.0, "1": 0.0 },
  "reviewTags": [{ "name": "Location", "count": 206 }, { "name": "Comfort", "count": 102 }, "..."],
  "isSuperhost": true,
  "amenities": [{ "group": "Bathroom", "name": "Hair dryer" }, { "group": "Bathroom", "name": "Cleaning products" }, "..."],
  "amenitiesNotIncluded": [],
  "houseRules": ["Up to 4 overnight guests", "No pets", "..."],
  "safetyAndProperty": ["Exterior security cameras on property: Outdoor nest cams", "..."],
  "petsAllowed": false,
  "registrationNumber": "OL2026016967",
  "host": {
    "id": "65953824",
    "name": "Ally",
    "isSuperhost": true,
    "isVerified": true,
    "rating": 4.99,
    "reviewsCount": 438,
    "yearsHosting": 6,
    "responseRate": "100%",
    "responseTime": "Responds within an hour",
    "profileUrl": "https://www.airbnb.com/users/show/65953824"
  },
  "photosCount": 47,
  "calendar": [{ "date": "2026-11-08", "available": false, "availableForCheckIn": false, "availableForCheckOut": false, "minNights": 1, "maxNights": 1 }, "..."],
  "calendarSummary": { "days": 54, "availableDays": 14, "bookedOrBlockedDays": 40, "occupancyRate": 0.7407, "firstDate": "2026-11-08", "lastDate": "2026-12-31", "nextAvailableDate": "2026-11-24" },
  "input": "Austin, TX",
  "inputType": "search",
  "searchQuery": "Austin, TX",
  "position": 1,
  "searchPage": 1,
  "mapArea": null,
  "scrapedAt": "2026-11-08T14:29:06Z"
}
```

A review row:

```json
{
  "type": "review",
  "listingId": "43858970",
  "listingUrl": "https://www.airbnb.com/rooms/43858970",
  "listingName": "East Austin Treehouse",
  "reviewId": "1808732223290891654",
  "rating": 5,
  "text": "Just an amazing Airbnb that has all the qualities you want in a stay: location, convenience, comfort and style. Great communication and great value for your money...",
  "language": "en",
  "createdAt": "2026-10-31T13:48:03Z",
  "dateText": "1 week ago",
  "reviewerName": "Kent",
  "reviewerLocation": "Washington, District of Columbia",
  "hostResponse": null,
  "reviewsSort": "most_recent",
  "scrapedAt": "2026-11-08T14:29:08Z"
}
```

#### Main fields

| Field | What it is |
|---|---|
| `id`, `url`, `name` | Airbnb listing ID (the number in the listing link), link and the host's listing name |
| `propertyLabel`, `cardHeadline`, `isHotel` | "Apartment in Lisbon" as on the card, Airbnb's short card summary, hotel or not |
| `priceTotal`, `pricePerNight`, `priceOriginalTotal`, `nights`, `currency`, `priceBreakdown`, `priceLabel` | Price for the dates in `checkIn`/`checkOut` |
| `rating`, `reviewsCount`, `isNew`, `isGuestFavorite`, `badges` | Stars, number of reviews and Airbnb's labels |
| `bedrooms`, `beds`, `bathrooms`, `guests` | Size (from the search card; the listing page fills gaps when details are on) |
| `latitude`, `longitude`, `area`, `mapArea` | Location (Airbnb shows an approximate point for most homes) and the map area it was found in |
| `thumbnail`, `photos` | Photo links (all photos when details are on) |
| `description`, `highlights`, `amenities`, `amenitiesNotIncluded`, `houseRules`, `houseRulesDetails`, `safetyAndProperty` | From the listing page (*Read listing pages* on) |
| `ratingCategories`, `ratingDistribution`, `reviewTags` | Rating per category (cleanliness, accuracy, check-in, communication, location, value), share of reviews per star, review topics |
| `host`, `coHosts`, `isSuperhost` | Host name, Superhost, verified, rating, reviews, years hosting, response rate and time, profile link |
| `propertyType`, `roomType`, `sleepingArrangements`, `maxGuests`, `petsAllowed`, `registrationNumber` | More listing page details |
| `calendar`, `calendarSummary` | Availability per day and the occupancy summary (*Availability calendar* on) |
| `input`, `searchQuery`, `position`, `searchPage` | Where the listing came from |
| `type` | `listing`, `review` or `error` (free row for a listing link Airbnb does not have) |

Review rows have `reviewId`, `listingId`, `listingName`, `rating`, `text`, `language`, `createdAt`, `dateText`, `reviewerName` (first name as shown on Airbnb), `reviewerLocation`, `hostResponse` and `photos`.

The Output tab has views for **Listings**, **Prices and dates**, **Listing details**, **Availability** and **Reviews**. The key-value store has `INPUTS` (one status line per input) and `SUMMARY` (totals, listings left out per filter, request statistics).

### Pricing

Pay per event, no monthly fee:

| Event | Free plan | Starter (Bronze) | Scale (Silver) | Business (Gold) and up |
|---|---|---|---|---|
| Listing, search data (per 1,000) | $1.25 | $1.00 | $0.85 | $0.70 |
| Listing with its listing page read, charged instead (per 1,000) | $2.50 | $2.00 | $1.70 | $1.40 |
| Availability calendar, add-on per listing (per 1,000) | $0.60 | $0.50 | $0.45 | $0.35 |
| Review (per 1,000) | $1.25 | $1.00 | $0.85 | $0.70 |
| Actor start (per run, per GB of memory) | $0.001 | $0.001 | $0.001 | $0.001 |

Free: listings left out by filters, duplicates (the same listing found in two searches or map areas is charged once), hotels you turned off, failed pages and listing links Airbnb no longer has (error rows). Map splitting and residential retries cost nothing extra. Listing links (`/rooms/...`) always read the listing page and are charged as *Listing with details*. With the default 512 MB a run pays one start event. Set a spending limit on the run and the Actor stops before it.

Examples on the Starter plan: 1,000 listings from a city search cost $1.00 plus $0.001; 100 listings with details, a 3-month calendar and 20 reviews each cost $0.20 + $0.05 + $2.00.

### Use it from code, n8n, Make, Zapier and AI agents

Python ([apify-client](https://pypi.org/project/apify-client/) 3.x):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("panix/airbnb-scraper").call(run_input={
    "locationQueries": ["Lisbon, Portugal"],
    "checkIn": "2026-12-10", "checkOut": "2026-12-14", "adults": 2,
    "maxResultsPerSearch": 200,
})
for row in client.dataset(run.default_dataset_id).iterate_items():
    print(row["id"], row["name"], row["pricePerNight"], row["rating"])
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('panix/airbnb-scraper').call({ startUrls: ['https://www.airbnb.com/rooms/9092386'], maxReviewsPerListing: 50 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.filter((r) => r.type === 'review').map((r) => [r.rating, r.createdAt, r.text]));
```

One HTTP call that runs the Actor and returns the rows (n8n HTTP Request node, Make HTTP module, any script):

```
POST https://api.apify.com/v2/acts/panix~airbnb-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>
Content-Type: application/json

{"locationQueries": ["Austin, TX"], "maxResultsPerSearch": 20}
```

n8n, Make and Zapier also have Apify apps: choose **Run Actor**, pick `panix/airbnb-scraper`, paste the input JSON, then read the dataset items. AI agents can call it through the Apify MCP server (`https://mcp.apify.com`).

### FAQ

**Do I need an Airbnb account or API key?** No. The Actor reads the search pages, listing pages, calendars and reviews Airbnb shows to every visitor. No login, cookies or API key.

**What if I give no dates?** Airbnb then shows prices for sample dates it picks (usually a few nights soon). The dates used are in `checkIn` and `checkOut` of every row. Give dates for comparable prices.

**Is `pricePerNight` before or after discounts and fees?** `priceTotal` is the total Airbnb shows on the card for the stay (after discounts). `pricePerNight` is the nightly rate from Airbnb's price details (before a stay discount); `priceBreakdown` lists the lines Airbnb shows (nights, discounts, cleaning or resort fees when listed).

**How many listings can I get for a city?** Airbnb's own count is in `INPUTS.totalResults` (for example 10,121 for Lisbon with dates). With map splitting on, the Actor can go well past Airbnb's ~270 per search; very dense map areas can still hold more than Airbnb lists, so the total may stay a little below Airbnb's count.

**Why does a listing link row have no price?** Airbnb's listing page loads the price in the browser, so listing links (`/rooms/...`) come without a price. For prices, search the place with your dates; the search rows carry the price.

**Are the coordinates exact?** Airbnb shows an approximate point for most homes (`isExactLocation` tells you when details are on); hotels are usually exact.

**How many reviews can I get?** As many as Airbnb lists for the listing (24 per request, thousands for popular listings), in the order you choose.

### Limits

- Prices are what a logged-out visitor sees for the chosen dates and guests; member-only prices and taxes added at checkout are not included.
- Listing links (`/rooms/...`) come without a price (see FAQ).
- Airbnb Experiences and Services are not scraped, only stays.
- Airbnb's search order changes between visits. For monitoring, track fixed listing IDs.
- Airbnb changes its pages at times; if a field stops filling, open an issue.

### Data and legal

The Actor collects listing information and guest reviews that Airbnb shows to every visitor. Host rows include the host's first name and public profile as shown on Airbnb; review rows include the reviewer's first name. No contact data (email, phone) is collected. You are responsible for using the data lawfully, including Airbnb's terms and data protection laws such as the GDPR where they apply. This Actor is not affiliated with Airbnb.

### Support

Open an issue on the Actor's **Issues** tab with the run ID; it is answered quickly. Feature requests are welcome.

# Actor input Schema

## `locationQueries` (type: `array`):

Places as you would type them in Airbnb's search box, e.g. "Lisbon, Portugal" or "Austin, TX". Each place is its own search.

## `startUrls` (type: `array`):

Airbnb search links (airbnb.com/s/...) with your own filters or map area, and listing links (airbnb.com/rooms/12345). Listing IDs (the number in a listing link) work too. Filters already in a search link are kept.

## `maxResultsPerSearch` (type: `integer`):

Listings to deliver for each place or search link. Airbnb shows about 270 listings per search; above that the map is split into smaller areas (see below), which can reach thousands of listings in a big city.

## `maxResults` (type: `integer`):

Stop the whole run after this many listings (0 = no limit). Reviews are not counted. You can also set a spending limit on the run.

## `splitMapForMoreResults` (type: `boolean`):

When a search has more listings than Airbnb lists (about 270), search smaller map areas one by one and merge them without duplicates. Turn off to get only Airbnb's own first ~270 results in its order.

## `checkIn` (type: `string`):

Arrival date for prices and availability, e.g. 2026-12-24. Leave both dates empty and Airbnb shows prices for sample dates it picks (shown in checkIn/checkOut of every row).

## `checkOut` (type: `string`):

Departure date, after the check-in date.

## `adults` (type: `integer`):

Number of adult guests (0 = Airbnb's default of 1).

## `children` (type: `integer`):

Number of children.

## `infants` (type: `integer`):

Number of infants.

## `pets` (type: `integer`):

Number of pets (only pet-friendly places are shown).

## `minPrice` (type: `integer`):

Airbnb's own price filter, in the chosen currency.

## `maxPrice` (type: `integer`):

Airbnb's own price filter, in the chosen currency.

## `roomType` (type: `string`):

Entire homes, private rooms, shared rooms or hotel rooms.

## `minBedrooms` (type: `integer`):

Only places with at least this many bedrooms.

## `minBeds` (type: `integer`):

Only places with at least this many beds.

## `minBathrooms` (type: `integer`):

Only places with at least this many bathrooms.

## `minRating` (type: `number`):

Leave out listings rated below this, e.g. 4.8 (new listings without a rating are left out too). Left-out listings are free.

## `includeHotels` (type: `boolean`):

Airbnb mixes hotel rooms into home searches. Turn off to leave hotels out (free).

## `currency` (type: `string`):

Currency of all prices and of the price filters.

## `includeDetails` (type: `boolean`):

Also read every listing's page: full description, all amenities, host (name, Superhost, years hosting, response rate), house rules, check-in time, rating breakdown (cleanliness, location...), sleeping arrangements, all photos, registration number. Listing links (/rooms/...) always get details.

## `calendarMonths` (type: `integer`):

Add each listing's day-by-day availability for this many months from today, with minimum nights and an occupancy summary. 0 = no calendar.

## `maxReviewsPerListing` (type: `integer`):

Also deliver up to this many guest reviews for every listing (one row per review: text, rating, date, reviewer first name, host response). 0 = no reviews.

## `reviewsSort` (type: `string`):

Which reviews come first.

## `maxConcurrency` (type: `integer`):

Airbnb pages read at the same time.

## `useResidentialFallback` (type: `boolean`):

When a page fails several times on the main proxy, retry it on residential IPs (included in the price).

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

Apify datacenter proxy works for Airbnb's public pages and is the default.

## Actor input object example

```json
{
  "locationQueries": [
    "Lisbon, Portugal"
  ],
  "maxResultsPerSearch": 20,
  "maxResults": 0,
  "splitMapForMoreResults": true,
  "adults": 0,
  "children": 0,
  "infants": 0,
  "pets": 0,
  "roomType": "any",
  "includeHotels": true,
  "currency": "USD",
  "includeDetails": false,
  "calendarMonths": 0,
  "maxReviewsPerListing": 0,
  "reviewsSort": "most_recent",
  "maxConcurrency": 8,
  "useResidentialFallback": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

Delivered listings and reviews. Listings left out by filters and duplicates are not in the dataset and are not charged. Listing links Airbnb no longer has appear as free error rows.

## `inputs` (type: `string`):

Listings on Airbnb, pages and map areas read, listings delivered, reviews delivered, and why each search or link stopped.

## `summary` (type: `string`):

Totals, charged events, listings left out per filter, request statistics and warnings.

# 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 = {
    "locationQueries": [
        "Lisbon, Portugal"
    ],
    "maxResultsPerSearch": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("panix/airbnb-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 = {
    "locationQueries": ["Lisbon, Portugal"],
    "maxResultsPerSearch": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("panix/airbnb-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locationQueries": [
    "Lisbon, Portugal"
  ],
  "maxResultsPerSearch": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call panix/airbnb-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,panix/airbnb-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AYzuJzKbH29YTXkmT/builds/5fRS9H0kMCwyyCjaQ/openapi.json
