# Airbnb Scraper (`crawlerbros/airbnb-scraper`) Actor Scrape Airbnb listings, prices, ratings, host info, coordinates and photos for any location. Extract vacation rental data including nightly rates, superhost status, property types and guest reviews. - **URL**: https://apify.com/crawlerbros/airbnb-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Real estate, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 15 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.00 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Scrape Airbnb listings for any location worldwide. Extract property names, prices, ratings, host information, GPS coordinates, and photos from Airbnb search results. ### What can this scraper do? - **Search any location** -- Enter a city, neighborhood, or region to find available Airbnb listings - **Extract pricing** -- Get current prices, original prices, and price qualifiers (e.g., "for 5 nights") - **Ratings and reviews** -- Collect average ratings and review counts for each listing - **Host details** -- Identify Superhost status, verified hosts, and host profile photos - **GPS coordinates** -- Get precise latitude and longitude for every listing - **Property photos** -- Extract up to 10 listing photo URLs per property - **Date-specific search** -- Set check-in/check-out dates and guest count for accurate pricing - **No browser needed** -- Fast HTTP-based scraping without Playwright or browser overhead ### Input | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `location` | string | Yes | — | Location to search (e.g., "New York", "Paris, France", "Tokyo") | | `checkIn` | string | No | — | Check-in date in YYYY-MM-DD format | | `checkOut` | string | No | — | Check-out date in YYYY-MM-DD format | | `adults` | integer | No | 1 | Number of adult guests (1-16) | | `maxItems` | integer | No | 20 | Maximum number of listings to return (1-100) | | `proxy` | object | No | — | Proxy configuration for avoiding rate limits | #### Example input ```json { "location": "New York", "maxItems": 10 } ```` ```json { "location": "Paris, France", "checkIn": "2025-07-01", "checkOut": "2025-07-05", "adults": 2, "maxItems": 18 } ``` ### Output #### Listing fields | Field | Type | Description | |-------|------|-------------| | `id` | string | Unique Airbnb listing ID | | `url` | string | Direct link to the listing page | | `name` | string | Property name | | `type` | string | Property type and location (e.g., "Hotel in New York") | | `subtitle` | string | Short description snippet | | `price` | string | Current displayed price (e.g., "$722") | | `originalPrice` | string | Original price before discount, if applicable | | `priceQualifier` | string | Price context (e.g., "for 5 nights", "per night") | | `rating` | string | Average rating with review count (e.g., "4.68 (4274)") | | `isSuperhost` | boolean | Whether the host has Superhost status | | `isVerified` | boolean | Whether the host is verified | | `hostPhoto` | string | URL of the host's profile photo | | `latitude` | number | GPS latitude coordinate | | `longitude` | number | GPS longitude coordinate | | `photos` | array | Up to 10 listing photo URLs | | `searchUrl` | string | The Airbnb search URL used | | `scrapedAt` | string | ISO 8601 timestamp of when the data was scraped | #### Sample output ```json { "id": "12345678", "url": "https://www.airbnb.com/rooms/12345678", "name": "Cozy Studio in Midtown Manhattan", "type": "Room in New York", "subtitle": "Stay Near NYC Icons and Top-Rated Attractions", "price": "$150", "originalPrice": "$180", "priceQualifier": "per night", "rating": "4.85 (312)", "isSuperhost": true, "isVerified": true, "hostPhoto": "https://a0.muscache.com/im/pictures/user/...", "latitude": 40.7549, "longitude": -73.9840, "photos": [ "https://a0.muscache.com/im/pictures/...", "https://a0.muscache.com/im/pictures/..." ], "searchUrl": "https://www.airbnb.com/s/New-York/homes", "scrapedAt": "2025-06-01T12:00:00.000000+00:00" } ``` ### Use cases - **Market research** -- Analyze Airbnb pricing trends across different neighborhoods and cities - **Competitive analysis** -- Compare property types, prices, and ratings in a target area - **Travel planning** -- Find the best-rated and most affordable listings for your trip - **Real estate insights** -- Identify popular short-term rental areas using GPS coordinates - **Price monitoring** -- Track pricing changes for specific locations over time - **Data journalism** -- Collect rental market data for reporting and analysis ### Tips - **Proxy recommended** -- For consistent results, use a residential proxy to avoid rate limiting - **Date-specific pricing** -- Set check-in and check-out dates to get accurate total prices instead of per-night estimates - **Results per page** -- Airbnb returns up to 18 listings per search page - **Location format** -- Use common location names. The scraper handles URL encoding automatically ### FAQ **How many listings can I scrape?** Each search page returns up to 18 listings. Set `maxItems` to control how many you want (max 100). **Do I need to set check-in and check-out dates?** No. Without dates, Airbnb shows general pricing. With dates, you get exact total prices for your stay. **What proxy should I use?** Residential proxies work best. Datacenter proxies may be blocked by Airbnb. You can also try without a proxy first. **Why are some fields empty?** Not all listings have discounted prices, subtitles, or host photos. Empty strings are returned instead of null values. **Does this scraper need login credentials?** No. The scraper uses public Airbnb search pages that don't require authentication. **What locations are supported?** Any location that Airbnb supports -- cities, neighborhoods, regions, countries, and specific addresses worldwide. # Actor input Schema ## `location` (type: `string`): The location to search for Airbnb listings (e.g., 'New York', 'Paris, France', 'Tokyo'). ## `checkIn` (type: `string`): Check-in date in YYYY-MM-DD format (e.g., '2025-06-01'). Leave empty for general search without dates. ## `checkOut` (type: `string`): Check-out date in YYYY-MM-DD format (e.g., '2025-06-05'). Leave empty for general search without dates. ## `adults` (type: `integer`): Number of adult guests. Affects pricing and availability. ## `maxItems` (type: `integer`): Maximum number of Airbnb listings to scrape. The scraper returns up to 18 results per search page. ## `proxy` (type: `object`): Proxy settings for the scraper. Recommended for large-scale scraping to avoid rate limiting. ## Actor input object example ```json { "location": "New York", "adults": 1, "maxItems": 5 } ``` # Actor output Schema ## `listings` (type: `string`): Dataset containing scraped Airbnb listings with property names, nightly prices, ratings, superhost status, GPS coordinates, and photo URLs. # 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 = { "location": "New York", "maxItems": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/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 = { "location": "New York", "maxItems": 5, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/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 '{ "location": "New York", "maxItems": 5 }' | apify call crawlerbros/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Scraper", "description": "Scrape Airbnb listings, prices, ratings, host info, coordinates and photos for any location. Extract vacation rental data including nightly rates, superhost status, property types and guest reviews.", "version": "1.0", "x-build-id": "esFtunhp4Lyra3cpm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-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/crawlerbros~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-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/crawlerbros~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-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": [ "location" ], "properties": { "location": { "title": "Location", "type": "string", "description": "The location to search for Airbnb listings (e.g., 'New York', 'Paris, France', 'Tokyo')." }, "checkIn": { "title": "Check-in Date", "type": "string", "description": "Check-in date in YYYY-MM-DD format (e.g., '2025-06-01'). Leave empty for general search without dates." }, "checkOut": { "title": "Check-out Date", "type": "string", "description": "Check-out date in YYYY-MM-DD format (e.g., '2025-06-05'). Leave empty for general search without dates." }, "adults": { "title": "Number of Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests. Affects pricing and availability.", "default": 1 }, "maxItems": { "title": "Maximum Listings", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of Airbnb listings to scrape. The scraper returns up to 18 results per search page.", "default": 20 }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for the scraper. Recommended for large-scale scraping to avoid rate limiting." } } }, "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 } } } } } } } } } } ```