# Airbnb Scraper - Stay Listings, Prices & Ratings (`scrapeworks/airbnb-search-scraper`) Actor Scrape Airbnb search results in bulk: stay names, nightly and total prices, ratings, review counts, Superhost and Guest favorite badges, coordinates and photos as clean JSON. Many locations or Airbnb search URLs per run, deep pagination, any currency. No login or API key needed. - **URL**: https://apify.com/scrapeworks/airbnb-search-scraper.md - **Developed by:** [Nicolas van Arkens](https://apify.com/scrapeworks) (community) - **Categories:** Travel, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 — Stay Listings, Prices & Ratings Scrape **Airbnb search results in bulk** and get clean, structured JSON for every stay: name, property type, nightly and total price, rating, review count, Superhost / Guest favorite badges, exact coordinates and photo URLs. Type locations exactly as you would on airbnb.com (or paste full Airbnb search URLs with your own filters), and the scraper paginates deep automatically — up to ~270 listings per search, Airbnb's own limit. Add as many locations as you like in a single run: 10 cities ≈ 2,700 rows. No login, no API key, no browser — the actor reads the structured data Airbnb itself embeds in each search page, so it's fast and cheap to run. ### What data you get | Field | Description | |---|---| | `roomId`, `url` | Unique listing ID and direct link (`airbnb.com/rooms/...`) | | `name` | Listing headline as shown on the card | | `propertyType` | e.g. "Apartment in Barcelona", "Room in Lisbon" | | `rating`, `reviewsCount` | Average guest rating (1–5) and number of reviews | | `isNewListing` | True when the card shows "New" instead of a rating | | `isSuperhost`, `isGuestFavorite`, `badges` | Quality badges on the card | | `priceText`, `priceTotal`, `priceQualifier` | Displayed price, its numeric value, and what it covers (e.g. "total") | | `pricePerNight`, `nights` | Per-night price derived from Airbnb's own price breakdown | | `originalPriceText`, `originalPriceTotal` | Pre-discount price when the host is running a deal | | `currency` | The ISO currency you asked for — pinned on every request | | `checkIn`, `checkOut` | The stay dates the price refers to | | `latitude`, `longitude` | Exact map coordinates of the listing | | `details` | Bed/bath/bedroom summary lines (e.g. "2 beds", "1.5 baths") | | `images` | Photo URLs for the listing card | | `searchQuery`, `position` | Which search produced the row and its rank | ### Input example ```json { "locations": ["Lisbon, Portugal", "Barcelona, Spain"], "checkIn": "2026-09-04", "checkOut": "2026-09-08", "adults": 2, "currency": "USD", "maxResultsPerSearch": 270 } ```` You can also paste full Airbnb search URLs (with amenity filters, map bounds, flexible dates...) into `searchUrls` — each is paginated the same way. ### Output sample (real row) ```json { "roomId": "1684094795418458585", "url": "https://www.airbnb.com/rooms/1684094795418458585", "name": "3 bedrooms, bright, elegant, Sagrada Familia, AC", "propertyType": "Apartment in Barcelona", "rating": 5.0, "reviewsCount": 4, "isNewListing": false, "isSuperhost": true, "isGuestFavorite": false, "badges": ["Superhost"], "priceText": "$2,017", "priceQualifier": "total", "priceTotal": 2017.0, "pricePerNight": 403.4, "nights": 5, "originalPriceText": null, "originalPriceTotal": null, "currency": "USD", "checkIn": "2026-08-22", "checkOut": "2026-08-27", "latitude": 41.40654, "longitude": 2.17142, "details": ["Business host"], "images": ["https://a0.muscache.com/im/pictures/hosting/Hosting-1684094795418458585/original/5bc4e2b6-41e0-4371-aee3-e8adda50c6cb.jpeg"], "searchQuery": "Barcelona, Spain", "position": 1, "scrapedAt": "2026-07-18T12:04:11.532156+00:00" } ``` ### Use cases - **Pricing & revenue research** — track nightly rates, discounts and occupancy signals across whole cities for specific dates; feed dynamic-pricing models for your own rentals. - **Market analysis & investment** — count supply, ratings and Superhost density per neighborhood (every row has coordinates, so it maps directly). - **Competitor monitoring** — watch new listings, price drops and Guest favorite status in the markets you host in. - **Travel products & lead lists** — build stay-comparison tools, deal alerts, or datasets of top-rated stays for content and newsletters. ### FAQ **Do I need dates?** No — without dates Airbnb prices a default stay window. Set `checkIn`/`checkOut` to get exact totals for your dates (each row echoes the dates its price refers to). **Why do I get at most ~270 rows per search?** That's Airbnb's own pagination limit for one search. To collect more, split the market into several locations (neighborhoods, nearby towns) or several filtered `searchUrls` (e.g. price bands) — each one paginates up to ~270 again. **What currency are prices in?** Whatever you set in `currency` (default USD). The scraper pins it on every request, so rows are consistent regardless of proxy location. **Does it scrape host contact data?** No. It returns exactly the public data shown on Airbnb's search result cards. **Which proxy should I use?** Leave the default (Apify residential proxy). Airbnb often blocks datacenter IPs. **How am I charged?** Pay per result: you're charged once per listing row delivered. Blocked or empty pages cost nothing. # Actor input Schema ## `locations` (type: `array`): One or more places to search stays in, exactly as you would type them on airbnb.com (e.g. 'Lisbon, Portugal', 'Brooklyn, NY', 'Bali'). Each location is searched separately and paginated deep (up to ~270 listings, Airbnb's own limit per search). Add as many locations as you like in a single run. ## `searchUrls` (type: `array`): Optional: paste full airbnb.com search URLs (an /s/... link with your own filters — amenities, map area, flexible dates — already applied). Each URL is scraped and paginated just like a location. Use this for filters this form doesn't expose; otherwise just use 'Locations'. ## `checkIn` (type: `string`): Optional check-in date in YYYY-MM-DD format (e.g. 2026-08-14). Set both dates to get exact availability and total stay prices; leave empty to let Airbnb use its default flexible dates. ## `checkOut` (type: `string`): Optional check-out date in YYYY-MM-DD format (e.g. 2026-08-21). Used together with the check-in date. ## `adults` (type: `integer`): Number of adult guests (affects pricing and which listings qualify). 0 = let Airbnb use its default. ## `children` (type: `integer`): Number of child guests. ## `infants` (type: `integer`): Number of infant guests (under 2). ## `pets` (type: `integer`): Number of pets — filters to pet-friendly stays. ## `priceMin` (type: `integer`): Only return stays at or above this nightly price (in the selected currency). 0 = no minimum. ## `priceMax` (type: `integer`): Only return stays at or below this nightly price (in the selected currency). 0 = no maximum. ## `roomType` (type: `string`): Restrict results to one stay type. 'Any' returns everything. ## `currency` (type: `string`): 3-letter ISO currency code for all returned prices (e.g. USD, EUR, GBP, AUD). The actor pins this on every request so prices are consistent no matter where the proxy exit node is. ## `maxResultsPerSearch` (type: `integer`): Maximum listings to return for EACH location/URL. The actor paginates automatically (18 listings per page). Airbnb itself caps one search at about 270 results — to collect more rows in a run, add more locations or narrower filtered search URLs. ## `proxyConfiguration` (type: `object`): Proxy used to reach Airbnb. Airbnb often blocks datacenter traffic, so RESIDENTIAL Apify Proxy is recommended for reliable results. ## Actor input object example ```json { "locations": [ "Lisbon, Portugal" ], "adults": 0, "children": 0, "infants": 0, "pets": 0, "priceMin": 0, "priceMax": 0, "roomType": "any", "currency": "USD", "maxResultsPerSearch": 270, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "locations": [ "Lisbon, Portugal" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeworks/airbnb-search-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 = { "locations": ["Lisbon, Portugal"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("scrapeworks/airbnb-search-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 '{ "locations": [ "Lisbon, Portugal" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call scrapeworks/airbnb-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeworks/airbnb-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Scraper - Stay Listings, Prices & Ratings", "description": "Scrape Airbnb search results in bulk: stay names, nightly and total prices, ratings, review counts, Superhost and Guest favorite badges, coordinates and photos as clean JSON. Many locations or Airbnb search URLs per run, deep pagination, any currency. No login or API key needed.", "version": "0.1", "x-build-id": "9NHtkRqdaeWJj9wnu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeworks~airbnb-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeworks-airbnb-search-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/scrapeworks~airbnb-search-scraper/runs": { "post": { "operationId": "runs-sync-scrapeworks-airbnb-search-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/scrapeworks~airbnb-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeworks-airbnb-search-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": { "locations": { "title": "Locations", "uniqueItems": true, "type": "array", "description": "One or more places to search stays in, exactly as you would type them on airbnb.com (e.g. 'Lisbon, Portugal', 'Brooklyn, NY', 'Bali'). Each location is searched separately and paginated deep (up to ~270 listings, Airbnb's own limit per search). Add as many locations as you like in a single run.", "items": { "type": "string" } }, "searchUrls": { "title": "Airbnb search URLs (optional, power users)", "uniqueItems": true, "type": "array", "description": "Optional: paste full airbnb.com search URLs (an /s/... link with your own filters — amenities, map area, flexible dates — already applied). Each URL is scraped and paginated just like a location. Use this for filters this form doesn't expose; otherwise just use 'Locations'.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional check-in date in YYYY-MM-DD format (e.g. 2026-08-14). Set both dates to get exact availability and total stay prices; leave empty to let Airbnb use its default flexible dates." }, "checkOut": { "title": "Check-out date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional check-out date in YYYY-MM-DD format (e.g. 2026-08-21). Used together with the check-in date." }, "adults": { "title": "Adults", "minimum": 0, "maximum": 16, "type": "integer", "description": "Number of adult guests (affects pricing and which listings qualify). 0 = let Airbnb use its default.", "default": 0 }, "children": { "title": "Children", "minimum": 0, "maximum": 15, "type": "integer", "description": "Number of child guests.", "default": 0 }, "infants": { "title": "Infants", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of infant guests (under 2).", "default": 0 }, "pets": { "title": "Pets", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of pets — filters to pet-friendly stays.", "default": 0 }, "priceMin": { "title": "Min price per night", "minimum": 0, "type": "integer", "description": "Only return stays at or above this nightly price (in the selected currency). 0 = no minimum.", "default": 0 }, "priceMax": { "title": "Max price per night", "minimum": 0, "type": "integer", "description": "Only return stays at or below this nightly price (in the selected currency). 0 = no maximum.", "default": 0 }, "roomType": { "title": "Room type", "enum": [ "any", "entire_home", "private_room", "shared_room", "hotel_room" ], "type": "string", "description": "Restrict results to one stay type. 'Any' returns everything.", "default": "any" }, "currency": { "title": "Currency", "type": "string", "description": "3-letter ISO currency code for all returned prices (e.g. USD, EUR, GBP, AUD). The actor pins this on every request so prices are consistent no matter where the proxy exit node is.", "default": "USD" }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum listings to return for EACH location/URL. The actor paginates automatically (18 listings per page). Airbnb itself caps one search at about 270 results — to collect more rows in a run, add more locations or narrower filtered search URLs.", "default": 270 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach Airbnb. Airbnb often blocks datacenter traffic, so RESIDENTIAL Apify Proxy is recommended for reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```