# Airbnb Listing Details, Host & Amenities Scraper (`integrative_tangent/airbnb-listing-scraper`) Actor Scrape complete Airbnb listing data worldwide — title, amenities, photos, 6 sub-ratings, host profile, house rules & cancellation policy. Works with IDs, URLs, bounding box, or any city name globally. - **URL**: https://apify.com/integrative\_tangent/airbnb-listing-scraper.md - **Developed by:** [Luis Segura](https://apify.com/integrative_tangent) (community) - **Categories:** Travel, Real estate, E-commerce - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 listing scrapeds 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 Listing Details, Host & Amenities Scraper **The deepest Airbnb listing scraper on Apify — full PDP data, host profile, 40+ fields per property, pulled cleanly into JSON, CSV, or your database.** Most Airbnb scrapers give you a search-result card and call it a day. This actor scrapes the **complete Property Detail Page** for every listing — the title, description, amenities, photos, sub-ratings, cancellation policy, house rules, and the full host profile — the data you actually need for market research, competitive analysis, and investment due diligence. ### What you get For every listing, the actor returns: - **Listing basics** — title, description, neighborhood overview, property type, room type - **Capacity** — bedrooms, beds, bathrooms, maximum guests - **Location** — precise latitude and longitude - **Ratings** — overall rating plus six sub-ratings (accuracy, cleanliness, check-in, communication, location, value) - **House rules** — check-in time, check-out time, minimum and maximum nights, cancellation policy - **Host profile** — name, about text, thumbnail, superhost status, identity verification, response rate and time, total listings, Airbnb join date - **Amenities** — full list per listing - **Photos** — total count plus every photo URL ### Why use this actor - **Bulk-capable** — point it at a bounding box or a city name and it will discover every listing in the area and enrich each one with full PDP data. No per-listing manual work. - **Null-safe** — fields that could not be extracted are returned as `null` rather than missing, so downstream pipelines never break on unexpected shapes. - **Precision-safe** — listing IDs are handled as strings throughout the pipeline, so you never lose data to JavaScript number precision, and non-listing numerics (timestamps, review IDs) are filtered out before they pollute your dataset. - **Adaptive rate limiting** — the actor speeds up when Airbnb is responsive and automatically backs off on HTTP 429 / 403, so long runs don't die halfway. - **Session rotation built in** — Playwright rotates cookies automatically; you don't need to babysit expired sessions. - **5 ways to define input** — direct IDs, URLs, search-page URLs, bounding boxes, or plain location names. - **Tested at scale** — validated against 40,000+ real listings across 20+ markets with 99.9% success rate. ### Input modes | Mode | Field | Use case | | ----- | -------------- | --------------------------------------------------- | | **A** | `listingIds` | You already know which listings to enrich | | **B** | `urls` | Copy-paste listing URLs from your browser | | **C** | `searchUrl` | Paste an Airbnb search page URL with map view | | **D** | `boundingBox` | Define a geographic rectangle by lat/lng corners | | **E** | `location` | Just type "Paris, France" or "Nice, France" | Provide **one** of these — the actor will resolve it to the listing IDs and pull full PDP data for each. ### Example inputs #### Mode A — Specific listing IDs ```json { "listingIds": ["16350344", "23137877"], "proxyConfiguration": { "useApifyProxy": true } } ```` #### Mode D — All listings in a bounding box (central Paris) ```json { "boundingBox": { "ne_lat": 48.88, "ne_lng": 2.40, "sw_lat": 48.82, "sw_lng": 2.29 }, "maxListings": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` #### Mode E — An entire city by name ```json { "location": "Nice, France", "maxListings": 50, "proxyConfiguration": { "useApifyProxy": true } } ``` ### Example output One record per listing: ```json { "listingId": "16350344", "details": { "listingId": "16350344", "title": "Rental unit in Suresnes · ★4.92 · 1 bedroom · 1 bed · 1 bath", "neighborhoodOverview": "Suresnes, Île-de-France, France", "maxGuests": 2, "latitude": 48.87317, "longitude": 2.23495, "overallRating": 4.92, "reviewCount": 457, "ratingAccuracy": 4.9, "ratingCleanliness": 4.9, "ratingCheckin": 5, "ratingCommunication": 5, "ratingLocation": 4.9, "ratingValue": 4.9, "houseRules": "2 guests maximum", "checkInTime": "Check-in: 4:00 PM - 2:00 AM", "checkOutTime": "Checkout before 11:00 AM", "cancellationPolicy": "Firm", "hostId": "4188395", "hostName": "Mehdi", "hostAbout": "Nature and animals lover. I'm a calm person fan of meditation.", "hostIsSuperhost": true, "hostResponseRate": "100%", "hostResponseTime": "Responds within an hour", "hostJoinDate": "2012-12-01", "amenities": ["City skyline view", "Bathtub", "Hair dryer", "Cleaning products", "Shampoo", "Conditioner", "Body soap", "Outdoor shower", "Hot water", "Shower gel", "Free washer – In unit", "Free dryer – In unit", "…"], "url": "https://www.airbnb.com/rooms/16350344" }, "scrapedAt": "2026-04-13T22:31:44.000Z" } ``` ### Use cases - **Market research** — pull every listing in a city and analyze property-type mix, amenity trends, and pricing tiers - **Competitive analysis** — track a rival's full PDP over time to see when they add amenities, change photos, or tweak descriptions - **Investment due diligence** — evaluate a short-term rental opportunity by comparing host quality, rating composition, and market saturation - **Host recruiting** — build lists of experienced superhosts in a target market - **Property-management lead generation** — identify self-managed listings with low ratings that might welcome professional management - **Academic research** — amenity-level analysis, rating distribution studies, platform-dynamics research - **Travel-tech product development** — seed your own inventory database before launching a comparison or booking product ### Performance - \~1–2 listings/second at default rate (tunable up to 3/sec) - 100 listings in ~1–2 minutes - 1,000 listings in ~10–15 minutes - Memory: ~1 GB (Playwright is used throughout for PDP rendering) ### Proxy recommendations For large runs, use **Apify Proxy with the residential group** for best reliability. The actor also works without a proxy for small runs or quick tests, but residential is strongly recommended for anything over 200 listings. ### Pairs well with - **Airbnb Calendar & Availability Scraper** — for day-by-day nightly pricing and booking calendars - **Airbnb Reviews Sentiment Analyzer** — for full review text plus sentiment classification per review ### Integrations Results can be exported to JSON, CSV, Excel, or piped into Google Sheets, Zapier, Make, Slack, or any HTTP endpoint via the built-in Apify integrations. A direct **Supabase sync** is also available — provide your project URL and service key in the optional advanced section and results land straight into your `listings` table. ### Pricing This actor is priced per **listing successfully scraped** using Apify's Pay-Per-Event model — you only pay for listings that returned data, never for failures or empty responses. ### Legal Use this actor only for data that Airbnb makes publicly available. You are responsible for complying with Airbnb's Terms of Service and any applicable laws in your jurisdiction (including GDPR, CCPA, and local data-protection rules). This actor does not scrape private messages, reservation data, or authenticated content. ### Support Found a bug or have a feature request? Open an issue on the actor's page or reach out through the Apify console. Pull requests and suggestions welcome. # Actor input Schema ## `listingIds` (type: `array`): Airbnb listing IDs to scrape. Example: \["16350344", "23137877"]. Always provide as strings to avoid precision loss. ## `urls` (type: `array`): Airbnb listing page URLs. Example: \["https://www.airbnb.com/rooms/16350344"] ## `searchUrl` (type: `string`): An Airbnb search results page URL. The actor will extract the map bounding box and discover every listing in that area. Example: "https://www.airbnb.com/s/Paris--France/homes?ne\_lat=48.88\&ne\_lng=2.40\&sw\_lat=48.82\&sw\_lng=2.29\&search\_by\_map=true" ## `boundingBox` (type: `object`): Geographic bounding box to search for listings. Provide as JSON: { "ne\_lat": 48.88, "ne\_lng": 2.40, "sw\_lat": 48.82, "sw\_lng": 2.29 } (central Paris). ## `location` (type: `string`): Location name to search. The actor will resolve this to a geographic area. Example: "Paris, France" or "Nice, France". ## `maxListings` (type: `integer`): Maximum number of listings to process. Set to 0 for unlimited. Useful for testing runs. ## `requestsPerSecond` (type: `number`): Starting request rate. The actor adapts automatically — backs off on rate limits and speeds up when safe. Range: 0.3–3. Default: 1.5 (PDP pages are heavier than calendar endpoints). ## `proxyConfiguration` (type: `object`): Configure proxy settings. Recommended: use Apify Proxy with residential group for best results. ## `supabaseUrl` (type: `string`): If you want to sync results directly into your own Supabase database, provide the project URL here. ## `supabaseKey` (type: `string`): Service-role key for your Supabase project. Only used if Supabase URL is provided. ## `supabaseZoneId` (type: `string`): UUID of the zone in your Supabase 'zones' table to attach listings to. Only used with Supabase sync. ## Actor input object example ```json { "maxListings": 0, "requestsPerSecond": 1.5 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("integrative_tangent/airbnb-listing-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 = {} # Run the Actor and wait for it to finish run = client.actor("integrative_tangent/airbnb-listing-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 '{}' | apify call integrative_tangent/airbnb-listing-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=integrative_tangent/airbnb-listing-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Listing Details, Host & Amenities Scraper", "description": "Scrape complete Airbnb listing data worldwide — title, amenities, photos, 6 sub-ratings, host profile, house rules & cancellation policy. Works with IDs, URLs, bounding box, or any city name globally.", "version": "1.0", "x-build-id": "0mqAv0Sv9yVQdWUW1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/integrative_tangent~airbnb-listing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-integrative_tangent-airbnb-listing-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/integrative_tangent~airbnb-listing-scraper/runs": { "post": { "operationId": "runs-sync-integrative_tangent-airbnb-listing-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/integrative_tangent~airbnb-listing-scraper/run-sync": { "post": { "operationId": "run-sync-integrative_tangent-airbnb-listing-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": { "listingIds": { "title": "Listing IDs", "type": "array", "description": "Airbnb listing IDs to scrape. Example: [\"16350344\", \"23137877\"]. Always provide as strings to avoid precision loss.", "items": { "type": "string" } }, "urls": { "title": "Listing URLs", "type": "array", "description": "Airbnb listing page URLs. Example: [\"https://www.airbnb.com/rooms/16350344\"]", "items": { "type": "string" } }, "searchUrl": { "title": "Search URL", "type": "string", "description": "An Airbnb search results page URL. The actor will extract the map bounding box and discover every listing in that area. Example: \"https://www.airbnb.com/s/Paris--France/homes?ne_lat=48.88&ne_lng=2.40&sw_lat=48.82&sw_lng=2.29&search_by_map=true\"" }, "boundingBox": { "title": "Bounding Box", "type": "object", "description": "Geographic bounding box to search for listings. Provide as JSON: { \"ne_lat\": 48.88, \"ne_lng\": 2.40, \"sw_lat\": 48.82, \"sw_lng\": 2.29 } (central Paris)." }, "location": { "title": "Location", "type": "string", "description": "Location name to search. The actor will resolve this to a geographic area. Example: \"Paris, France\" or \"Nice, France\"." }, "maxListings": { "title": "Max Listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to process. Set to 0 for unlimited. Useful for testing runs.", "default": 0 }, "requestsPerSecond": { "title": "Requests Per Second", "minimum": 0.3, "maximum": 3, "type": "number", "description": "Starting request rate. The actor adapts automatically — backs off on rate limits and speeds up when safe. Range: 0.3–3. Default: 1.5 (PDP pages are heavier than calendar endpoints).", "default": 1.5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxy settings. Recommended: use Apify Proxy with residential group for best results." }, "supabaseUrl": { "title": "Supabase URL (optional)", "type": "string", "description": "If you want to sync results directly into your own Supabase database, provide the project URL here." }, "supabaseKey": { "title": "Supabase Service Key (optional)", "type": "string", "description": "Service-role key for your Supabase project. Only used if Supabase URL is provided." }, "supabaseZoneId": { "title": "Supabase Zone ID (optional)", "type": "string", "description": "UUID of the zone in your Supabase 'zones' table to attach listings to. Only used with Supabase sync." } } }, "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 } } } } } } } } } } ```