# Airbnb Scraper - Listings, Prices, Ratings & Availability (`zaver.api/airbnb-scraper`) Actor

Scrape Airbnb listings by city, map area or search link without the Airbnb API: nightly and total prices, ratings, reviews count, coordinates and photos. Optional details add amenities, capacity, rating breakdown and calendar availability. No login, no start fee. CSV, Excel or JSON.

- **URL**: https://apify.com/zaver.api/airbnb-scraper.md
- **Developed by:** [Zaver](https://apify.com/zaver.api) (community)
- **Categories:** Travel, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

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, Ratings, Amenities and Availability

**Scrape Airbnb without the Airbnb API.** Enter a city, a neighbourhood or an Airbnb search link and get every listing with its nightly price, total price, rating, review count, coordinates and photos. An optional add-on opens each listing for property type, bedrooms, amenities, the six rating scores and calendar availability. No Airbnb account, no cookies, no browser. Pay per listing, no start fee.

> ⭐ Search by place name, map area or search link · nightly and total prices with discounts · ratings and review counts · coordinates · up to 5,000 listings per location · amenities, capacity and Superhost flag · open nights for the next 30, 90 and 365 days · API and MCP ready

### What does Airbnb Scraper do?

It runs the same search Airbnb's website runs and returns the results as clean rows.

| You enter | You get |
|---|---|
| A **location** such as `Lisbon, Portugal` | Listings in that place, with prices and ratings |
| An **Airbnb search link** with your own filters | The same results you see on the site |
| A **listing link** such as `airbnb.com/rooms/23411393` | That listing's details and availability |

Airbnb shows about 240 listings for one search. When you ask for more, the Actor divides the area into smaller map areas and searches each one, so you can collect up to 5,000 listings per location.

### What data does it extract?

#### Every listing

| Field | Description |
|---|---|
| `name`, `title`, `id`, `url` | Listing name, type and area ("Apartment in Lisbon"), ID and link |
| `pricePerNight`, `totalPrice`, `nights` | Nightly price, total for the stay and number of nights |
| `originalTotalPrice`, `priceBreakdown` | Price before discount, and each price line as Airbnb shows it |
| `currency`, `currencySymbol`, `priceDates` | Currency, and the dates Airbnb priced when you set none |
| `rating`, `reviewCount` | Average rating and number of reviews |
| `summary` | Bedrooms, beds and baths as shown on the card |
| `isGuestFavorite`, `isSuperhost`, `badges`, `freeCancellation` | Badges and flags |
| `latitude`, `longitude` | Map position |
| `thumbnail`, `images` | Photos shown on the search card |
| `position`, `source` | Rank in the results and the location or link it came from |

#### With the details add-on

| Field | Description |
|---|---|
| `propertyType`, `roomType` | For example "Entire rental unit", "Entire home/apt" |
| `personCapacity`, `bedrooms`, `beds`, `bathrooms` | Size of the place |
| `isSuperhost`, `isGuestFavorite` | Host and listing status |
| `ratings` | Scores for accuracy, check-in, cleanliness, communication, location and value |
| `amenities` | Every amenity the listing offers |
| `images`, `imageCount` | All photos of the listing |
| `description` | The opening lines of the listing description |
| `availableNights30`, `availableNights90`, `availableNights365` | Open nights in the calendar for the coming periods |
| `minNights`, `nextAvailableDate` | Minimum stay and the first open night |
| `latitude`, `longitude` | The listing page's own coordinates |

### An Airbnb API alternative

Airbnb has no public API. Its official API is open only to approved software partners such as channel managers, and it returns a host's own listings, not market data.

This Actor is an **Airbnb API alternative** for public listing data. It works **without the Airbnb API**: no partner application, no account, no cookies.

| | Airbnb partner API | This Actor |
|---|---|---|
| Access | Approved partners only | Anyone |
| Data | Your own listings | Any public listing in any market |
| Market search | No | By place, map area or search link |
| Output | API objects | Flat rows: CSV, Excel, JSON |

### Why use this Airbnb scraper

#### More than Airbnb's 240-listing limit

One search on Airbnb stops after about 240 listings. The Actor splits busy areas into smaller map areas and removes repeats, so a city returns thousands of unique listings.

#### Real prices, with the breakdown

Each row carries the nightly price, the total, the price before discount and every price line, in the currency you choose.

#### Availability without a second tool

The details add-on reads each listing's calendar and counts the open nights for the next 30, 90 and 365 days. That is the base for occupancy estimates.

#### Your own search links work

Set any filter on airbnb.com, copy the link and paste it. The Actor keeps the link's dates and filters.

#### No start fee, and failures are free

You pay per listing delivered. Removed listings, bad links and failed locations return a free error row. Details are charged only when they were added.

### How to scrape Airbnb listings

1. Open the Actor and type one or more **Locations**, or paste **Airbnb links**.
2. Optionally set check-in and check-out dates, guests, a price range and the type of place.
3. Set **Max listings per location**.
4. Turn on **Add listing details and availability** if you need amenities, room counts and the calendar.
5. Press **Start**, then export as CSV, Excel, JSON or XML, or read the dataset through the API.

> 💡 Set dates when you compare prices. Without dates, Airbnb prices each listing for dates it picks itself; those dates are in `priceDates`.

### Input examples

Listings in a city for given dates:

```json
{
  "locations": ["Lisbon, Portugal"],
  "checkIn": "2026-12-10",
  "checkOut": "2026-12-14",
  "adults": 2,
  "currency": "EUR",
  "maxItemsPerLocation": 500
}
```

A market study with details and availability:

```json
{
  "locations": ["Austin, TX", "Nashville, TN"],
  "roomType": "entire_home",
  "minBedrooms": 2,
  "maxItemsPerLocation": 1000,
  "includeDetails": true
}
```

Your own search link and a few listings:

```json
{
  "startUrls": [
    "https://www.airbnb.com/s/Tokyo--Japan/homes?adults=2&price_max=100",
    "https://www.airbnb.com/rooms/23411393"
  ]
}
```

| Field | Type | Description |
|---|---|---|
| `locations` | array | Place names as you would type them into Airbnb's search box. |
| `startUrls` | array | Airbnb search links or listing links. A search link keeps its own dates and filters. |
| `maxItemsPerLocation` | integer | Listings per location or search link, up to 5,000. Default `100`. |
| `checkIn`, `checkOut` | string | Optional stay dates, `YYYY-MM-DD`. Set both or neither. |
| `adults` | integer | Number of adult guests. |
| `currency` | string | Currency for prices. Default `USD`. |
| `priceMin`, `priceMax` | integer | Nightly price range in the selected currency. |
| `roomType` | string | `any`, `entire_home` or `private_room`. |
| `minBedrooms` | integer | Minimum number of bedrooms. |
| `includeDetails` | boolean | Add listing details and availability. Charged per listing as a separate event. |
| `maxItems` | integer | Hard cap on listings for the run. 0 means no cap. |

### Output example

```json
{
  "type": "listing",
  "id": "32422325",
  "url": "https://www.airbnb.com/rooms/32422325",
  "name": "Brand new apartment right in the heart of Alfama.",
  "title": "Apartment in Santa Maria Maior",
  "summary": "1 bedroom, 2 beds",
  "rating": 4.82,
  "reviewCount": 477,
  "pricePerNight": 107.75,
  "totalPrice": 431,
  "originalTotalPrice": 580,
  "nights": 4,
  "currency": "EUR",
  "currencySymbol": "€",
  "freeCancellation": true,
  "latitude": 38.71167,
  "longitude": -9.12559,
  "checkIn": "2026-11-10",
  "checkOut": "2026-11-14",
  "source": "Lisbon, Portugal",
  "position": 1,
  "propertyType": "Entire rental unit",
  "roomType": "Entire home/apt",
  "personCapacity": 4,
  "bedrooms": 1,
  "beds": 2,
  "bathrooms": 1,
  "isSuperhost": false,
  "ratings": {"accuracy": 4.78, "checkIn": 4.9, "cleanliness": 4.9, "communication": 4.97, "location": 4.86, "value": 4.71},
  "amenities": ["Bay view", "City skyline view", "River view", "Wifi", "Kitchen"],
  "imageCount": 23,
  "availableNights30": 2,
  "availableNights90": 52,
  "availableNights365": 304,
  "minNights": 1,
  "nextAvailableDate": "2026-10-06",
  "detailsAdded": true
}
```

### Pricing

Pay per result. **No start fee, no monthly rental, no minimum.**

| Event | Charged for | Price |
|---|---|---|
| `listing-scraped` | each listing delivered | **$1.99 / 1,000** |
| `details-added` | each listing that got details and availability (add-on, and always for listing links) | **$2.99 / 1,000** |
| - | removed listings, bad links, failed locations and duplicates | **free** |

| You export | You pay |
|---|---|
| 240 listings in one city | **$0.48** |
| 1,000 listings | **$1.99** |
| 1,000 listings with details and availability | **$4.98** |
| 5,000 listings across five cities | **$9.95** |

You are charged right after each batch lands in your dataset, so a run you stop early costs only what it delivered. Proxies, when needed, are included.

### Use cases

#### Short-term rental market research

Collect every listing in a city with prices, capacity and availability to size the market before you invest.

#### Pricing and revenue management

Compare your nightly rate with similar listings nearby for the same dates, and re-run weekly to follow the market.

#### Occupancy estimates

Open nights for the next 30 and 90 days, tracked over time, show how fast listings fill up in a neighbourhood.

#### Real estate and investment analysis

Combine nightly prices, bedrooms and coordinates to estimate rental yield by area.

#### Property managers and co-hosts

Find listings by area, size and rating to build a prospect list for your management service.

#### Travel products and price monitoring

Feed live listing data into a comparison tool, or watch prices for specific dates.

#### Research and data journalism

Study housing pressure, tourism and regulation with a dated dataset of public listings.

### FAQ

**Do I need an Airbnb account, API key or cookies?**
No. It works without the Airbnb API and without logging in.

**Is scraping Airbnb legal?**
This is general information, not legal advice. The Actor collects only listing information that Airbnb shows publicly to every visitor, and never logs in. It does not collect guest data or private host contact details. Airbnb's terms restrict automated access, and listing data can include personal data of hosts under laws such as the GDPR. Whether your use is lawful depends on where you are and what you do with the data. Use it for research and analysis, do not republish personal data, and ask a lawyer before building a commercial product on it.

**How many listings can I get for one city?**
Up to 5,000 per location. Airbnb returns about 240 per search, so above that the Actor searches smaller map areas inside the area the first results cover.

**Are the prices final?**
They are the prices Airbnb displays for the dates, guests and currency of the search, including any discount shown. Taxes added at checkout can differ by country.

**Why are some prices above my maximum?**
Airbnb applies the price filter to its own nightly base price. The displayed price per night can be slightly higher once fees are included.

**What do the availability numbers mean?**
They count the nights the calendar shows as open. A closed night is either booked or blocked by the host, and Airbnb does not say which.

**Does it return host names or contact details?**
No. Airbnb does not publish host contact details, and this Actor does not collect host profiles.

**Does it return reviews?**
It returns the rating, the review count and, with details, the six rating scores. Review texts are not included.

**Does it return the full description?**
It returns the opening lines. The full text loads separately on Airbnb and is not included.

**How fast is it?**
About 1,500 listings a minute for searches. With the details add-on, about 230 listings a minute.

**Can I run it on a schedule?**
Yes. Weekly runs over the same locations give you price and availability history.

### Integrations

- **Apify API** - start runs and fetch datasets from Python, Node.js, cURL or any HTTP client.
- **MCP server** - call this Actor as a tool from Claude, Cursor, ChatGPT agents and any MCP client.
- **No-code** - Make, Zapier, n8n, Google Sheets, Airtable, Slack, webhooks.
- **Schedules** - run daily or weekly and append to the same dataset to build history.
- **Exports** - JSON, JSONL, CSV, Excel (XLSX), XML, HTML table.

### Related actors

**Local and market data**

- [Google Maps Scraper](https://apify.com/zaver.api/google-maps-scraper) - places, phones, GPS and optional emails
- [Google Places Scraper](https://apify.com/zaver.api/google-places-scraper) - local businesses by keyword and city
- [Indeed & LinkedIn Jobs Scraper](https://apify.com/zaver.api/indeed-linkedin-jobs-scraper) - job listings by keyword and location

**Outreach and e-commerce**

- [Website Contact Extractor](https://apify.com/zaver.api/website-contact-extractor) - emails, phones and social profiles from websites
- [Shopify Store Finder](https://apify.com/zaver.api/shopify-store-finder) - Shopify stores by country and ranking
- [Amazon Product Scraper](https://apify.com/zaver.api/amazon-product-scraper) - products, prices and ratings

***

*Not affiliated with, endorsed by or sponsored by Airbnb. This Actor reads only what Airbnb shows publicly to a logged-out visitor and does not log in. You are responsible for using the data in line with applicable laws and Airbnb's terms.*

# Actor input Schema

## `locations` (type: `array`):

Cities, neighbourhoods, regions or countries, one per line, written as you would type them into Airbnb's search box: <code>Lisbon, Portugal</code>, <code>Brooklyn, New York</code>, <code>Bali</code>.

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

Airbnb search links (<code>https://www.airbnb.com/s/Lisbon--Portugal/homes?...</code>) with any filters you set on the site, or listing links (<code>https://www.airbnb.com/rooms/23411393</code>). A search link keeps its own dates and filters.

## `maxItemsPerLocation` (type: `integer`):

How many listings to return for each location or search link. Airbnb shows about 240 per search; above that, the Actor splits the area into smaller map areas and searches each one.

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

Optional. With dates, prices are for your stay and only available listings are returned. Without dates, Airbnb shows a price for dates it picks.

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

Optional. Set together with check-in.

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

Number of adult guests. 0 leaves it unset.

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

Currency for prices.

## `priceMin` (type: `integer`):

In the selected currency. 0 means no minimum.

## `priceMax` (type: `integer`):

In the selected currency. 0 means no maximum.

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

Entire homes only, private rooms only, or any type.

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

0 means any.

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

Opens each listing and adds property type, bedrooms, beds, baths, guest capacity, Superhost flag, the six rating scores, amenities, all photos, exact coordinates and calendar availability for the next 30, 90 and 365 days. Charged as a separate event per listing.

## `maxItems` (type: `integer`):

Hard cap on listings for the whole run. 0 means no cap.

## Actor input object example

```json
{
  "locations": [
    "Lisbon, Portugal"
  ],
  "maxItemsPerLocation": 100,
  "adults": 0,
  "currency": "USD",
  "priceMin": 0,
  "priceMax": 0,
  "roomType": "any",
  "minBedrooms": 0,
  "includeDetails": false,
  "maxItems": 0
}
```

# Actor output Schema

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

All dataset items.

## `resultsCsv` (type: `string`):

CSV download.

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

Counts for the run.

# 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 = {
    "locations": [
        "Lisbon, Portugal"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zaver.api/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 = { "locations": ["Lisbon, Portugal"] }

# Run the Actor and wait for it to finish
run = client.actor("zaver.api/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 '{
  "locations": [
    "Lisbon, Portugal"
  ]
}' |
apify call zaver.api/airbnb-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zaver.api/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/6Vgk4Icl4obxWeV5S/builds/SRCdnW4Ov9xJgTykf/openapi.json