# Airbnb Property Details Scraper (`crawlio/airbnb-property-scraper`) Actor Fast and reliable Airbnb scraper to extract full property details, pricing, availability, and calendar data. - **URL**: https://apify.com/crawlio/airbnb-property-scraper.md - **Developed by:** [Crawlio](https://apify.com/crawlio) (community) - **Categories:** Travel - **Stats:** 3 total users, 0 monthly users, 91.7% runs succeeded, NaN bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.00 / 1,000 results 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 Property Scraper ### What does Airbnb Property Scraper do? Airbnb Property Scraper enables you to get detailed property data, pricing, and availability from [Airbnb](https://www.airbnb.com) directly from listing URLs or IDs. Airbnb Property Scraper can scrape: - Full property details (title, description, amenities, host details, images) - Property summaries (lighter, faster payload) - Real-time pricing for specific dates - Detailed availability rules and blocked/open dates - Calendar availability for multiple months ### Why scrape Airbnb? Airbnb has millions of users and is a great source of data for real estate analysis, travel planning, competitive pricing research, and market intelligence. Here are just some of the ways you could use that data: - Track pricing and availability for specific properties over time - Build detailed property datasets for real estate modeling - Analyze host profiles and property reviews - Understand amenity trends in specific markets If you would like more inspiration on how scraping Airbnb could help your business or organization, check out our [industry pages](https://apify.com/industries). ### How to scrape Airbnb Property Details It's easy to scrape Airbnb with Airbnb Property Scraper. Just follow these few steps and you'll get your data in a few minutes. 1. Click on **Try for free**. 2. Select operation: - **Full property details** → Get all information about a listing - **Property summary** → Get basic information fast - **Pricing** → Get total prices for specific dates - **Availability** → Check open dates and rules - **Calendar** → Get a multi-month availability calendar 3. Enter the target listing URLs or IDs. 4. Click on **Run**. 5. When Airbnb Property Scraper has finished, preview or download your data from the **Dataset** tab. ### Supported operations The Actor supports five operations: - `property` — fetch full property details - `property_summary` — fetch a lighter summary of the property - `pricing` — fetch pricing for a specific stay window - `availability` — fetch availability rules and open dates - `calendar` — fetch monthly calendar availability --- #### Property Details **Example input:** ```json { "operation": "property", "property": { "url": "https://www.airbnb.com/rooms/1597685945984399331", "adults": 2, "nights": 2 } } ```` #### Property Summary **Example input:** ```json { "operation": "property_summary", "property_summary": { "url": "https://www.airbnb.com/rooms/1597685945984399331", "adults": 2, "nights": 2 } } ``` #### Pricing **Example input:** ```json { "operation": "pricing", "pricing": { "url": "https://www.airbnb.com/rooms/1597685945984399331", "checkin": "2026-05-20", "checkout": "2026-05-27", "adults": 2 } } ``` #### Availability **Example input:** ```json { "operation": "availability", "availability": { "url": "https://www.airbnb.com/rooms/1597685945984399331", "checkin": "2026-05-20", "checkout": "2026-05-27", "adults": 2 } } ``` #### Calendar **Example input:** ```json { "operation": "calendar", "calendar": { "listingId": "1597685945984399331", "month": 5, "year": 2026, "count": 3 } } ``` *** ### Is it legal to scrape Airbnb? Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend that you read our blog post: [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) # Actor input Schema ## `operation` (type: `string`): Choose the level of property detail you want. ## `property` (type: `object`): Configure settings for property input. ## `property_summary` (type: `object`): Configure settings for property summary input. ## `pricing` (type: `object`): Configure settings for pricing input. ## `availability` (type: `object`): Configure settings for availability input. ## `calendar` (type: `object`): Configure settings for calendar input. ## `proxyConfiguration` (type: `object`): Select proxies to be used. ## Actor input object example ```json { "operation": "property", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): One dataset item per requested listing. ## `runSummary` (type: `string`): Short summary stored in the OUTPUT record of the default key-value store. # 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 = { "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlio/airbnb-property-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 = { "proxyConfiguration": { "useApifyProxy": False } } # Run the Actor and wait for it to finish run = client.actor("crawlio/airbnb-property-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 '{ "proxyConfiguration": { "useApifyProxy": false } }' | apify call crawlio/airbnb-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlio/airbnb-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Property Details Scraper", "description": "Fast and reliable Airbnb scraper to extract full property details, pricing, availability, and calendar data.", "version": "0.1", "x-build-id": "JW6N4LBMwNRIqIVmo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlio~airbnb-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlio-airbnb-property-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/crawlio~airbnb-property-scraper/runs": { "post": { "operationId": "runs-sync-crawlio-airbnb-property-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/crawlio~airbnb-property-scraper/run-sync": { "post": { "operationId": "run-sync-crawlio-airbnb-property-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": { "operation": { "title": "Operation", "enum": [ "property", "property_summary", "pricing", "availability", "calendar" ], "type": "string", "description": "Choose the level of property detail you want.", "default": "property" }, "property": { "title": "Property input", "type": "object", "description": "Configure settings for property input.", "properties": { "url": { "title": "Listing URL", "type": "string", "description": "Single Airbnb listing URL.", "editor": "textfield", "prefill": "https://www.airbnb.com/rooms/1521077635925541411", "default": "https://www.airbnb.com/rooms/1521077635925541411" }, "urls": { "title": "Listing URLs", "type": "array", "description": "Optional batch list of Airbnb listing URLs.", "editor": "stringList", "items": { "type": "string" } }, "adults": { "title": "Adults", "type": "integer", "default": 2, "minimum": 1, "maximum": 16, "editor": "number", "description": "Number of adults for the stay. Used to calculate accurate pricing." }, "nights": { "title": "Auto-select nights", "type": "integer", "default": 2, "minimum": 1, "maximum": 30, "editor": "number", "description": "Number of nights to check for pricing/availability if specific dates are not provided." } }, "additionalProperties": false }, "property_summary": { "title": "Property summary input", "type": "object", "description": "Configure settings for property summary input.", "properties": { "url": { "title": "Listing URL", "type": "string", "description": "Single Airbnb listing URL.", "editor": "textfield", "prefill": "https://www.airbnb.com/rooms/1521077635925541411", "default": "https://www.airbnb.com/rooms/1521077635925541411" }, "urls": { "title": "Listing URLs", "type": "array", "description": "Optional batch list of Airbnb listing URLs.", "editor": "stringList", "items": { "type": "string" } }, "adults": { "title": "Adults", "type": "integer", "default": 2, "minimum": 1, "maximum": 16, "editor": "number", "description": "Number of adults for the stay. Used to calculate accurate pricing." }, "nights": { "title": "Auto-select nights", "type": "integer", "default": 2, "minimum": 1, "maximum": 30, "editor": "number", "description": "Number of nights to check for pricing/availability if specific dates are not provided." } }, "additionalProperties": false }, "pricing": { "title": "Pricing input", "type": "object", "description": "Configure settings for pricing input.", "properties": { "url": { "title": "Listing URL", "type": "string", "description": "Single Airbnb listing URL.", "editor": "textfield", "prefill": "https://www.airbnb.com/rooms/1521077635925541411", "default": "https://www.airbnb.com/rooms/1521077635925541411" }, "urls": { "title": "Listing URLs", "type": "array", "description": "Optional batch list of Airbnb listing URLs.", "editor": "stringList", "items": { "type": "string" } }, "checkin": { "title": "Check-in", "type": "string", "description": "Optional explicit check-in date in YYYY-MM-DD format.", "editor": "datepicker", "dateType": "absolute" }, "checkout": { "title": "Check-out", "type": "string", "description": "Optional explicit check-out date in YYYY-MM-DD format.", "editor": "datepicker", "dateType": "absolute" }, "adults": { "title": "Adults", "type": "integer", "default": 2, "minimum": 1, "maximum": 16, "editor": "number", "description": "Number of adults for the stay. Used to calculate accurate pricing." }, "nights": { "title": "Auto-select nights", "type": "integer", "default": 2, "minimum": 1, "maximum": 30, "editor": "number", "description": "Number of nights to check for pricing/availability if specific dates are not provided." } }, "additionalProperties": false }, "availability": { "title": "Availability input", "type": "object", "description": "Configure settings for availability input.", "properties": { "url": { "title": "Listing URL", "type": "string", "description": "Single Airbnb listing URL.", "editor": "textfield", "prefill": "https://www.airbnb.com/rooms/1521077635925541411", "default": "https://www.airbnb.com/rooms/1521077635925541411" }, "urls": { "title": "Listing URLs", "type": "array", "description": "Optional batch list of Airbnb listing URLs.", "editor": "stringList", "items": { "type": "string" } }, "checkin": { "title": "Check-in", "type": "string", "description": "Optional explicit check-in date in YYYY-MM-DD format.", "editor": "datepicker", "dateType": "absolute" }, "checkout": { "title": "Check-out", "type": "string", "description": "Optional explicit check-out date in YYYY-MM-DD format.", "editor": "datepicker", "dateType": "absolute" }, "adults": { "title": "Adults", "type": "integer", "default": 2, "minimum": 1, "maximum": 16, "editor": "number", "description": "Number of adults for the stay. Used to calculate accurate pricing." }, "nights": { "title": "Auto-select nights", "type": "integer", "default": 2, "minimum": 1, "maximum": 30, "editor": "number", "description": "Number of nights to check for pricing/availability if specific dates are not provided." } }, "additionalProperties": false }, "calendar": { "title": "Calendar input", "type": "object", "description": "Configure settings for calendar input.", "properties": { "url": { "title": "Listing URL", "type": "string", "description": "Single Airbnb listing URL to extract calendar data from.", "editor": "textfield", "prefill": "https://www.airbnb.com/rooms/1521077635925541411", "default": "https://www.airbnb.com/rooms/1521077635925541411" }, "month": { "title": "Calendar start month", "type": "integer", "minimum": 1, "maximum": 12, "editor": "number", "description": "Starting month for the calendar (1-12). If empty, defaults to the current month." }, "year": { "title": "Calendar start year", "type": "integer", "minimum": 2024, "maximum": 2035, "editor": "number", "description": "Starting year for the calendar (e.g. 2026). If empty, defaults to the current year." }, "count": { "title": "Calendar month count", "type": "integer", "default": 3, "minimum": 1, "maximum": 12, "editor": "number", "description": "Number of consecutive months of calendar data to extract." } }, "additionalProperties": false }, "proxyConfiguration": { "title": "Proxy Settings", "type": "object", "description": "Select proxies to be used.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```