# Airbnb Scraper (`sourabhbgp/airbnb-scraper`) Actor Scrape Airbnb listings by destination. Extract prices, ratings, reviews, amenities, host details. HTTP-only, 3x cheaper than alternatives. - **URL**: https://apify.com/sourabhbgp/airbnb-scraper.md - **Developed by:** [Sourabh Kumar](https://apify.com/sourabhbgp) (community) - **Categories:** Travel, Real estate - **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $4.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 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 — 100 Free | Prices, Ratings, Reviews, Amenities Scrape Airbnb listings, pricing, ratings, reviews, and amenities at scale. Fast HTTP-only scraper — no browser needed, no headless Chrome overhead. 3 modes: search by destination, get listing details, or extract reviews. **$4 per 1,000 results** — 33% cheaper than competitors. 100 free results lifetime, no credit card needed. ### 🔍 What Does It Do? This actor scrapes Airbnb data using three modes: 1. **Search** — Find listings by location with filters (price range, room type, bedrooms, superhost, dates) 2. **Listing Details** — Get full details for specific listings (description, amenities, host info, policies, photos) 3. **Reviews** — Extract guest reviews with ratings, reviewer info, and review text HTTP-only architecture means it runs 5-10x faster and costs 90% less than browser-based scrapers. No Playwright, no Puppeteer, no wasted compute. ### 📊 What Data Can You Extract? #### Search Results | Field | Type | Description | |-------|------|-------------| | `id` | string | Listing ID | | `name` | string | Listing title | | `url` | string | Full Airbnb URL | | `city` | string | City name | | `neighborhood` | string | Neighborhood name | | `latitude` / `longitude` | number | GPS coordinates | | `roomType` | string | Entire home, private room, shared room | | `bedrooms` / `beds` / `bathrooms` | number | Room configuration | | `personCapacity` | number | Max guests | | `pricePerNight` | number | Nightly price | | `totalPrice` | number | Total price for stay (when dates provided) | | `currency` | string | Currency code (USD, EUR, GBP...) | | `rating` | number | Average star rating | | `reviewsCount` | number | Total number of reviews | | `isSuperhost` | boolean | Superhost status | | `isNewListing` | boolean | New listing flag | | `photos` | string[] | Photo URLs | | `hostName` / `hostId` | string | Host information | | `instantBook` | boolean | Instant booking available | #### Listing Details All search result fields plus: | Field | Type | Description | |-------|------|-------------| | `description` | string | Full listing description | | `amenities` | string[] | All amenities (WiFi, kitchen, parking...) | | `ratingBreakdown` | object | Per-category ratings (cleanliness, accuracy, check-in...) | | `hostAbout` | string | Host bio | | `hostResponseRate` | string | Host response rate | | `hostResponseTime` | string | Typical response time | | `houseRules` | string | House rules summary | | `cancellationPolicy` | string | Cancellation policy type | | `sleepingArrangements` | string | Bed/room layout | | `checkInTime` / `checkOutTime` | string | Check-in and check-out times | | `neighborhoodOverview` | string | Area description | #### Reviews | Field | Type | Description | |-------|------|-------------| | `listingId` | string | Associated listing ID | | `listingName` | string | Associated listing title | | `reviewId` | string | Unique review ID | | `reviewerName` | string | Guest first name | | `reviewerLocation` | string | Guest location | | `reviewDate` | string | Date of review | | `reviewText` | string | Full review text | | `rating` | number | Star rating (1-5) | | `language` | string | Review language code | ### 💡 Use Cases - **Rental market analysis** — compare pricing, occupancy, and amenities across neighborhoods - **Price monitoring** — track nightly rates over time for competitive pricing - **Competitor research** — analyze rival listings' ratings, reviews, and amenities - **Vacation planning** — bulk compare listings with filters for dates, budget, and room type - **Investment analysis** — evaluate short-term rental potential by location and property type - **Real estate market research** — understand supply, pricing trends, and demand by area - **Hospitality industry research** — benchmark amenities, host response rates, and guest satisfaction ### 💰 How Much Does It Cost? - **100 free results** — lifetime, no credit card needed - After that: **$4 per 1,000 results** ($0.004 each) | Results | Cost | |---------|------| | 100 | Free | | 240 (one city search) | $0.28 | | 1,000 | $4 | | 10,000 | $40 | | 100,000 | $400 | Competitors charge $5-6 per 1,000 results. This actor is **3x cheaper** with the same data quality. ### 📥 Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | enum | `search` | `search`, `listing`, or `reviews` | | `locationQueries` | string[] | `["New York"]` | Locations to search (search mode) | | `urls` | string[] | `[]` | Listing URLs or IDs (listing/reviews mode) | | `maxResults` | integer | `50` | Max results (0 = unlimited) | | `checkIn` | string | — | Check-in date, YYYY-MM-DD (enables pricing) | | `checkOut` | string | — | Check-out date, YYYY-MM-DD (enables pricing) | | `priceMin` | integer | — | Minimum price per night | | `priceMax` | integer | — | Maximum price per night | | `currency` | string | `USD` | Currency code (USD, EUR, GBP...) | | `roomType` | enum | `any` | `any`, `Entire home/apt`, `Private room`, `Shared room` | | `minBedrooms` | integer | — | Minimum bedrooms | | `minBathrooms` | integer | — | Minimum bathrooms | | `adults` | integer | `1` | Number of adult guests | | `superhostOnly` | boolean | `false` | Only show Superhost listings | #### Search by Location ```json { "mode": "search", "locationQueries": ["Paris, France", "Barcelona, Spain"], "maxResults": 100, "checkIn": "2026-06-01", "checkOut": "2026-06-07", "priceMax": 200, "currency": "EUR" } ```` #### Get Listing Details ```json { "mode": "listing", "urls": [ "https://www.airbnb.com/rooms/12345678", "https://www.airbnb.co.uk/rooms/87654321", "55555555" ] } ``` #### Scrape Reviews ```json { "mode": "reviews", "urls": ["https://www.airbnb.com/rooms/12345678"], "maxResults": 200 } ``` ### 📤 Output Example #### Search Result ```json { "id": "12345678", "name": "Charming Studio in Le Marais", "url": "https://www.airbnb.com/rooms/12345678", "city": "Paris", "neighborhood": "Le Marais", "latitude": 48.8566, "longitude": 2.3522, "roomType": "Entire home/apt", "bedrooms": 0, "beds": 1, "bathrooms": 1, "personCapacity": 2, "pricePerNight": 95, "totalPrice": 570, "currency": "EUR", "rating": 4.87, "reviewsCount": 342, "isSuperhost": true, "isNewListing": false, "photos": ["https://a0.muscache.com/im/pictures/..."], "hostName": "Marie", "hostId": "98765432", "instantBook": true, "scrapedAt": "2026-04-07T12:00:00.000Z" } ``` ### ⚡ Tips - **Set check-in/check-out dates** to get accurate pricing data — without dates, some listings won't return prices - **Use the `currency` parameter** to get prices in your preferred currency (USD, EUR, GBP, JPY, etc.) - **Filter by Superhost** (`superhostOnly: true`) to find the highest-rated, most reliable listings - **Any Airbnb URL format works** — `.com`, `.co.uk`, `.co.in`, `.de`, bare listing IDs, and `/rooms/plus/` URLs are all accepted - **Search mode paginates automatically** — up to 300 listings per location (6 pages x 50 per page) - **Reviews paginate via the API** — up to 100 reviews per listing by default, set `maxResults` higher for more - **Combine location queries** — search multiple cities in a single run by adding multiple entries to `locationQueries` - **Price filters** (`priceMin`/`priceMax`) apply to nightly rate and work best with dates set # Actor input Schema ## `mode` (type: `string`): Scraping mode: search for listings by location, get listing details, or scrape reviews. ## `locationQueries` (type: `array`): Location names to search for listings (used in search mode). Examples: New York, Paris, Tokyo. ## `urls` (type: `array`): Airbnb listing URLs for listing/reviews mode. Also accepts bare listing IDs. ## `maxResults` (type: `integer`): Maximum number of results to return. 0 = unlimited. ## `checkIn` (type: `string`): Check-in date for search (YYYY-MM-DD). ## `checkOut` (type: `string`): Check-out date for search (YYYY-MM-DD). ## `priceMin` (type: `integer`): Minimum price per night filter. ## `priceMax` (type: `integer`): Maximum price per night filter. ## `currency` (type: `string`): Currency code for prices (e.g., USD, EUR, GBP). ## `roomType` (type: `string`): Filter by room type. ## `minBedrooms` (type: `integer`): Minimum number of bedrooms. ## `minBathrooms` (type: `integer`): Minimum number of bathrooms. ## `adults` (type: `integer`): Number of adult guests. ## `superhostOnly` (type: `boolean`): Only show listings from Superhosts. ## Actor input object example ```json { "mode": "search", "locationQueries": [ "New York" ], "maxResults": 50, "currency": "USD", "roomType": "any", "adults": 1, "superhostOnly": false } ``` # Actor output Schema ## `datasetItems` (type: `string`): Scraped Airbnb listings, details, or reviews # 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 = { "locationQueries": [ "New York" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sourabhbgp/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 = { "locationQueries": ["New York"] } # Run the Actor and wait for it to finish run = client.actor("sourabhbgp/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 '{ "locationQueries": [ "New York" ] }' | apify call sourabhbgp/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sourabhbgp/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Scraper", "description": "Scrape Airbnb listings by destination. Extract prices, ratings, reviews, amenities, host details. HTTP-only, 3x cheaper than alternatives.", "version": "0.0", "x-build-id": "jhK2IFyNxioWZWTIB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-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/sourabhbgp~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-sourabhbgp-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/sourabhbgp~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-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": { "mode": { "title": "Mode", "enum": [ "search", "listing", "reviews" ], "type": "string", "description": "Scraping mode: search for listings by location, get listing details, or scrape reviews.", "default": "search" }, "locationQueries": { "title": "Location Queries", "type": "array", "description": "Location names to search for listings (used in search mode). Examples: New York, Paris, Tokyo.", "items": { "type": "string" } }, "urls": { "title": "Listing URLs", "type": "array", "description": "Airbnb listing URLs for listing/reviews mode. Also accepts bare listing IDs.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of results to return. 0 = unlimited.", "default": 50 }, "checkIn": { "title": "Check-in Date", "type": "string", "description": "Check-in date for search (YYYY-MM-DD)." }, "checkOut": { "title": "Check-out Date", "type": "string", "description": "Check-out date for search (YYYY-MM-DD)." }, "priceMin": { "title": "Minimum Price", "type": "integer", "description": "Minimum price per night filter." }, "priceMax": { "title": "Maximum Price", "type": "integer", "description": "Maximum price per night filter." }, "currency": { "title": "Currency", "type": "string", "description": "Currency code for prices (e.g., USD, EUR, GBP).", "default": "USD" }, "roomType": { "title": "Room Type", "enum": [ "any", "Entire home/apt", "Private room", "Shared room" ], "type": "string", "description": "Filter by room type.", "default": "any" }, "minBedrooms": { "title": "Minimum Bedrooms", "type": "integer", "description": "Minimum number of bedrooms." }, "minBathrooms": { "title": "Minimum Bathrooms", "type": "integer", "description": "Minimum number of bathrooms." }, "adults": { "title": "Number of Adults", "minimum": 1, "type": "integer", "description": "Number of adult guests.", "default": 1 }, "superhostOnly": { "title": "Superhost Only", "type": "boolean", "description": "Only show listings from Superhosts.", "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 } } } } } } } } } } ```