# Airbnb Listing Scraper (`scrapyspider/airbnb-listing-scraper`) Actor

Extract property data from Airbnb listings. Get title, host details, coordinates, ratings, and business info in structured JSON. Supports single listings and search pages. No login required.

- **URL**: https://apify.com/scrapyspider/airbnb-listing-scraper.md
- **Developed by:** [ScrapySpider](https://apify.com/scrapyspider) (community)
- **Categories:** Travel, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 Listing Scraper

Extracts detailed property data from Airbnb listing pages — no account or cookies required — and returns structured JSON with title, host info, location coordinates, ratings, and business registration details.

- No Airbnb account or cookies needed
- Extracts host business details (name, registration number, email, phone)
- Identifies Business vs Individual hosts automatically
- Optional Google Maps geocoding converts lat/long to full street addresses
- Outputs clean, structured JSON ready for analysis or CRM import
- Handles both single listings and search result pages

#### What data does it extract?

Each result contains:

**Property info:** title, description (HTML), listing URL, rating (scaled to 10)

**Location:** region, latitude, longitude, map marker type (EXACT/APPROX), coordinates object, geocoded street address (with Google Maps API key)

**Host details:** host type (Business/Individual), managed by (host name), business name, trade register number, email, phone, registered address

All data is exported as JSON, CSV, or Excel via Apify's dataset export.

#### Use cases

- **Property management lead generation:** Identify business hosts with contact details for outreach
- **Market research:** Analyze Airbnb supply in a specific region — property types, host types, rating distribution
- **Competitor analysis:** Monitor listings managed by specific property management companies
- **Real estate intelligence:** Cross-reference Airbnb coordinates with property records using geocoded addresses
- **Compliance monitoring:** Track business registration details of commercial Airbnb operators
- **Data enrichment:** Combine listing data with your existing datasets via coordinates or host info

#### How to use

1. Click **Try for free** above
2. In the **Input** tab, paste one or more Airbnb listing URLs (e.g., `https://www.airbnb.com/rooms/12345`)
3. Optionally add a **Google Maps API Key** to convert coordinates to street addresses
4. Click **Start** and wait for the run to complete (typically 30–60 seconds per listing)
5. Download your results as JSON, CSV, or Excel from the **Output** tab

#### Input parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `startUrls` | Array of strings | Yes | Airbnb listing URLs to scrape. Example: `https://www.airbnb.com/rooms/1010720243416775815` |
| `googleMapsApiKey` | String | No | Google Maps Geocoding API key. If provided, converts lat/long to formatted street addresses. If omitted, only raw coordinates are returned. |
| `maxConcurrency` | Integer | No | Maximum parallel pages (1–10). Default: `2`. Higher values are faster but may trigger rate limiting. |
| `proxyConfiguration` | Object | No | Proxy configuration. Defaults to Apify Proxy. Recommended to leave as default. |

#### Output example

```json
{
    "url": "https://www.airbnb.com/rooms/1010720243416775815",
    "title": "Cozy Mountain Cabin with Hot Tub",
    "description": "<p>Welcome to our cozy mountain retreat with stunning views...</p>",
    "region": "Blue Ridge, Georgia, United States",
    "latitude": 34.8621,
    "longitude": -84.3241,
    "googleAddress": {
        "formatted_address": "123 Mountain View Rd, Blue Ridge, GA 30513",
        "street_number": "123",
        "route": "Mountain View Rd",
        "city": "Blue Ridge",
        "state": "GA",
        "postal_code": "30513"
    },
    "hostType": "Business",
    "businessName": "Mountain Retreats LLC",
    "tradeRegisterNumber": "HRB 12345",
    "email": "host@example.com",
    "phone": "+1-555-123-4567",
    "address": "123 Main St, Atlanta, GA 30301",
    "rating": 9.4,
    "managedBy": "John",
    "mapMarkerType": "EXACT",
    "coordinates": {
        "latitude": 34.8621,
        "longitude": -84.3241
    }
}
````

#### Pricing

This Actor is **free to use** — you only pay for Apify platform compute time and proxy usage.

A typical run scraping 10 listings costs approximately $0.10–$0.25 in Apify platform credits.

New Apify accounts receive $5 in free credits — enough for hundreds of listing scrapes.

#### Technical notes

- **No account needed:** This Actor does not require an Airbnb login, cookies, or session tokens
- **Proxy recommended:** Apify Proxy (residential) is recommended for best success rates. The default configuration uses Apify Proxy automatically.
- **Rate limiting:** Airbnb applies rate limiting on rapid requests. Keep `maxConcurrency` at 2–3 for reliable results. Increase cautiously.
- **Data freshness:** All data is scraped live from Airbnb — no cached or stale results
- **Location accuracy:** The output includes `mapMarkerType` (EXACT or APPROX) so you can filter by location precision
- **Google Maps API:** The geocoding feature requires a valid Google Maps Geocoding API key. Without it, raw latitude/longitude coordinates are still included.

#### Integrations

Outputs are compatible with:

- **Make (formerly Integromat):** Use the Apify module to trigger runs and send data to Google Sheets or Airtable
- **Zapier:** Connect Actor runs to 5,000+ apps via the Apify Zapier app
- **n8n:** Self-host and automate via the Apify n8n node
- **REST API:** Run the Actor programmatically and poll results via the [Apify API](https://docs.apify.com/api/v2)

#### Support

Have questions or found a bug? Reach out:

- **Email:** ScrapySpider@protonmail.com
- **Website:** [ScrapySpider.com](https://ScrapySpider.com)
- **GitHub:** [github.com/ScrapySpider-com](https://github.com/ScrapySpider-com)
- **Apify:** Open a support issue on this Actor page
- **Response time:** Within 24–48 hours on weekdays

# Actor input Schema

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

List of Airbnb listing URLs to scrape. Each URL should be a direct link to an Airbnb property page (e.g., https://www.airbnb.com/rooms/12345).

## `googleMapsApiKey` (type: `string`):

Optional Google Maps Geocoding API key. If provided, the scraper will convert latitude/longitude coordinates to formatted street addresses. If not provided, only raw coordinates will be included in the output.

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

Maximum number of pages to scrape in parallel. Higher values are faster but may trigger rate limiting.

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

Proxy configuration for the scraper. Use Apify Proxy or custom proxies.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.airbnb.com/rooms/1010720243416775815"
  ],
  "maxConcurrency": 2,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 = {
    "startUrls": [
        "https://www.airbnb.com/rooms/1010720243416775815"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapyspider/airbnb-listing-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 = {
    "startUrls": ["https://www.airbnb.com/rooms/1010720243416775815"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapyspider/airbnb-listing-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 '{
  "startUrls": [
    "https://www.airbnb.com/rooms/1010720243416775815"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scrapyspider/airbnb-listing-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Airbnb Listing Scraper",
        "description": "Extract property data from Airbnb listings. Get title, host details, coordinates, ratings, and business info in structured JSON. Supports single listings and search pages. No login required.",
        "version": "1.0",
        "x-build-id": "WxuDZOS2KnHn9fmQ6"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapyspider~airbnb-listing-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapyspider-airbnb-listing-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scrapyspider~airbnb-listing-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapyspider-airbnb-listing-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scrapyspider~airbnb-listing-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapyspider-airbnb-listing-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Airbnb Listing URLs",
                        "type": "array",
                        "description": "List of Airbnb listing URLs to scrape. Each URL should be a direct link to an Airbnb property page (e.g., https://www.airbnb.com/rooms/12345).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "googleMapsApiKey": {
                        "title": "Google Maps API Key (Optional)",
                        "type": "string",
                        "description": "Optional Google Maps Geocoding API key. If provided, the scraper will convert latitude/longitude coordinates to formatted street addresses. If not provided, only raw coordinates will be included in the output."
                    },
                    "maxConcurrency": {
                        "title": "Max Concurrency",
                        "minimum": 1,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Maximum number of pages to scrape in parallel. Higher values are faster but may trigger rate limiting.",
                        "default": 2
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Proxy configuration for the scraper. Use Apify Proxy or custom proxies."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```