# Airbnb Scraper: Listings, Hosts, Business Contacts (`herus13/airbnb-scraper`) Actor

Scrape Airbnb listings by location search, listing link or host, with no login. Every row carries listing_id, name, price, rating, amenities, location, host and the host business disclosure. Export JSON, CSV or Excel.

- **URL**: https://apify.com/herus13/airbnb-scraper.md
- **Developed by:** [herus13](https://apify.com/herus13) (community)
- **Categories:** Travel, E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 airbnb 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

The Airbnb Scraper extracts listings from Airbnb by location search, listing link or host profile, with no login and no API key. Get one clean row per listing with its price, rating, amenities, location and host, plus the business disclosure Airbnb publishes for professional hosts in the EU and UK.

### What you get

One row per listing. It carries the title, property and room type, guest capacity, coordinates, neighbourhood and city, rating and review count, the amenity list and badges, the host's name, rating, response rate and Superhost status, and the total price for the stay, for your dates when you set them.

```json
{
  "kind": "listing",
  "listing_id": "12345678",
  "url": "https://www.airbnb.com/rooms/12345678",
  "name": "Bright loft near Canal Saint-Martin",
  "property_type": "Entire loft",
  "room_type": "Entire home/apt",
  "person_capacity": 4,
  "latitude": 48.8721,
  "longitude": 2.3622,
  "city": "Paris",
  "country": "France",
  "rating": 4.87,
  "review_count": 212,
  "amenities": ["Wifi", "Kitchen", "Washer"],
  "badges": ["Guest favourite"],
  "currency": "USD",
  "price_label": "$142 night",
  "host_id": "98765",
  "host_name": "Example Host",
  "host_is_superhost": true,
  "host_rating": 4.9,
  "dsa_disclosure": true,
  "host_type": "Professional",
  "business_name": "Example Stays SARL",
  "business_registration_number": "123 456 789",
  "business_email": null,
  "business_phone": null,
  "business_address": null,
  "source": "search",
  "source_input": "Paris, France",
  "scraped_at": "2026-10-28T09:00:00Z",
  "_meta": {"author": "https://apify.com/herus13", "status": "ok", "message": null}
}
```

`_meta` is run metadata, not scraped data. Business name, registration and host type come from Airbnb's public disclosure of hosts that operate as businesses and are always returned where Airbnb shows them. The `business_email`, `business_phone` and `business_address` fields stay `null` unless you turn on Include business contact details.

### What it costs

| Event | Price |
|---|---|
| Actor Start (`apify-actor-start`) | $0.00005 |
| Airbnb listing (`listing`) | $0.002 |

You pay per delivered listing: $0.002 each, so 1,000 listings cost about $2.00, residential proxy included. Host business contact details, when you turn them on, come on the same listing row at no extra charge.

### Input

| Field | Type | Required | Default | What it does |
|---|---|---|---|---|
| `queries` | array | no | — | Places to search for stays, one per entry, for example `Paris, France` or `Lisbon`. Every search returns the listings Airbnb shows for the place. One search lists about 300 results at most; to go deeper the run splits the map into smaller areas and removes duplicates. Leave empty if you give listings or hosts instead; give at least one search, listing or host. |
| `listings` | array | no | — | Listings to read directly, one per entry, for example `https://www.airbnb.com/rooms/12345678` or `12345678`. Leave empty if you give searches or hosts instead; give at least one search, listing or host. |
| `hosts` | array | no | — | Hosts whose listings you want, one per entry, for example `https://www.airbnb.com/users/show/12345678` or `12345678`. Every listing of the host is returned, up to the cap below. Leave empty if you give searches or listings instead; give at least one search, listing or host. |
| `check_in` | string | no | — | Check-in day, written as YYYY-MM-DD, for example 2026-12-20. Setting it prices every row for that stay. Must be set together with the check-out date. Leave both empty and Airbnb quotes a default stay a few weeks ahead, shown on each row. Leave empty for no dates. |
| `check_out` | string | no | — | Check-out day, written as YYYY-MM-DD, after the check-in date. Must be set together with the check-in date. Leave empty for no dates. |
| `adults` | integer | no | `1` | Number of adult guests the price is quoted for. Default 1, minimum 1, maximum 16. |
| `min_price` | integer | no | — | Only searches: keep stays at or above this nightly price, in the currency below. Minimum 0. Leave empty for no lower bound. |
| `max_price` | integer | no | — | Only searches: keep stays at or below this nightly price, in the currency below. Minimum 0. Leave empty for no upper bound. |
| `currency` | string | no | `"USD"` | Currency the prices are quoted in: USD, EUR, GBP, AUD, CAD, CHF, JPY, SGD or VND. Default USD. |
| `max_listings_per_search` | integer | no | `100` | How many listings to return for each location search. Default 100, minimum 0, maximum 10000. Set 0 to skip the searches. One search lists about 300 results; larger values make the run split the map into smaller areas. |
| `max_listings_per_host` | integer | no | `100` | How many listings to return for each host. Default 100, minimum 0, maximum 1000. Set 0 to skip the hosts. |
| `include_business_contacts` | boolean | no | `false` | Airbnb publishes the name, registration, email, phone and address of hosts that operate as businesses (EU and UK listings). Business name, registration and host type are always returned; turn this on to also return the email, phone and address. For sole traders these may be personal data, so you need a lawful basis to process them and are responsible for doing so under GDPR. Default false (off). |
| `proxyUrls` | array | no | — | Leave empty: the run uses the residential proxy this actor ships with, included in the price of the run. To route the run through your own provider instead, add one gateway URL per entry, for example `http://user:pass@host:port` — works with any provider that issues URLs. When set, the run uses these first and switches to the included proxy if they stop working, so a broken proxy never fails the run. |

### How to run it

1. Add location searches, listing links or host profile links. You can mix all three in one run.
2. Optionally set check-in and check-out dates, the number of adults, a nightly price range and a currency.
3. Set how many listings to return per search and per host.
4. Run it and export the dataset as JSON, CSV or Excel.

The first 200 stays in Lisbon for a week in December, priced for two adults in euros:

```json
{
  "queries": ["Lisbon, Portugal"],
  "check_in": "2026-12-14",
  "check_out": "2026-12-21",
  "adults": 2,
  "currency": "EUR",
  "max_listings_per_search": 200
}
```

Minimal input:

```json
{
  "queries": ["Paris, France"]
}
```

Available as the MCP tool `herus13--airbnb-scraper` on mcp.apify.com, so an AI agent can call it with the same input.

### Business contact details

Turning on Include business contact details adds the email, phone and address that a professional host has published in Airbnb's business disclosure. For sole traders these can be personal data. You decide why and how you use them, and you are responsible for having a lawful basis to process them, including under the GDPR. The option is off by default and the listing data does not depend on it.

The business name, registry and registration number are always returned where Airbnb shows them. For a sole trader the business name can be the person's own name, so these fields can be personal data too, and the same responsibility applies to them.

### Use cases

- **Market and pricing research**: compare nightly prices, ratings and amenities across a city or a neighbourhood for the dates you care about.
- **Competitor tracking for hosts and managers**: follow the listings of a host or a rival property manager and watch how their portfolio changes.
- **Investment and location analysis**: map supply by property type, capacity and rating to see where demand is likely to be.
- **Regulation and compliance monitoring**: check which listings in the EU and UK carry a business disclosure and who is behind them.
- **Lead generation for services**: find professional hosts and operators in a city for cleaning, management or software offers, using the business contact option where you have a lawful basis.
- **Datasets for AI**: build a clean table of stays with amenities and ratings for recommendation or valuation models.

### FAQ

**Does it need an Airbnb account or API key?** No. It reads what any visitor can see, without logging in.

**How many listings can one search return?** Airbnb shows about 300 results for one search. To go deeper the run splits the map into smaller areas, searches each one and removes duplicates, up to the limit you set per search.

**Which dates is the price for?** The dates and guests you set. Without dates, Airbnb quotes a default stay a few weeks ahead, and each row shows its `check_in` and `check_out`. The price is empty when a listing is not bookable on those dates.

**Which listings carry a business disclosure?** Hosts that Airbnb marks as businesses, for stays in the EU and UK. The run uses an EU exit by default because Airbnb shows this block to EU and UK visitors only. Listings elsewhere have no disclosure and return `dsa_disclosure` false.

**Can I use my own proxy?** Yes. Paste gateway URLs into Your own proxy URLs and the run uses them first, then falls back to the included residential proxy if they fail. Keep in mind that the business disclosure is shown to EU and UK visitors only.

**Is the data fresh?** Every run reads Airbnb live, so rows reflect the moment of the run, and each row carries its `scraped_at` time.

**I use another Airbnb actor. Do I have to rewrite my input?** Usually not. Over the API or MCP, the run also reads the input of the most-used Airbnb actors as you would send it to them: `locationQueries` or `location` for searches, `startUrls` or `urls` for links (room links become listings and host profile links become hosts), `checkIn`/`checkInDate` and `checkOut`/`checkOutDate` for dates, `priceMin`/`priceMax` for the price band and `maxResults`, `maxItems` or `count` for the cap. When you set one of our own fields, ours wins. A search link is not read (put its place in searches), and options this actor does not have, such as guest mix, bed counts, reviews or calendars, are not applied; the run's notice names them. A cap of 0 means zero here, except in the one form where 0 means all, which gets the default of 100. Each row also carries the column names of the most-used Airbnb actor (`id`, `coordinates`, `personCapacity`, `roomType`, `isSuperHost`, `host`, `price`, `androidLink`, `iosLink` and others), empty where we hold nothing, beside our own columns; where a name means something else here, such as `rating` or `amenities`, our column stays.

### Related actors

- [Google Maps Scraper](https://apify.com/herus13/google-maps-scraper) — places, reviews and business contacts from Google Maps.
- [Reddit Scraper](https://apify.com/herus13/reddit-scraper) — posts, comments and profiles from Reddit.

# Actor input Schema

## `queries` (type: `array`):

Places to search for stays, one per entry, for example `Paris, France` or `Lisbon`. Every search returns the listings Airbnb shows for the place. One search lists about 300 results at most; to go deeper the run splits the map into smaller areas and removes duplicates. Leave empty if you give listings or hosts instead; give at least one search, listing or host.

## `listings` (type: `array`):

Listings to read directly, one per entry, for example `https://www.airbnb.com/rooms/12345678` or `12345678`. Leave empty if you give searches or hosts instead; give at least one search, listing or host.

## `hosts` (type: `array`):

Hosts whose listings you want, one per entry, for example `https://www.airbnb.com/users/show/12345678` or `12345678`. Every listing of the host is returned, up to the cap below. Leave empty if you give searches or listings instead; give at least one search, listing or host.

## `check_in` (type: `string`):

Check-in day, written as YYYY-MM-DD, for example 2026-12-20. Setting it prices every row for that stay. Must be set together with the check-out date. Leave both empty and Airbnb quotes a default stay a few weeks ahead, shown on each row. Leave empty for no dates.

## `check_out` (type: `string`):

Check-out day, written as YYYY-MM-DD, after the check-in date. Must be set together with the check-in date. Leave empty for no dates.

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

Number of adult guests the price is quoted for. Default 1, minimum 1, maximum 16.

## `min_price` (type: `integer`):

Only searches: keep stays at or above this nightly price, in the currency below. Minimum 0. Leave empty for no lower bound.

## `max_price` (type: `integer`):

Only searches: keep stays at or below this nightly price, in the currency below. Minimum 0. Leave empty for no upper bound.

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

Currency the prices are quoted in: USD, EUR, GBP, AUD, CAD, CHF, JPY, SGD or VND. Default USD.

## `max_listings_per_search` (type: `integer`):

How many listings to return for each location search. Default 100, minimum 0, maximum 10000. Set 0 to skip the searches. One search lists about 300 results; larger values make the run split the map into smaller areas.

## `max_listings_per_host` (type: `integer`):

How many listings to return for each host. Default 100, minimum 0, maximum 1000. Set 0 to skip the hosts.

## `include_business_contacts` (type: `boolean`):

Airbnb publishes the name, registration, email, phone and address of hosts that operate as businesses (EU and UK listings). Business name, registration and host type are always returned; turn this on to also return the email, phone and address. For sole traders these may be personal data, so you need a lawful basis to process them and are responsible for doing so under GDPR. Default false (off).

## `proxyUrls` (type: `array`):

Leave empty: the run uses the residential proxy this actor ships with, included in the price of the run. To route the run through your own provider instead, add one gateway URL per entry, for example `http://user:pass@host:port` — works with any provider that issues URLs. When set, the run uses these first and switches to the included proxy if they stop working, so a broken proxy never fails the run.

## Actor input object example

```json
{
  "queries": [
    "Paris, France"
  ],
  "adults": 1,
  "currency": "USD",
  "max_listings_per_search": 100,
  "max_listings_per_host": 100,
  "include_business_contacts": false
}
```

# Actor output Schema

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

One row per listing, with its host and the host business disclosure. Each row also carries \_meta: run metadata, not scraped data.

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

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

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

```

## MCP server setup

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