# airbnb-scraper (`scraptivo/airbnb-scraper`) Actor Search Airbnb listings by location and extract comprehensive property details including pricing, amenities, host info, reviews, images, and more. - **URL**: https://apify.com/scraptivo/airbnb-scraper.md - **Developed by:** [Scraptivo](https://apify.com/scraptivo) (community) - **Categories:** Real estate, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 properties 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/platform/actors/running/actors-in-store#pay-per-event ## 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 Scraper - Extract Unlimited Listing Data from Any Search Query **Scrape unlimited Airbnb listings** with full property details starting from just a **location or search query**. Enter "newyork", "paris beach house", or "tokyo apartment" and this Apify Actor automatically discovers every matching listing and extracts **comprehensive property data** — including pricing, amenities, host info, reviews, images, bedroom/bathroom details, location, and more. Powered by **Apify platform** for reliable cloud execution, automatic retries, proxy rotation, and seamless API access. Built on battle-tested scrapers used by thousands of users. ### Why Use This Airbnb Scraper? - **Search-to-data pipeline** — provide any search query, get complete listing details. No manual URL collection needed - **Comprehensive data extraction** — 50+ data points per listing: pricing, amenities, host profile, ratings, images, location, cancellation policy - **Auto-scaling concurrent architecture** — discovers and scrapes listings in parallel using producer-consumer pattern for maximum speed - **Built-in retry logic** — automatic retries with exponential backoff for failed requests - **Proxy rotation** — per-request proxy rotation (Apify Residential by default) prevents IP blocks - **Unlimited scale** — no cap on listings per run; control via maxListings or maxPages - **Multiple search queries** — scrape multiple locations in a single run ### How to Scrape Airbnb Listing Data 1. **Enter search queries** — provide one or more location queries (e.g. "newyork", "paris", "tokyo") 2. **Configure proxy** — Apify Residential proxies enabled by default for reliable scraping 3. **Set limits (optional)** — cap by max listings or max search pages to control cost 4. **Run the Actor** — execute on Apify platform or via API 5. **Download data** — export as JSON, CSV, Excel, HTML, or XML from the dataset ### Input Configure these fields in the **Input** tab when running the Actor: | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQueries` | `array[string]` | Yes | Location queries (e.g. `["newyork", "paris"]`) | | `maxListings` | `integer` | No | Max listings to scrape (0 = unlimited) | | `maxPages` | `integer` | No | Max search pages to scan (0 = unlimited) | | `proxyConfiguration` | `object` | No | Proxy settings (Apify Residential by default) | #### Input JSON Example ```json { "searchQueries": ["newyork", "paris"], "maxListings": 100, "maxPages": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Output Each dataset item is a complete Airbnb listing object. **Download in JSON, CSV, HTML, or Excel** from the Apify Console. ```json { "identifier": "1234567890123456789", "url": "https://www.airbnb.com/rooms/1234567890123456789", "active": true, "headline": "Stunning Manhattan studio with skyline views", "name": "Cozy Studio in Midtown East", "description": "Modern studio apartment in the heart of Manhattan...", "unit": { "name": "Cozy Studio in Midtown East", "category": "PROPERTY_TYPE_APARTMENT", "active": true }, "images": [ {"identifier": "123...", "url": "https://a0.muscache.com/...", "title": ""} ], "location": { "address": {"city": "New York", "subdivision": "NY", "country": "United States"}, "coordinates": {"lat": "40.7531", "lng": "-73.9822"}, "show_exact": true }, "host": { "host": {"name": "Jane", "profilePictureUrl": "https://..."}, "superhost": true, "verified": true, "stats": [ {"label": "Response rate", "value": "100%", "type": "percentage"}, {"label": "Response time", "value": "within an hour", "type": "text"} ] }, "rating": { "total_reviews": 142, "overall_rating": 4.85, "ratings": [ {"categoryType": "cleanliness", "label": "Cleanliness", "percentage": 95}, {"categoryType": "accuracy", "label": "Accuracy", "percentage": 93} ] }, "supplement": { "max_guests": 3, "allows_children": false, "allows_pets": false, "allows_events": true, "cancellation_policy": "MODERATE" }, "features": [{"name": "Wifi", "description": ""}, {"name": "Kitchen", "description": ""}], "safety_features": [{"name": "Smoke alarm", "note": ""}], "bathrooms": [{"name": "Bathroom 1", "category": "FULL_BATH", "amenities": []}], "bedrooms": [{"name": "Bedroom 1", "category": "BEDROOM", "amenities": []}] } ``` ### Data Fields | Field | Type | Description | |-------|------|-------------| | `identifier` | string | Airbnb listing ID | | `url` | string | Full listing URL | | `active` | boolean | Whether listing is active | | `headline` | string | SEO headline / og:description | | `name` | string | Listing title | | `description` | string | Full property description | | `unit` | object | Property type, name, category | | `images` | array | Property photos (URLs) | | `location` | object | Address + coordinates | | `host` | object | Host profile, superhost status, stats | | `rating` | object | Overall rating, review count, breakdown | | `features` | array | Amenities and property features | | `safety_features` | array | Safety equipment | | `bathrooms` | array | Bathroom details and amenities | | `bedrooms` | array | Bedroom details with bed types | | `supplement` | object | Max guests, pets/children/events policy, cancellation | ### Pricing: How Much Does It Cost to Scrape Airbnb? **$5 per 1,000 listings scraped.** Each run processes listings from search query to complete detail extraction in one pipeline. Cost examples: - **1,000 listings** → $0.50 (using free tier compute credits) or ~$5 flat - **10,000 listings** → ~$50 - **100,000 listings** → ~$500 Actual cost depends on `maxListings` and `maxPages`. Scrape exactly what you need. ### Recommended Proxy Providers - **Shifter** — Reliable residential proxies worldwide. Cheap rates. [Order Shifter Now](https://shifter.io/r/YoBB/order). Get 10% off with code `rigelbytes-YoBB`. - **OxyLabs** — 100M+ proxies. Fastest residential IPs with quality assurance. [Get Proxies](https://oxylabs.go2cloud.org/aff_c?offer_id=7\&aff_id=1366\&url_id=7) - **DataImpulse** — 200+ countries. Residential proxies from $1/GB. [Get Residential Proxies](https://dataimpulse.com/?aff=89421) [![Learn More About Proxies](https://img.shields.io/badge/Learn_More-About_Proxies-blue?style=for-the-badge)](#understanding-proxies) ### Running via Apify Console 1. Go to the Actor page on Apify Console 2. Click **Run** and fill in the **Input** tab 3. Provide at least one search query 4. Enable proxy (Apify Residential recommended) 5. Click **Start** and monitor progress ### Running via API #### Python ```python from apify_client import ApifyClient client = ApifyClient("") run_input = { "searchQueries": ["newyork"], "maxListings": 100, } run = client.actor("rigelbytes/airbnb-scraper").call(run_input=run_input) ``` #### JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const input = { "searchQueries": ["newyork"], "maxListings": 100, }; const run = await client.actor("rigelbytes/airbnb-scraper").call(input); ``` #### cURL ```bash API_TOKEN= cat > input.json <<'EOF' { "searchQueries": ["newyork"], "maxListings": 100 } EOF curl "https://api.apify.com/v2/acts/rigelbytes/airbnb-scraper/runs?token=$API_TOKEN" \ -X POST \ -d @input.json \ -H 'Content-Type: application/json' ``` ### Tips for Optimizing Runs - **Use specific queries** — "paris 3rd arrondissement" returns more targeted results than "paris" - **Set maxListings** — keep runs predictable by capping total listings - **Use residential proxies** — essential for large-scale scraping. Apify Residential proxies (enabled by default) rotate per request - **Multiple queries** — pass multiple search queries in one run for batch scraping - **Monitor logs** — Actor logs show discovery progress and any skipped listings ### FAQ, Disclaimers, and Support #### Is this legal? This tool scrapes publicly available data from Airbnb. Users are responsible for complying with Airbnb's Terms of Service and applicable laws. This scraper is designed for legitimate data analysis and research purposes. #### How fast is it? The scraper uses a concurrent producer-consumer architecture. Search pages are fetched sequentially (to respect rate limits), while listing detail pages are scraped in parallel (5 concurrent workers). A typical listing detail scrape takes 2-5 seconds. #### What happens if a listing fails? Failed listings are logged as warnings and skipped. The scraper continues with remaining listings. Automatic retries (3 attempts) handle transient failures. #### Need a custom solution? Contact us at contact@rigelbytes.com or [book an appointment](https://cal.com/faizanali/appointments) for custom scraping solutions. #### Other Tools by Rigel Bytes [Airbnb Images Downloader](https://apify.com/rigelbytes/airbnb-images-downloader) | [Airbnb Reviews Scraper](https://apify.com/rigelbytes/airbnb-reviews) | [Airbnb Availability Calendar](https://apify.com/rigelbytes/airbnb-availability-calendar) | [Airbnb Address Finder](https://apify.com/rigelbytes/airbnb-address-finder) | [Zillow Scraper](https://apify.com/rigelbytes/zillow-scraper) | [Google Maps Scraper](https://apify.com/rigelbytes/google-maps-scraper) ### Understanding Proxies Proxies act as intermediaries between your scraper and the target website, masking your IP address. #### Why Use Proxies? - **Avoid IP blocks** — prevent Airbnb from recognizing your scraper IP - **Access regional content** — proxies from different locations show local pricing/availability - **Scale reliably** — rotating proxies distribute requests across many IPs #### Types of Proxies 1. **Residential Proxies** — Real ISP-assigned IPs. Hardest to detect. Best for long-term scraping. 2. **Data Center Proxies** — Cheaper, faster, but easier to detect and block. 3. **Mobile Proxies** — Carrier IPs (3G/4G/5G). Very hard to detect. #### Rotating vs. Straight Proxies - **Rotating** — different IP per request. Essential for Airbnb scraping at scale. - **Straight** — same IP for all requests. Higher risk of detection. ### About Rigel Bytes Rigel Bytes specializes in web scraping, automation, and data analytics. We help businesses extract and leverage valuable data for informed decision-making. ### Contact Us Ready to unlock the power of data? Reach out to us at contact@rigelbytes.com or [book an appointment](https://cal.com/faizanali/appointments) to learn more about how we can help you achieve your data goals. # Actor input Schema ## `searchQueries` (type: `array`): List of locations or search queries to scrape Airbnb listings from (e.g. "newyork", "paris", "tokyo") ## `maxListings` (type: `integer`): Maximum number of listings to scrape (0 = unlimited) ## `maxPages` (type: `integer`): Maximum number of search result pages to scan (0 = unlimited) ## `scrapeCalendar` (type: `boolean`): Extract 12-month availability calendar for each listing. ## `proxyConfiguration` (type: `object`): Proxy settings for anti-bot protection. Apify Residential proxies recommended ## Actor input object example ```json { "searchQueries": [ "newyork" ], "maxListings": 0, "maxPages": 0, "scrapeCalendar": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `dataset` (type: `string`): Link to the default dataset containing all scraped listings ## `run` (type: `string`): Link to the run 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "newyork" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scraptivo/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["newyork"] } # Run the Actor and wait for it to finish run = client.actor("scraptivo/airbnb-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 '{ "searchQueries": [ "newyork" ] }' | apify call scraptivo/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraptivo/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "airbnb-scraper", "description": "Search Airbnb listings by location and extract comprehensive property details including pricing, amenities, host info, reviews, images, and more.", "version": "0.0", "x-build-id": "lClcJg2OBzu12sMok" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraptivo~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraptivo-airbnb-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/scraptivo~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-scraptivo-airbnb-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/scraptivo~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-scraptivo-airbnb-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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "List of locations or search queries to scrape Airbnb listings from (e.g. \"newyork\", \"paris\", \"tokyo\")" }, "maxListings": { "title": "Max Listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape (0 = unlimited)", "default": 0 }, "maxPages": { "title": "Max Search Pages", "minimum": 0, "type": "integer", "description": "Maximum number of search result pages to scan (0 = unlimited)", "default": 0 }, "scrapeCalendar": { "title": "Extract Listing Calendar", "type": "boolean", "description": "Extract 12-month availability calendar for each listing.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings for anti-bot protection. Apify Residential proxies recommended", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```