# Airbnb Listings Scraper (`fetch_cat/airbnb-listings-scraper`) Actor ๐Ÿ  Scrape public Airbnb search results and room URLs with prices, ratings, reviews, amenities, images, and listing metadata. - **URL**: https://apify.com/fetch\_cat/airbnb-listings-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.03 / 1,000 result extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Listings Scraper Scrape public Airbnb listing data from search pages, room URLs, or a location search. Get listing URLs, titles, prices, ratings, review counts, images, coordinates, badges, amenities, and other public metadata in a clean dataset. ### What does Airbnb Listings Scraper do? Airbnb Listings Scraper helps you collect public Airbnb supply data for market research, pricing checks, competitive tracking, and hospitality analysis. It can start from Airbnb search URLs, individual room URLs, or a simple location such as `New York, NY`. The actor saves structured rows to an Apify dataset so you can export results as JSON, CSV, Excel, XML, or HTML. ### Who is it for? - ๐Ÿจ Property managers tracking competing short-term rentals. - ๐Ÿ“Š Revenue analysts comparing nightly price signals. - ๐Ÿงญ Travel market researchers mapping public supply. - ๐Ÿ˜๏ธ Real estate teams evaluating neighborhood rental density. - ๐Ÿงช Data teams building hospitality dashboards. - ๐Ÿ“ฐ Journalists researching public accommodation trends. ### Why use this Airbnb scraper? - Simple inputs for both search pages and listing pages. - Public listing fields in one flat dataset. - Optional check-in, check-out, adults, and currency filters. - Conservative defaults for inexpensive first runs. - Works well for repeatable market snapshots. - Exports directly through Apify datasets and API clients. ### What Airbnb data can you extract? | Field | Description | | --- | --- | | `url` | Public Airbnb listing URL | | `listingId` | Airbnb listing identifier when available | | `title` | Listing title or public name | | `name` | Listing name duplicate for compatibility | | `roomType` | Public room/property type text | | `category` | Public category tag when available | | `location` | Public location text | | `price` | Numeric price parsed from visible price text | | `priceText` | Original visible price string | | `currency` | Currency code when known | | `rating` | Public average rating | | `reviewsCount` | Public review count | | `badges` | Public badges shown on search results | | `isSuperhost` | Superhost signal when visible | | `amenities` | Public amenities from listing pages when available | | `imageUrls` | Public listing images | | `latitude` | Public approximate latitude when available | | `longitude` | Public approximate longitude when available | | `source` | `search` or `listing` | | `scrapedAt` | ISO timestamp of extraction | ### How much does it cost to scrape Airbnb listings? This actor uses pay-per-event pricing. You pay a small run start event plus a per-listing result event. The default input is intentionally small so your first run is inexpensive. Final production pricing is calculated from cloud cost measurements before Store publication. ### How to scrape Airbnb search results 1. Open Airbnb in your browser. 2. Search for a destination. 3. Copy the Airbnb search results URL. 4. Paste it into `startUrls`. 5. Set `maxItems` to the number of listings you need. 6. Run the actor. 7. Export the dataset. ### How to scrape Airbnb room URLs 1. Copy one or more public Airbnb room URLs. 2. Paste them into `startUrls`. 3. Keep `maxItems` equal to or above the number of URLs. 4. Run the actor. 5. Review the dataset rows. ### How to use the location input Use `location` when you do not already have a search URL. Example: ```json { "location": "New York, NY", "maxItems": 25, "currency": "USD" } ```` You can add optional trip filters: ```json { "location": "Paris, France", "checkIn": "2026-09-10", "checkOut": "2026-09-15", "adults": 2, "maxItems": 50, "currency": "EUR" } ``` ### Input options #### Airbnb start URLs Use this for Airbnb search pages and room pages. #### Location search Use this for a quick destination-based search. #### Check-in and check-out Use `YYYY-MM-DD` dates when you want prices for a specific stay window. #### Adults Set the number of adults for generated location searches. #### Maximum listings Controls how many dataset rows are saved. #### Currency Sets a preferred currency code for generated location searches and output fallback. #### Proxy configuration Proxy use is optional. Start without a proxy. If Airbnb limits traffic from your environment, enable Apify Proxy. ### Example input ```json { "startUrls": [ { "url": "https://www.airbnb.com/s/New-York--NY/homes" }, { "url": "https://www.airbnb.com/rooms/50633275" } ], "location": "New York, NY", "adults": 1, "maxItems": 25, "currency": "USD", "proxyConfiguration": { "useApifyProxy": false } } ``` ### Example output ```json { "url": "https://www.airbnb.com/rooms/123456789", "listingId": "123456789", "title": "Sunny apartment near Central Park", "name": "Sunny apartment near Central Park", "roomType": "Entire rental unit", "category": "Tag:8678", "location": "New York, United States", "price": 187, "priceText": "$187 night", "currency": "USD", "rating": 4.91, "reviewsCount": 122, "badges": ["Guest favorite"], "isSuperhost": false, "amenities": [], "imageUrls": ["https://a0.muscache.com/...jpg"], "latitude": 40.76, "longitude": -73.98, "source": "search", "scrapedAt": "2026-06-15T09:00:00.000Z" } ``` ### Tips for better results - Use real Airbnb search URLs when you need exact filters. - Use a low `maxItems` for your first test. - Add check-in and check-out dates for price comparisons. - Use the same input repeatedly to build time-series snapshots. - Use room URLs when you need richer page-level metadata. - Export CSV for spreadsheets and JSON for pipelines. ### Common workflows #### Market snapshot Run a location search weekly and compare prices, review counts, and ratings. #### Competitor monitoring Track a fixed list of room URLs and watch public metadata changes over time. #### Supply mapping Use coordinates and locations to map public short-term rental inventory. #### Pricing research Use date filters to compare visible nightly price signals across neighborhoods. ### Integrations Use the Apify dataset export links to connect results to: - Google Sheets - Airtable - BigQuery - Snowflake - Tableau - Looker Studio - Zapier - Make - custom ETL jobs ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/airbnb-listings-scraper').call({ location: 'New York, NY', maxItems: 25, currency: 'USD' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage with Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('fetch_cat/airbnb-listings-scraper').call(run_input={ 'location': 'New York, NY', 'maxItems': 20, 'currency': 'USD', }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~airbnb-listings-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"location":"New York, NY","maxItems":20,"currency":"USD"}' ``` ### MCP usage Connect this actor to MCP-compatible tools through Apify MCP Server: ```bash claude mcp add apify-airbnb-listings "https://mcp.apify.com/?tools=fetch_cat/airbnb-listings-scraper" ``` Use this server URL when a client asks for an MCP endpoint: ```text https://mcp.apify.com/?tools=fetch_cat/airbnb-listings-scraper ``` MCP JSON configuration example: ```json { "mcpServers": { "apify-airbnb-listings": { "url": "https://mcp.apify.com/?tools=fetch_cat/airbnb-listings-scraper" } } } ``` Example prompts: - "Scrape 20 Airbnb listings for New York and summarize price ranges." - "Compare ratings and review counts for these Airbnb room URLs." - "Create a CSV of public Airbnb listings for this destination." ### Using with Claude Code Add the Apify MCP Server URL with the tool parameter: ```text https://mcp.apify.com/?tools=fetch_cat/airbnb-listings-scraper ``` Then ask Claude Code to run the actor and analyze the dataset. ### Using with Claude Desktop Configure an MCP server that points to Apify MCP and include this actor as an allowed tool. ```json { "mcpServers": { "apify-airbnb-listings": { "url": "https://mcp.apify.com/?tools=fetch_cat/airbnb-listings-scraper" } } } ``` Keep your Apify token in your local Claude Desktop MCP configuration, not in prompts. ### Data quality notes Airbnb decides which public fields are shown on each page. Search pages usually include prices, ratings, review counts, images, and approximate coordinates. Room pages may include richer descriptions, amenities, and public metadata, but price visibility depends on selected dates and current Airbnb page content. ### Limitations - Only public Airbnb pages are supported. - The actor does not log in. - The actor does not access private booking, guest, host dashboard, or messaging data. - Some fields can be missing when Airbnb does not show them publicly. - Airbnb can change page content and availability at any time. ### Troubleshooting #### The run returned no items Check that the URL is a public Airbnb search page or public room URL. Try a smaller `maxItems` and a well-known destination first. #### Prices are missing Some listing pages do not show a current nightly price unless dates are selected. Add `checkIn` and `checkOut` or use a search URL that already includes dates. #### Airbnb limits the request Enable Apify Proxy in `proxyConfiguration` and retry with a small `maxItems` value. ### Legality This actor extracts public information visible on Airbnb pages. Use it responsibly, respect Airbnb terms, and avoid collecting personal or private information. You are responsible for making sure your use case complies with applicable laws and platform rules. ### FAQ #### Can I scrape private Airbnb account data? No. This actor is designed for public Airbnb search and room pages only. #### Why do some listings have missing prices or amenities? Airbnb controls which public fields are visible for each page, date range, and market. Add trip dates or use a public search URL that already shows the fields you need. ### Related scrapers Explore other data extraction tools from the same Apify account: - https://apify.com/fetch\_cat/google-maps-lead-finder - https://apify.com/fetch\_cat/google-maps-reviews-scraper - https://apify.com/fetch\_cat/youtube-transcript-scraper - https://apify.com/fetch\_cat/apple-app-store-reviews-scraper ### Changelog #### 0.1 Initial version for public Airbnb search and listing pages. ### Support If you have trouble with an input, share the run URL and the public Airbnb URL you tried so the issue can be reproduced. ### Field reference Use the field table above as the canonical output reference. ### Export formats Apify supports dataset export as JSON, CSV, Excel, XML, RSS, and HTML. ### Scheduling Use Apify schedules to run repeat market snapshots daily, weekly, or monthly. ### Webhooks Use Apify webhooks to send completed dataset URLs to your pipeline after every run. ### Storage Each run stores output in the default Apify dataset. You can keep, export, or delete datasets according to your retention needs. # Actor input Schema ## `startUrls` (type: `array`): Public Airbnb search result URLs or room/listing URLs to scrape. ## `location` (type: `string`): Optional Airbnb location search, for example New York, NY. Used in addition to start URLs when provided. ## `checkIn` (type: `string`): Optional check-in date in YYYY-MM-DD format. ## `checkOut` (type: `string`): Optional check-out date in YYYY-MM-DD format. ## `adults` (type: `integer`): Number of adult guests for generated location searches. ## `maxItems` (type: `integer`): Maximum number of listing records to save. ## `currency` (type: `string`): Optional Airbnb currency code for generated searches and output fallback, for example USD, EUR, or GBP. ## `proxyConfiguration` (type: `object`): Optional proxy settings. Start without a proxy; use Apify Proxy if Airbnb limits your traffic. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.airbnb.com/s/New-York--NY/homes" }, { "url": "https://www.airbnb.com/rooms/50633275" } ], "location": "New York, NY", "adults": 1, "maxItems": 20, "currency": "USD", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (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 = { "startUrls": [ { "url": "https://www.airbnb.com/s/New-York--NY/homes" }, { "url": "https://www.airbnb.com/rooms/50633275" } ], "location": "New York, NY", "checkIn": "", "checkOut": "", "currency": "USD", "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/airbnb-listings-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 = { "startUrls": [ { "url": "https://www.airbnb.com/s/New-York--NY/homes" }, { "url": "https://www.airbnb.com/rooms/50633275" }, ], "location": "New York, NY", "checkIn": "", "checkOut": "", "currency": "USD", "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/airbnb-listings-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 '{ "startUrls": [ { "url": "https://www.airbnb.com/s/New-York--NY/homes" }, { "url": "https://www.airbnb.com/rooms/50633275" } ], "location": "New York, NY", "checkIn": "", "checkOut": "", "currency": "USD", "proxyConfiguration": { "useApifyProxy": false } }' | apify call fetch_cat/airbnb-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/airbnb-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Listings Scraper", "description": "๐Ÿ  Scrape public Airbnb search results and room URLs with prices, ratings, reviews, amenities, images, and listing metadata.", "version": "0.1", "x-build-id": "OsgatjRok2rTjyHHD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~airbnb-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-airbnb-listings-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/fetch_cat~airbnb-listings-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-airbnb-listings-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/fetch_cat~airbnb-listings-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-airbnb-listings-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": { "startUrls": { "title": "Airbnb start URLs", "type": "array", "description": "Public Airbnb search result URLs or room/listing URLs to scrape.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location search", "type": "string", "description": "Optional Airbnb location search, for example New York, NY. Used in addition to start URLs when provided." }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Optional check-in date in YYYY-MM-DD format." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Optional check-out date in YYYY-MM-DD format." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests for generated location searches.", "default": 1 }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of listing records to save.", "default": 20 }, "currency": { "title": "Currency", "type": "string", "description": "Optional Airbnb currency code for generated searches and output fallback, for example USD, EUR, or GBP." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Start without a proxy; use Apify Proxy if Airbnb limits your traffic." } } }, "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 } } } } } } } } } } ```