# Airbnb Scraper (`automly/airbnb-listings-scraper`) Actor

Airbnb Scraper: Scrape Airbnb listings by city, search link or listing link: nightly price, rating, reviews count, host, amenities, coordinates and photos. Just type a place, no dates needed. Export to CSV, JSON or Excel, schedule runs or use the API.

- **URL**: https://apify.com/automly/airbnb-listings-scraper.md
- **Developed by:** [Automly](https://apify.com/automly) (community)
- **Categories:** Travel, Real estate
- **Features:** Limited permissions
- **Stats:** 13 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

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

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 & Hosts

### What is Airbnb Scraper?

**Airbnb Scraper** is a tool that lets you **scrape listings from Airbnb**: nightly and total prices, ratings, review counts, hosts and superhost status, bedrooms, beds, bathrooms, amenities, coordinates and photos. Type a place like `Paris`, or paste an Airbnb search or listing link, click **Start**, and download the listings as Excel, CSV or JSON. No dates needed.

- ⚡ **Speed:** 35 Paris listings with full details in about 30 seconds (our test)
- 📍 **Just a place name:** type `Lisbon` or `New York`, no search link and no dates required
- 🏠 **Full listing details:** host, bedrooms, beds, bathrooms, amenities and every photo
- 🔓 **No login:** no Airbnb account and no API key needed
- 💸 **Free to try:** the $5 of free usage every Apify account gets each month covers about 1,000 listings

### What can Airbnb Scraper do?

- **Scrape Airbnb listings by city or place**: just type `Paris`, `New York` or `Lisbon`
- **Scrape an Airbnb search link** with your filters, copied from the address bar
- **Scrape a single Airbnb listing** from its `airbnb.com/rooms/...` link
- **Get Airbnb prices for your dates**: add check-in and check-out to get the total price for the stay
- **Get Airbnb host data**: host name, host ID and superhost status
- **Browse a market without dates**: get listings and nightly prices without picking check-in and check-out
- **Mix places, search links and listing links** in one run
- Export to Excel, CSV, JSON, HTML or XML, or send the data to Google Sheets, Make, Zapier and more

### What data can you extract from Airbnb?

| | | |
|---|---|---|
| 🏠 Listing title and description | 🔗 Listing link and ID | 🏷️ Property type and room type |
| 💵 Price per night | 🧾 Total price for your dates | 💱 Currency you choose |
| ⭐ Guest rating | 💬 Number of reviews | 🏅 Superhost flag |
| 🧑 Host name and host ID | 👥 Guest capacity | 🛏️ Bedrooms, beds and bathrooms |
| 🧺 Amenities | 🖼️ All photo links | 📍 Location, latitude and longitude |
| 📅 Check-in and check-out used | 🕘 Time of the scrape | |

### How to scrape Airbnb listings

1. [Create a free Apify account](https://console.apify.com/sign-up) (no credit card needed).
2. Open **Airbnb Scraper**.
3. In **Search Airbnb**, type a place (`Paris, France`), or paste an Airbnb search or listing link. Add as many as you want.
4. Optionally set dates, guests, currency and how many listings you want, then click **Start**.
5. When the run finishes, download your listings as Excel, CSV, JSON, HTML or XML.

### How much does it cost to scrape Airbnb listings?

You pay **$5.00 per 1,000 listings**. Platform usage is included in that price, so there is nothing else to pay for a run.

Example: 200 listings cost $1.00, and 1,000 listings cost $5.00.

Every Apify account gets **$5 of free usage each month**, so you can try it at no cost. See the **Pricing** tab for details.

### ⬇️ Input

The **Search Airbnb** field is all you need. It accepts place names, Airbnb search links and listing links, and works out which is which.

| Setting | What it does |
|---|---|
| Search Airbnb | Places (`Paris, France`), Airbnb search links or listing links (`https://www.airbnb.com/rooms/...`). Add as many as you want |
| Check-in date / Check-out date | Optional, `YYYY-MM-DD`. Leave empty to get listings without dates (no total price for a stay) |
| Adults / Children / Infants / Pets | Optional guest counts (default 1 adult) |
| Maximum listings | How many listings to save across all searches, 1 to 5,000 (default 50) |
| Currency | Currency for prices, such as USD, EUR or GBP (default USD) |
| Include listing details | Get bedrooms, beds, host and reviews for each listing (on by default) |
| Include images / amenities / host info / review summary | Turn each group of fields on or off (all on by default) |
| Search URLs / Listing URLs / Locations | Older separate fields. The single **Search Airbnb** field covers all three |
| Connection settings | The default works for most runs |

The simplest input, a place and nothing else:

```json
{ "search": ["Paris, France"], "maxListings": 100 }
```

Places, a search link and a listing link in one run, priced in euros:

```json
{
  "search": [
    "New York, NY",
    "https://www.airbnb.com/s/Lisbon/homes",
    "https://www.airbnb.com/rooms/12345678"
  ],
  "maxListings": 200,
  "currency": "EUR",
  "includeListingDetails": true
}
```

Paris for three nights in December, two adults, with the total price for the stay:

```json
{
  "search": ["Paris, France"],
  "checkIn": "2026-12-01",
  "checkOut": "2026-12-04",
  "adults": 2,
  "maxListings": 35
}
```

### ⬆️ Output

You get one row per listing. You can view them as a table in Apify Console or download them as Excel, CSV, JSON, HTML or XML. This row is from a real run for Paris, 1 to 4 December 2026 (lists shortened):

```json
{
  "listingId": "1259244916865191770",
  "listingUrl": "https://www.airbnb.com/rooms/1259244916865191770",
  "title": "Elegant apartment with AC -2BR-6P- Le Marais",
  "description": "Checkmyguest offers this modern Scandinavian-style 57m² apartment, located on th...",
  "propertyType": "Apartment in 3rd Arrondissement",
  "roomType": "Entire home/apt",
  "location": "Apartment in 3rd Arrondissement",
  "latitude": 48.8633,
  "longitude": 2.3527,
  "pricePerNight": 438.38,
  "totalPrice": 1220,
  "currency": "USD",
  "rating": 4.87,
  "reviewsCount": 79,
  "isSuperhost": true,
  "hostId": "598558461",
  "hostName": "Joffrey Sally",
  "guestCapacity": 6,
  "bedrooms": 2,
  "beds": 3,
  "bathrooms": 2.5,
  "amenities": ["Hair dryer", "Cleaning products", "Shampoo", "Body soap", "Hot water"],
  "imageUrls": ["https://a0.muscache.com/im/pictures/prohost-api/Hosting-1259244916865191770/..."],
  "checkIn": "2026-12-01",
  "checkOut": "2026-12-04",
  "scrapedAt": "2026-10-01T18:00:59+00:00"
}
```

`totalPrice`, `checkIn` and `checkOut` are filled only when you set dates. The **Output** tab has three views: an overview, prices and listing details.

### How can I use Airbnb data?

- **Market and price research:** compare nightly prices across a city or neighborhood
- **Short-term rental analysis:** supply, room types, superhost share and ratings in a market
- **Competitor tracking:** follow specific listings or areas over time with scheduled runs
- **Real estate and investment:** gauge short-term rental demand and pricing before you buy
- **Travel tools and aggregators:** power a search or recommendation feature
- **AI and data pipelines:** clean listing data for search, analysis or agents

### Scrape more travel and real estate data

| Actor | What it gets |
|---|---|
| [Booking.com Hotel Scraper](https://apify.com/automly/booking-scraper) | Hotel prices, guest ratings, room types and taxes for a destination and dates |
| [Tripadvisor Reviews Scraper](https://apify.com/automly/tripadvisor-reviews-scraper) | Reviews of hotels, restaurants and attractions with ratings and owner replies |
| [Skyscanner Flight Scraper](https://apify.com/automly/skyscanner-flight-scraper) | Flight prices, airlines, stops and booking links for any route |
| [Google Maps Scraper](https://apify.com/automly/google-maps-scraper) | Places with addresses, phones, websites, ratings and opening hours |
| [Zillow Scraper](https://apify.com/automly/zillow-scraper) | Homes for sale, rentals and sold listings with Zestimates |
| [Apartments.com Scraper](https://apify.com/automly/apartments-com-scraper) | Long-term rentals with rents, floor plans and available units |

### 🤖 Use with AI agents (MCP)

This actor works as a tool for AI agents. Connect any MCP-compatible AI assistant or agent to the Apify MCP server at [mcp.apify.com](https://mcp.apify.com) (sign in with your Apify account), and it can find this actor, fill in the input and read the results by itself. Ask in plain words, for example *"List Airbnb stays in Lisbon for 12-15 November with prices"*, and the agent runs `automly/airbnb-listings-scraper` with an input like `{"search": ["Lisbon, Portugal"], "checkIn": "2026-11-12", "checkOut": "2026-11-15", "maxListings": 50}`. Every input and output field has a plain description, so the agent knows what to type and what each column means. Agent runs cost the same as runs you start yourself.

### ❓FAQ

#### How much does it cost to scrape Airbnb?

$5.00 per 1,000 listings, with platform usage included. See the cost section above and the **Pricing** tab.

#### Do I need dates to search?

No. Type a place and run, and you get listings without picking check-in and check-out. Add dates only if you want the total price for a specific stay.

#### Do I need an Airbnb account or API key?

No. You don't need an Airbnb account, a login or an API key.

#### How many listings can I get from one search?

Airbnb shows up to about 270 listings for one search (usually 235 to 270). For a whole city, add several searches, such as neighborhoods, nearby places or search links with different filters or price ranges, and set **Maximum listings** up to 5,000.

#### Can I scrape a single listing?

Yes. Paste the `airbnb.com/rooms/...` link into **Search Airbnb**.

#### Why are some fields empty?

Airbnb does not show every field on every listing. A new listing has no rating yet, and the total price needs dates. Fields that are not on the listing stay empty instead of being guessed.

#### What export formats are supported?

JSON, CSV, Excel, HTML and XML, from the **Storage** tab or the Apify API.

#### Can I connect Airbnb Scraper to other tools or AI agents?

Yes. Start runs and download results with the Apify API or the Python and JavaScript clients, send results to Make, Zapier, n8n, Google Sheets or Slack with Apify integrations and webhooks. AI assistants and agents can run it through the Apify MCP server, see the **Use with AI agents (MCP)** section above.

#### Is it legal to scrape Airbnb?

This scraper only collects listing information that Airbnb shows publicly. Listings can still include personal data, such as a host's name, which may be protected by laws such as GDPR, so only scrape it for a legitimate reason and ask a lawyer if you are unsure. You can read more in [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

Airbnb Scraper is an independent tool. It is not affiliated with, endorsed by or sponsored by Airbnb.

#### Something isn't working?

Open the **Issues** tab and tell us your input and what you expected.

### ⭐ Your feedback

Have an idea or found a problem? Tell us in the **Issues** tab. If Airbnb Scraper saved you time, a short review on the **Reviews** tab helps other people find it.

# Actor input Schema

## `search` (type: `array`):

What to scrape. Type a place — 'Paris, France', 'New York', 'Lisbon' — and that's it. You can also paste an Airbnb search URL or a listing URL (https://www.airbnb.com/rooms/...). Add as many as you want. No dates required.

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

Optional. Arrival day as YYYY-MM-DD, e.g. 2026-11-12. Leave empty to scrape without dates (you still get listings, just no date-specific total price).

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

Optional. Departure day as YYYY-MM-DD, e.g. 2026-11-15. Set it together with Check-in date.

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

Number of adult guests.

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

Number of child guests.

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

Number of infant guests.

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

Number of pets.

## `maxListings` (type: `integer`):

Maximum listing records to save (across all searches). Airbnb shows up to about 270 listings for one search, so add more places, neighborhoods or search URLs to go higher.

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

Currency code for prices (e.g. USD, EUR, GBP).

## `includeListingDetails` (type: `boolean`):

Visit each listing page for richer fields (bedrooms, beds, host, reviews).

## `includeImages` (type: `boolean`):

Include listing image URLs.

## `includeAmenities` (type: `boolean`):

Include amenities when available on listing pages.

## `includeHostInfo` (type: `boolean`):

Include host name, ID, and superhost status when available.

## `includeReviewsSummary` (type: `boolean`):

Include rating and review-count fields when available.

## `searchUrls` (type: `array`):

Optional. Explicit Airbnb search-result URLs (advanced). Most users can ignore this and use the Search field above.

## `listingUrls` (type: `array`):

Optional. Airbnb listing links, one per line, e.g. https://www.airbnb.com/rooms/12345678.

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

Optional. Place queries (same as typing them in the Search field).

## `useApifyProxy` (type: `boolean`):

Leave this on.

## `proxyGroups` (type: `array`):

Optional. Leave empty.

## Actor input object example

```json
{
  "search": [
    "Paris, France"
  ],
  "adults": 1,
  "children": 0,
  "infants": 0,
  "pets": 0,
  "maxListings": 50,
  "currency": "USD",
  "includeListingDetails": true,
  "includeImages": true,
  "includeAmenities": true,
  "includeHostInfo": true,
  "includeReviewsSummary": true,
  "useApifyProxy": true
}
```

# Actor output Schema

## `records` (type: `string`):

All Airbnb listing records produced by this run.

## `overview` (type: `string`):

Dataset presented in Apify Console.

# 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 = {
    "search": [
        "Paris, France"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/airbnb-listings-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 = { "search": ["Paris, France"] }

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automly/airbnb-listings-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/OFvdzb0YmuyliWb5M/builds/jD0ZsrBiwBSts6ate/openapi.json