# Airbnb Scraper β€” Listings, Prices & Details (`vero-api/airbnb-scraper`) Actor Search Airbnb by location and export clean listing data: prices, ratings, review counts, photos, coordinates, and Guest favorite status. Turn on full details to also get descriptions, amenities, house rules, highlights, and host info. Export to JSON, CSV, or Excel. - **URL**: https://apify.com/vero-api/airbnb-scraper.md - **Developed by:** [Veronica](https://apify.com/vero-api) (community) - **Categories:** Travel, Real estate, E-commerce - **Stats:** 4 total users, 1 monthly users, 95.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 listings 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 Airbnb Scraper lets you **extract Airbnb data** β€” listings, prices, ratings, amenities, host profiles, photos, descriptions, and house rules β€” from any city or neighborhood in the world and download it as **JSON, CSV, Excel, or XML**. It runs entirely in the cloud, needs no coding, and returns **hundreds of listings per minute**. Try it right away: enter a location in the input form, click **Start**, and watch the dataset fill up with structured Airbnb listing data. ### What data does Airbnb Scraper extract? | Data | Details | |---|---| | 🏠 **Listing** | title, name, property type, person capacity, bedrooms, beds, bathrooms, description, listing URL, ID | | πŸ’° **Prices** | total price for your dates, original vs. discounted price, price qualifier, any currency | | πŸ“ **Location** | exact coordinates (latitude/longitude), neighborhood and city, location-verified flag | | ⭐ **Ratings** | overall rating, number of reviews, Guest favorite badge, new-listing flag | | πŸ›οΈ **Amenities** | every amenity the place offers | | ✨ **Highlights** | standout features like Self check-in, great location, or dedicated workspace | | πŸ‘€ **Host** | name, ID, Superhost status, verification, rating, years hosting, about, co-hosts | | πŸ“· **Photos** | every listing photo URL, plus the main thumbnail | | πŸ“‹ **House rules** | house rules, safety & property info, and cancellation policy | ### How do I scrape Airbnb data? 1. **Enter a location** β€” a city, neighborhood, or region, e.g. `Paris, France`. 2. **Set your filters** *(optional)* β€” check-in and check-out dates, number of guests, price range, room types, minimum bedrooms/beds/bathrooms, currency, and language. 3. **Choose the depth** β€” how many listings you want, and whether to open every listing for full details (description, amenities, host, house rules). 4. **Click Start** β€” then download the results from the **Storage** tab in any format, or send them anywhere using integrations. ### How many Airbnb listings can I scrape? Airbnb returns up to roughly **280 listings per search**. Set *Maximum listings* to how many you want within that, and narrow your search with dates, price, and room-type filters to zero in on exactly the listings you care about. ### Fast by default, detailed on demand By default the scraper returns a rich result for every listing β€” title, price, rating, review count, photos, coordinates, bed info, and Guest favorite status β€” straight from search, **hundreds per minute**. Flip on **Include full details** to also open each listing for its description, amenities, host, highlights, and house rules. ### Why scrape Airbnb? - **Market research** β€” analyze supply, pricing, and competition in any city before investing in a short-term rental. - **Dynamic pricing** β€” monitor competitor nightly rates and discounts to price your own listings optimally. - **Real estate analysis** β€” evaluate the short-term rental potential of neighborhoods using real data. - **Travel products** β€” enrich your app or website with live accommodation data and photos. - **Vacation rental management** β€” track your portfolio's ratings across markets. - **Research & journalism** β€” study the impact of short-term rentals on housing markets. ### Input example ```json { "location": "Paris, France", "checkIn": "2026-08-10", "checkOut": "2026-08-15", "adults": 2, "currency": "USD", "priceMax": 300, "maxItems": 100, "includeDetails": true } ```` ### Output example (abridged) ```json { "id": "1617296724435086551", "url": "https://www.airbnb.com/rooms/1617296724435086551", "title": "Rental unit in Paris", "name": "Premium Studio - Golf view - Chic and peaceful setting", "propertyType": "Entire rental unit", "rating": 5, "reviewsCount": 5, "ratingLocalized": "5.0 (5)", "price": "$504", "priceQualifier": "for 5 nights", "latitude": 48.8566, "longitude": 2.3522, "badges": ["Guest favorite"], "isGuestFavorite": true, "isNewListing": false, "personCapacity": 2, "overview": ["2 guests", "1 bedroom", "1 bed", "1 bath"], "bedrooms": 1, "beds": 1, "bathrooms": 1, "description": "Luxury Studio with Golf View – Calm & Elegant…", "locationSummary": "Paris, Île-de-France, France", "isLocationVerified": true, "amenities": ["Wifi", "Kitchen", "TV", "Hair dryer"], "highlights": [{ "title": "Self check-in", "subtitle": "Check yourself in with the lockbox." }], "houseRules": { "rules": ["Check-in after 3:00 PM", "Checkout before 11:00 AM"], "safetyAndProperty": ["Smoke alarm installed"] }, "host": { "id": "493189568", "name": "Prestige Gallery Immo", "isSuperhost": true, "ratingAverage": 4.81, "ratingCount": 312, "yearsHosting": 3 }, "photos": ["https://a0.muscache.com/im/pictures/…"] } ``` ### FAQ #### Does Airbnb have an official API? Airbnb's official API is closed to the public β€” it's reserved for approved partners. Airbnb Scraper gives you the same kind of structured data through web scraping: run it on demand or on a schedule and get clean JSON straight from public Airbnb pages. #### Do I get Airbnb prices? Yes. Set check-in and check-out dates to get the exact total for that stay, including discounts, in any currency Airbnb supports. Without dates, Airbnb's flexible-dates pricing is used. #### How fast is it? In the default mode (search results), hundreds of listings per minute. With full details enabled, expect roughly one listing per second, with compute costs kept low. #### Can I run it on a schedule? Yes β€” use the **Schedule** option to run it hourly, daily, weekly, or with any cron expression, and pair it with webhooks or integrations to push fresh Airbnb data wherever you need it. ### Integrations Connect Airbnb Scraper to **Google Sheets, Make, Zapier, n8n, Slack, Airbyte**, or any tool via webhooks. Developers can start runs and fetch results programmatically with the [API](https://docs.apify.com/api/v2) using the JavaScript or Python clients β€” see the **API** tab for ready-made code examples. ### Feedback and feature requests Found a bug or missing a field you need? Open an issue in the **Issues** tab β€” feedback directly shapes what gets added next. # Actor input Schema ## `location` (type: `string`): Where do you want to search? Type a city, neighborhood, or region β€” e.g. "Paris, France". ## `checkIn` (type: `string`): Arrival date (YYYY-MM-DD). Add it to get real prices for your trip. Leave empty to browse without dates. ## `checkOut` (type: `string`): Departure date (YYYY-MM-DD). Use together with the check-in date. ## `adults` (type: `integer`): Number of adult guests. ## `children` (type: `integer`): Number of children. ## `infants` (type: `integer`): Number of infants. ## `pets` (type: `integer`): Number of pets. ## `priceMin` (type: `integer`): Only show places at or above this nightly price (in the chosen currency). ## `priceMax` (type: `integer`): Only show places at or below this nightly price (in the chosen currency). ## `roomTypes` (type: `array`): Pick the kinds of places to include. Leave empty to include them all. ## `minBedrooms` (type: `integer`): Only show places with at least this many bedrooms. ## `minBeds` (type: `integer`): Only show places with at least this many beds. ## `minBathrooms` (type: `integer`): Only show places with at least this many bathrooms. ## `currency` (type: `string`): Currency for all prices. ## `locale` (type: `string`): Language for titles and descriptions. ## `maxItems` (type: `integer`): How many listings you want. Leave the default to get a full page of results. ## `includeDetails` (type: `boolean`): Off by default for fast, light results β€” you still get title, price, rating, reviews, photos, location, and bed info. Turn on to also fetch each place's description, amenities, host, and capacity (this visits each listing, so larger searches take longer). ## Actor input object example ```json { "location": "Paris, France", "adults": 1, "currency": "USD", "locale": "en", "maxItems": 100, "includeDetails": false } ``` # Actor output Schema ## `results` (type: `string`): No description # 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": "Paris, France" }; // Run the Actor and wait for it to finish const run = await client.actor("vero-api/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": "Paris, France" } # Run the Actor and wait for it to finish run = client.actor("vero-api/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": "Paris, France" }' | apify call vero-api/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vero-api/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Scraper β€” Listings, Prices & Details", "description": "Search Airbnb by location and export clean listing data: prices, ratings, review counts, photos, coordinates, and Guest favorite status. Turn on full details to also get descriptions, amenities, house rules, highlights, and host info. Export to JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "uEKjUZpJWfkNHuxQU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vero-api~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vero-api-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/vero-api~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-vero-api-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/vero-api~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-vero-api-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": "Where do you want to search? Type a city, neighborhood, or region β€” e.g. \"Paris, France\"." }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Arrival date (YYYY-MM-DD). Add it to get real prices for your trip. Leave empty to browse without dates." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Departure date (YYYY-MM-DD). Use together with the check-in date." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Number of adult guests.", "default": 1 }, "children": { "title": "Children", "minimum": 0, "type": "integer", "description": "Number of children." }, "infants": { "title": "Infants", "minimum": 0, "type": "integer", "description": "Number of infants." }, "pets": { "title": "Pets", "minimum": 0, "type": "integer", "description": "Number of pets." }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only show places at or above this nightly price (in the chosen currency)." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only show places at or below this nightly price (in the chosen currency)." }, "roomTypes": { "title": "Room types", "type": "array", "description": "Pick the kinds of places to include. Leave empty to include them all.", "items": { "type": "string", "enum": [ "Entire home/apt", "Private room", "Hotel room", "Shared room" ], "enumTitles": [ "Entire place", "Private room", "Hotel room", "Shared room" ] } }, "minBedrooms": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Only show places with at least this many bedrooms." }, "minBeds": { "title": "Minimum beds", "minimum": 0, "type": "integer", "description": "Only show places with at least this many beds." }, "minBathrooms": { "title": "Minimum bathrooms", "minimum": 0, "type": "integer", "description": "Only show places with at least this many bathrooms." }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "AUD", "CAD", "CHF", "CNY", "JPY", "KRW", "INR", "BRL", "MXN", "AED", "SAR", "QAR", "SGD", "HKD", "TWD", "THB", "MYR", "IDR", "PHP", "VND", "TRY", "ZAR", "NZD", "SEK", "NOK", "DKK", "PLN", "CZK", "HUF", "RON", "BGN", "UAH", "MAD", "EGP", "GHS", "KES", "UGX", "KZT", "CLP", "COP", "CRC", "PEN", "UYU", "ILS" ], "type": "string", "description": "Currency for all prices.", "default": "USD" }, "locale": { "title": "Language", "enum": [ "ar", "az", "bg", "bs", "ca", "cs", "da", "de", "de-AT", "de-CH", "de-LU", "el", "en", "en-AE", "en-AU", "en-CA", "en-GB", "en-GY", "en-IE", "en-IN", "en-MT", "en-NZ", "en-SG", "en-ZA", "es", "es-AR", "es-BO", "es-BZ", "es-CL", "es-CO", "es-CR", "es-EC", "es-ES", "es-GT", "es-HN", "es-MX", "es-NI", "es-PA", "es-PE", "es-PY", "es-SV", "es-US", "es-VE", "et", "fi", "fr", "fr-BE", "fr-CA", "fr-CH", "fr-LU", "ga", "he", "hi", "hr", "hu", "hy", "id", "is", "it", "it-CH", "ja", "ka", "kn", "ko", "lt", "lv", "mk", "mr", "ms", "mt", "nl", "nl-BE", "no", "pl", "pt", "pt-PT", "ro", "ru", "sk", "sl", "sq", "sr", "sr-ME", "sv", "sw", "th", "tl", "tr", "uk", "vi", "xh", "zh", "zh-HK", "zh-TW", "zh-US", "zu" ], "type": "string", "description": "Language for titles and descriptions.", "default": "en" }, "maxItems": { "title": "Maximum listings", "minimum": 1, "type": "integer", "description": "How many listings you want. Leave the default to get a full page of results.", "default": 100 }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Off by default for fast, light results β€” you still get title, price, rating, reviews, photos, location, and bed info. Turn on to also fetch each place's description, amenities, host, and capacity (this visits each listing, so larger searches take longer).", "default": 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 } } } } } } } } } } ```