# Airbnb Market Data Scraper (`psymall/airbnb-scraper`) Actor Turn any city into clean Airbnb market data. Search by location or URL and get listing name, price (incl. discounts), rating, reviews, coordinates, room info and images — structured and ready for price comps, occupancy and competitor tracking. - **URL**: https://apify.com/psymall/airbnb-scraper.md - **Developed by:** [Moty Gotgilf](https://apify.com/psymall) (community) - **Categories:** Travel, Real estate, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.50 / 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 Market Data Scraper Fast, reliable Airbnb scraper for **market research and price intelligence**. Give it a city (or any Airbnb search URL) and it returns clean, structured data for every listing on the results pages — no login, no browser babysitting. ### What you get per listing | Field | Description | |---|---| | `roomId` / `url` | Airbnb listing id and direct link | | `name` | Listing title | | `locationTitle` / `subtitle` | e.g. "Apartment in Tel Aviv-Yafo" | | `priceText` / `priceAmount` / `priceCurrency` / `priceCurrencyCode` / `priceQualifier` | Displayed price, parsed amount, currency symbol, requested currency code (e.g. USD), and unit ("for 5 nights") | | `originalPriceText` / `originalPriceAmount` / `isDiscounted` | Pre-discount price and discount flag when the listing is on sale | | `rating` / `reviewsCount` | Average rating and number of reviews | | `roomInfo` | Bedrooms / beds summary | | `availabilityHint` | Date range shown on the card | | `latitude` / `longitude` | Map coordinates | | `badges` | e.g. "Guest favorite" | | `images` / `coverImage` | Photo URLs | ### Input ```json { "location": "Tel-Aviv--Israel", "currency": "USD", "checkIn": "2026-08-01", "checkOut": "2026-08-05", "adults": 2, "maxItems": 100, "maxPages": 15 } ```` - **location** — city in Airbnb's URL form (`Paris--France`, `New-York--NY`). Ignored when **startUrls** is set. - **startUrls** — full `https://www.airbnb.com/s/.../homes` URLs; use these to carry over filters, dates or map bounds straight from the Airbnb site. - **currency** — price currency (USD, EUR, ILS, …). - **checkIn / checkOut / adults** — optional; when set, prices reflect that specific stay. - **maxItems** — hard cap on listings collected (0 = no limit). - **maxPages** — result pages per search (Airbnb caps at ~15). ### How it works The scraper reads Airbnb's own embedded page state (the same JSON the site uses to render results), so output is stable and complete rather than scraped from fragile HTML. It uses a real browser with Apify **residential proxies** and paginates via Airbnb's native cursors. A run that returns zero listings fails loudly instead of billing you for an empty result. ### Notes & limits - **Scope:** this version returns **search-result** market data (the fields above) for whole cities or filtered searches — ideal for price comps, occupancy hints and competitor tracking. Per-listing amenities and host profiles are on the roadmap. - **Currency & prices** depend on the proxy region and the dates you pass; set `currency` explicitly for consistent comparisons. - Airbnb caps search pagination at ~15 pages (~270 listings) per query. To cover a market fully, pass several narrower searches (by neighborhood, price band or dates) via `startUrls`. ### Legal Collects only publicly visible listing data. Use responsibly and in line with Airbnb's terms and applicable law. # Actor input Schema ## `location` (type: `string`): City or area to search, in Airbnb's URL form, e.g. 'Tel-Aviv--Israel', 'Paris--France', 'New-York--NY'. Ignored if Start URLs are provided. ## `startUrls` (type: `array`): One or more full Airbnb search URLs (https://www.airbnb.com/s/.../homes). Overrides Location. Use this to pass filters, dates or map bounds from the Airbnb site. ## `currency` (type: `string`): Currency code for prices, e.g. USD, EUR, ILS, GBP. ## `checkIn` (type: `string`): YYYY-MM-DD. When set with Check-out, prices reflect that stay. ## `checkOut` (type: `string`): YYYY-MM-DD. ## `adults` (type: `integer`): Number of adults for the search (affects availability and price). ## `maxItems` (type: `integer`): Stop after collecting this many listings across all searches. 0 = no limit. ## `maxPages` (type: `integer`): How many result pages to paginate through per search (~18 listings per page). Airbnb caps search pagination at ~15 pages. ## Actor input object example ```json { "location": "Tel-Aviv--Israel", "startUrls": [], "currency": "USD", "checkIn": "", "checkOut": "", "adults": 1, "maxItems": 100, "maxPages": 15 } ``` # 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": "Tel-Aviv--Israel", "currency": "USD" }; // Run the Actor and wait for it to finish const run = await client.actor("psymall/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": "Tel-Aviv--Israel", "currency": "USD", } # Run the Actor and wait for it to finish run = client.actor("psymall/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": "Tel-Aviv--Israel", "currency": "USD" }' | apify call psymall/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=psymall/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Market Data Scraper", "description": "Turn any city into clean Airbnb market data. Search by location or URL and get listing name, price (incl. discounts), rating, reviews, coordinates, room info and images — structured and ready for price comps, occupancy and competitor tracking.", "version": "0.1", "x-build-id": "ET4govItJBJWgGLXm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/psymall~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-psymall-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/psymall~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-psymall-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/psymall~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-psymall-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", "properties": { "location": { "title": "Location", "type": "string", "description": "City or area to search, in Airbnb's URL form, e.g. 'Tel-Aviv--Israel', 'Paris--France', 'New-York--NY'. Ignored if Start URLs are provided.", "default": "Tel-Aviv--Israel" }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "One or more full Airbnb search URLs (https://www.airbnb.com/s/.../homes). Overrides Location. Use this to pass filters, dates or map bounds from the Airbnb site.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "currency": { "title": "Currency", "type": "string", "description": "Currency code for prices, e.g. USD, EUR, ILS, GBP.", "default": "USD" }, "checkIn": { "title": "Check-in date (optional)", "type": "string", "description": "YYYY-MM-DD. When set with Check-out, prices reflect that stay.", "default": "" }, "checkOut": { "title": "Check-out date (optional)", "type": "string", "description": "YYYY-MM-DD.", "default": "" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adults for the search (affects availability and price).", "default": 1 }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Stop after collecting this many listings across all searches. 0 = no limit.", "default": 100 }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many result pages to paginate through per search (~18 listings per page). Airbnb caps search pagination at ~15 pages.", "default": 15 } } }, "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 } } } } } } } } } } ```