# Airbnb Scraper (`scrapeflow/airbnb-scraper`) Actor 🏑 Airbnb Scraper (airbnb-scraper) helps you extract listings data from Airbnb quickly and reliably. πŸ“ Perfect for market research, pricing analysis, and property investment insights. ⚑ Automated scraping with clean, usable results. - **URL**: https://apify.com/scrapeflow/airbnb-scraper.md - **Developed by:** [ScrapeFlow](https://apify.com/scrapeflow) (community) - **Categories:** Travel, Real estate, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Multi-Listing Scraper (Apify Actor) =========================================== Purpose ------- High-speed Airbnb scraper for market research, price tracking, and geo coverage analysis. Python + async aiohttp with resilient proxy fallbacks and live dataset saving. Key Features ------------ - Concurrent scraping of search pages and listing details - Proxy ladder: direct β†’ datacenter β†’ residential (sticky) with clear log events - Cursor-based pagination and de-duplication - Rich fields: id, url, title, description, rating breakdown, price breakdown, coordinates, thumbnail, currency/locale - Live dataset pushes to avoid data loss - Retry with jitter (3 attempts) and light pacing Inputs (actor.json) ------------------- - `startItems` (required, array, stringList editor): keywords or Airbnb URLs, e.g. `["https://www.airbnb.com/s/London/homes", "Paris"]` - `sortOrder` (string): `relevance` | `price_asc` | `price_desc` (default: `relevance`) - `maxComments` (integer): review comments per listing (0 to skip) - `proxyConfiguration` (object): starts direct; on block β†’ datacenter; on next block β†’ residential and stays; all transitions logged - `maxItems` (integer): listings limit (default 20, max 5000) - `checkin` / `checkout` (string): `YYYY-MM-DD` (defaults: 2025-01-01 / 2025-01-08) - `currency` (string): currency code (default `USD`) - `locale` (string): locale header (default `en-US`) Proxy Strategy -------------- 1) No proxy by default 2) If blocked (HTTP 403/429): switch to datacenter proxy 3) If blocked again: switch to residential and keep it for the session 4) All escalations are logged via `Actor.log` Output (Dataset) ---------------- Each item includes: - `id`, `url`, `title`, `description`, `thumbnail` - `rating`: guestSatisfaction, reviewsCount, accuracy, cleanliness, communication, location, value - `price`: label, qualifier, price, breakdown (basePrice, total, placeholders for fees/discounts) - `coordinates`: latitude, longitude - `currency`, `locale` How to Run on Apify ------------------- 1) Deploy the actor. 2) In Apify Console, set input: `startItems`, adjust `maxItems`, dates, currency/locale, and proxy settings. 3) Run and monitor logs for proxy mode and progress. 4) Download results from the Dataset tab (JSON/CSV/XLSX). How to Run Locally ------------------ 1) Create `storage/key_value_stores/default/INPUT.json`: ```` { "startItems": \["https://www.airbnb.com/s/London/homes"], "maxItems": 5, "sortOrder": "relevance", "checkin": "2025-01-01", "checkout": "2025-01-08", "currency": "USD", "locale": "en-US", "proxyConfiguration": { "useApifyProxy": false } } ```` 2) From `Airbnb-Scraper/`: `python -m src` 3) Results: `storage/datasets/default` Logging You’ll See ------------------ - Start/end of run - Current proxy mode and any escalation - Page fetches, cursor updates, detail fetch batches - Retry warnings and errors per URL - Final β€œRun complete. Pushed N items.” SEO Keywords ------------ Airbnb scraper, Airbnb listings scraper, Airbnb data extraction, Airbnb price scraper, Apify Airbnb actor, Airbnb crawler Python, Airbnb market research, Airbnb dataset export, Airbnb automation, Airbnb proxy scraper. # Actor input Schema ## `locationQueries` (type: `array`): Examples: `london`, `paris`, or for the US `Austin--TX` so the right area is clear. Add one entry per line. πŸŒ† ## `startItems` (type: `array`): Optional: full Airbnb search URLs or other start links β€” we’ll figure out the place from them. πŸ”— ## `checkin` (type: `string`): When your stay starts β€” calendar date **or** relative (e.g. `14 days`, `2 weeks`). Future trip dates work best for live prices. πŸ“† ## `checkout` (type: `string`): When your stay ends β€” must be **after** check-in. Same calendar or relative style as above. πŸŒ… ## `currency` (type: `string`): Prices will be shown in this money format. πŸ’Ά ## `locale` (type: `string`): How Airbnb labels listings and prices for you (language/region). πŸ—£οΈ ## `maxItems` (type: `integer`): Stop after this many stays that **match your search** (and your area rules below). πŸ“Š ## `maxPages` (type: `integer`): Advanced: limit how many result pages to scroll. Leave empty and we’ll pick a sensible cap for you. πŸ“‘ ## `strictGeo` (type: `boolean`): When **on** βœ… we only keep stays that really belong to the area you meant (great when a city name exists in many countries). When **off**, more results may appear from nearby or similar names. 🌍 ## `state` (type: `string`): Optional dropdown of regions worldwide β€” pick the closest match, or none. US tip: you can also use `City--ST` in the location field. πŸ‡ΊπŸ‡Έ ## `country` (type: `string`): Optional: which country the place should be in (helps when two cities share a name). Leave empty if you’re sure. 🏳️ ## `proxyConfiguration` (type: `object`): Configure Apify Proxy if needed; otherwise we connect directly. ☁️ ## Actor input object example ```json { "locationQueries": [ "paris" ], "startItems": [ "https://www.airbnb.com/s/london/homes" ], "checkin": "2026-06-01", "checkout": "2026-06-08", "currency": "USD", "locale": "en-US", "maxItems": 10, "strictGeo": true, "state": "", "country": "", "proxyConfiguration": { "useApifyProxy": false } } ```` # 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 = { "locationQueries": [ "paris" ], "startItems": [ "https://www.airbnb.com/s/london/homes" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeflow/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 = { "locationQueries": ["paris"], "startItems": ["https://www.airbnb.com/s/london/homes"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scrapeflow/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 '{ "locationQueries": [ "paris" ], "startItems": [ "https://www.airbnb.com/s/london/homes" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call scrapeflow/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeflow/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Scraper", "description": "🏑 Airbnb Scraper (airbnb-scraper) helps you extract listings data from Airbnb quickly and reliably. πŸ“ Perfect for market research, pricing analysis, and property investment insights. ⚑ Automated scraping with clean, usable results.", "version": "0.1", "x-build-id": "XffchHojC0BkRtiAg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeflow~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeflow-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/scrapeflow~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-scrapeflow-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/scrapeflow~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeflow-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", "properties": { "locationQueries": { "title": "πŸ“ Location keywords", "type": "array", "description": "Examples: `london`, `paris`, or for the US `Austin--TX` so the right area is clear. Add one entry per line. πŸŒ†", "items": { "type": "string" } }, "startItems": { "title": "πŸ”— Or paste search links / URLs", "type": "array", "description": "Optional: full Airbnb search URLs or other start links β€” we’ll figure out the place from them. πŸ”—", "items": { "type": "string" } }, "checkin": { "title": "πŸ›ŽοΈ Check-in", "type": "string", "description": "When your stay starts β€” calendar date **or** relative (e.g. `14 days`, `2 weeks`). Future trip dates work best for live prices. πŸ“†", "default": "2026-06-01" }, "checkout": { "title": "πŸšͺ Check-out", "type": "string", "description": "When your stay ends β€” must be **after** check-in. Same calendar or relative style as above. πŸŒ…", "default": "2026-06-08" }, "currency": { "title": "πŸ’΅ Currency", "enum": [ "USD", "EUR", "GBP", "JPY", "AUD", "CAD", "CHF", "CNY", "INR", "BRL", "MXN", "SEK", "NOK", "DKK", "PLN", "NZD", "SGD", "HKD", "KRW", "TRY", "ZAR", "AED", "THB", "MYR", "PHP", "IDR", "CZK", "HUF", "ILS", "SAR", "CLP", "ARS", "COP", "PEN", "RON", "BGN", "HRK", "ISK", "TWD", "VND" ], "type": "string", "description": "Prices will be shown in this money format. πŸ’Ά", "default": "USD" }, "locale": { "title": "🌐 Language & region (locale)", "enum": [ "en-US", "en-GB", "en-AU", "en-CA", "en-IN", "en-IE", "fr-FR", "fr-CA", "de-DE", "es-ES", "es-MX", "es-AR", "it-IT", "pt-BR", "pt-PT", "ja-JP", "ko-KR", "zh-CN", "zh-TW", "nl-NL", "nl-BE", "sv-SE", "da-DK", "nb-NO", "fi-FI", "pl-PL", "ru-RU", "tr-TR", "el-GR", "cs-CZ", "hu-HU", "ro-RO", "uk-UA", "id-ID", "th-TH", "vi-VN", "ms-MY", "hi-IN", "he-IL", "ar-SA", "ca-ES", "hr-HR", "sk-SK", "sl-SI", "bg-BG", "lt-LT", "lv-LV", "et-EE" ], "type": "string", "description": "How Airbnb labels listings and prices for you (language/region). πŸ—£οΈ", "default": "en-US" }, "maxItems": { "title": "πŸ”’ Max stays", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many stays that **match your search** (and your area rules below). πŸ“Š", "default": 10 }, "maxPages": { "title": "πŸ“„ Max search pages (optional)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Advanced: limit how many result pages to scroll. Leave empty and we’ll pick a sensible cap for you. πŸ“‘" }, "strictGeo": { "title": "πŸ“Œ Strictly stay in my search area", "type": "boolean", "description": "When **on** βœ… we only keep stays that really belong to the area you meant (great when a city name exists in many countries). When **off**, more results may appear from nearby or similar names. 🌍", "default": true }, "state": { "title": "πŸ“ Region / state / province", "enum": [ "", "Addis Ababa", "Alberta", "Andalusia", "Antioquia", "Auckland", "Australian Capital Territory", "Baden-WΓΌrttemberg", "Bali", "Bangkok", "Bavaria", "Beijing", "Berlin", "BogotΓ‘ D.C.", "Brussels-Capital Region", "British Columbia", "Buenos Aires Province", "Busan", "California", "Cairo Governorate", "Casablanca-Settat", "Catalonia", "CΓ³rdoba", "Delhi", "Dubai", "Dublin", "Eastern Cape", "England", "Flanders", "Florida", "Gauteng", "Guangdong", "Hanoi", "Hokkaido", "Ho Chi Minh City", "Hong Kong", "Istanbul", "Jakarta", "Jalisco", "Kanagawa Prefecture", "Karnataka", "KwaZulu-Natal", "Lagos State", "Lazio", "Lesser Poland", "Lima Province", "Lombardy", "Madrid", "Maharashtra", "Manitoba", "Metropolitan Manila", "Mexico City", "Minas Gerais", "Moscow Oblast", "New Brunswick", "New South Wales", "New York", "North Holland", "North Rhine-Westphalia", "Northern Ireland", "Nova Scotia", "Ohio", "Ontario", "Oregon", "Osaka Prefecture", "Pennsylvania", "Provence-Alpes-CΓ΄te d'Azur", "Quebec", "Queensland", "Rio de Janeiro", "Riyadh Province", "Saint Petersburg", "Santiago Metropolitan", "Saskatchewan", "SΓ£o Paulo", "Scotland", "Seoul", "Shanghai", "Sichuan", "Singapore", "South Australia", "South Holland", "Stockholm County", "Taipei", "Tamil Nadu", "Tasmania", "Tel Aviv District", "Texas", "Tokyo", "Victoria", "Viken", "Wales", "Wallonia", "Wellington", "Western Australia", "Western Cape", "Zurich", "Île-de-France" ], "type": "string", "description": "Optional dropdown of regions worldwide β€” pick the closest match, or none. US tip: you can also use `City--ST` in the location field. πŸ‡ΊπŸ‡Έ", "default": "" }, "country": { "title": "🌎 Country", "enum": [ "", "United States", "United Kingdom", "Canada", "Australia", "France", "Germany", "Italy", "Spain", "Japan", "India", "Brazil", "Mexico", "Ireland", "Netherlands", "Portugal", "Belgium", "Austria", "Switzerland", "Sweden", "Norway", "Denmark", "Poland", "Czech Republic", "Hungary", "Greece", "Turkey", "South Korea", "China", "Taiwan", "Hong Kong", "Singapore", "New Zealand", "South Africa", "United Arab Emirates", "Saudi Arabia", "Israel", "Argentina", "Chile", "Colombia", "Thailand", "Malaysia", "Indonesia", "Philippines", "Vietnam", "Egypt", "Nigeria", "Russia", "Ukraine", "Romania", "Finland", "Croatia", "Slovenia", "Slovakia", "Bulgaria", "Serbia", "Iceland", "Luxembourg", "Estonia", "Latvia", "Lithuania", "Pakistan", "Bangladesh", "Peru", "Ecuador", "Uruguay", "Costa Rica", "Panama", "Morocco", "Kenya", "Qatar", "Kuwait", "Bahrain", "Oman", "Cyprus", "Malta", "Montenegro", "Albania", "North Macedonia" ], "type": "string", "description": "Optional: which country the place should be in (helps when two cities share a name). Leave empty if you’re sure. 🏳️", "default": "" }, "proxyConfiguration": { "title": "πŸ”Œ Proxy", "type": "object", "description": "Configure Apify Proxy if needed; otherwise we connect directly. ☁️" } } }, "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 } } } } } } } } } } ```