## Airbnb Listings & Pricing Scraper
**💰 $3.10 / 1 000 results** · pay only for results · no credit card to try
*We do the dirty work so your dataset stays clean.* 😈
Scrape Airbnb search-results pages into structured listing rows — price, rating, host, superhost status, bedrooms, and location, with optional detail-page amenities. Built for STR investors, dynamic-pricing tool builders, and market researchers who need clean, structured Airbnb data at scale.
San Francisco, CA. Required if searchUrl is not set — used to build the… |
| `searchUrl` | `string` | no | None | Full airbnb.com/s/.../homes search URL with your own filters already applied. Wins over… |
| `checkIn` | `string` | no | None | ISO date (YYYY-MM-DD). Appended as checkin; drives totalPrice on each row. |
| `checkOut` | `string` | no | None | ISO date (YYYY-MM-DD), must be after checkIn. Appended as checkout. |
| `guests` | `integer` | no | 1 | Number of adult guests. Appended as adults. |
| `maxResults` | `integer` | no | 50 | Hard cap on dataset rows. Pagination stops once this cap is hit. |
| `enableDetailEnrichment` | `boolean` | no | False | Fetch each emitted listing's /rooms/\ page for its amenities list. Off by default — multiplies… |
| `proxyCountry` | `string` | no | 'US' | 2-letter uppercase country code. Pins the residential proxy exit country for every request — never randomized. |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': True, 'apifyProxyGroups': \['RESIDENTIAL'], 'apifyProxyCountry': 'US'} | Apify Proxy spec. Airbnb is fronted by anti-bot defenses — residential exits pinned to proxyCountry are… |
#### Example input
```json
{
"location": "Austin, TX",
"maxResults": 3,
"enableDetailEnrichment": false,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
```
### 📤 Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `listing_id` | `string` | Airbnb listing ID. |
| `url` | `string` | Absolute URL to the listing's /rooms/enableDetailEnrichment is on; the base search payload rarely carries them.
- Review text, full calendar/availability, and Airbnb Experiences/Luxe listings are out of scope — only aggregate rating/review count and homes search are covered.
- Prices and currency are passed through exactly as Airbnb reports them — no currency conversion is performed.
### ❓ FAQ
**Do I need an Airbnb account or API key?**
No. Airbnb publishes no public API for this data. This Actor scrapes public search-results pages — see the Limitations section for what that means for reliability.
**Can I scrape a specific search with my own filters?**
Yes — apply your filters on airbnb.com, copy the resulting search URL, and paste it into searchUrl. It wins over location if both are set.
**Why do I need check-in/check-out dates?**
They're optional. Without them you get each listing's base nightly price. With both set, we also append them to the search and populate total\_price for the stay.
**What does detail-page enrichment add?**
Turning on enableDetailEnrichment fetches each emitted listing's own page for its amenities list. It's off by default because it roughly doubles the request volume.
**Why does this need a residential proxy?**
Airbnb fronts its search pages with anti-bot defenses. The default proxy configuration already requests a RESIDENTIAL exit pinned to your chosen country — leave it as-is for reliable results.
### 💬 Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console — we ship
fixes weekly and we read every report.
***
San Francisco, CA. Required if searchUrl is not set — used to build the Airbnb search URL.
## `searchUrl` (type: `string`):
Full airbnb.com/s/.../homes search URL with your own filters already applied. Wins over location if both are set.
## `checkIn` (type: `string`):
ISO date (YYYY-MM-DD). Appended as checkin; drives totalPrice on each row.
## `checkOut` (type: `string`):
ISO date (YYYY-MM-DD), must be after checkIn. Appended as checkout.
## `guests` (type: `integer`):
Number of adult guests. Appended as adults.
## `maxResults` (type: `integer`):
Hard cap on dataset rows. Pagination stops once this cap is hit.
## `enableDetailEnrichment` (type: `boolean`):
Fetch each emitted listing's /rooms/\ page for its amenities list. Off by default — multiplies request volume.
## `proxyCountry` (type: `string`):
2-letter uppercase country code. Pins the residential proxy exit country for every request — never randomized.
## `proxyConfiguration` (type: `object`):
Apify Proxy spec. Airbnb is fronted by anti-bot defenses — residential exits pinned to proxyCountry are required for reliable access.
## Actor input object example
```json
{
"location": "Austin, TX",
"searchUrl": null,
"checkIn": null,
"checkOut": null,
"guests": 1,
"maxResults": 50,
"enableDetailEnrichment": false,
"proxyCountry": "US",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the 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 '