# Airbnb Scraper (`axlymxp/airbnb-scraper`) Actor Scrape Airbnb listings by location or room URL — nightly price, amenities, host profile, guest reviews, availability calendar, ratings, photos and GPS as clean JSON. Powered by Airbnb's official GraphQL API for reliable, cookieless data. Pay only for the results you get. - **URL**: https://apify.com/axlymxp/airbnb-scraper.md - **Developed by:** [axly](https://apify.com/axlymxp) (community) - **Categories:** Travel, Real estate, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 dataset items 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 Extract structured Airbnb data at scale — **search by location or scrape specific room URLs** and get nightly price, amenities, host profile, guest reviews, availability and GPS coordinates as clean JSON. Built on Airbnb's own GraphQL API, so it runs cookieless and reliable, not on brittle HTML scraping. ### Who it's for - **Short-term-rental investors & analysts** — pull comps for a market (price, rating, capacity, GPS) to model yield and occupancy. - **Property managers & agencies** — build lists of listings and their hosts in any city for outreach and competitive tracking. - **PropTech / SaaS developers** — a stable JSON schema you can wire into dashboards, pipelines and CRMs. - **Researchers & journalists** — study pricing, availability and host concentration across neighborhoods. ### What you get (output fields) | Field | Type | Description | | ----------------------- | -------------- | -------------------------------------------------------------------------------- | | `listing_id` | string | Airbnb numeric listing id | | `url` | string | Canonical `/rooms/` URL | | `name` | string | Full listing name (type, rating, layout) | | `title` / `subtitle` | string | Search card title/subtitle | | `property_type` | string | e.g. "Entire rental unit" | | `person_capacity` | integer | Max guests | | `price` | string | Nightly price (with currency) | | `price_qualifier` | string | e.g. "night", "total" | | `rating` | number | Average star rating | | `review_count` | integer | Total reviews | | `coordinate` | object | `{ lat, lng }` | | `amenities` | array | Available amenities (full mode) | | `description` | string | Listing description (full mode) | | `hero_image` / `images` | string / array | Photo URLs | | `host` | object | Host name, profile URL, superhost/verified flags, years hosting, rating, reviews | | `reviews` | array | Guest reviews (when enabled) | | `availability` | array | Month-by-month calendar (when enabled) | | `scraped_at` | string | ISO-8601 timestamp | ### High-value use cases 1. **Market analysis** — scrape every listing in a city with `scrapeMode: full` to get price, capacity, amenities and host quality for a supply study. 2. **Lead building** — capture the `host` object across a market to identify superhosts and multi-property operators. 3. **Rate & availability monitoring** — schedule daily runs with `includeAvailability` to track open dates and pricing over time. 4. **Review mining** — enable `includeReviews` to collect guest sentiment for specific properties or a whole area. ### Input parameters | Field | Type | Default | Notes | | ------------------------------------------ | ------- | -------- | --------------------------------------------------------- | | `location` | string | — | Place to search, e.g. "Austin, Texas" | | `listingUrls` | array | — | Direct `/rooms/` links (alternative to `location`) | | `maxItems` | integer | 100 | Stop after this many listings | | `scrapeMode` | enum | `full` | `full` (detail enrichment) or `fast` (search fields only) | | `checkIn` / `checkOut` | string | — | ISO dates for price/availability context | | `adults` / `children` / `infants` / `pets` | integer | 1/0/0/0 | Guest counts | | `minPrice` / `maxPrice` | integer | — | Nightly price filters | | `includeReviews` | boolean | false | Attach guest reviews | | `maxReviews` | integer | 10 | Reviews per listing cap | | `includeAvailability` | boolean | false | Attach availability calendar | | `availabilityMonths` | integer | 3 | Months of availability | | `currency` / `locale` | string | USD / en | Output localization | ### Example input ```json { "location": "Austin, Texas", "maxItems": 50, "scrapeMode": "full", "adults": 2, "includeReviews": true, "maxReviews": 5 } ```` ### Example output (one row, trimmed) ```json { "listing_id": "28294520", "url": "https://www.airbnb.com/rooms/28294520", "name": "Rental unit in Rome · ★4.89 · 1 bedroom · 2 beds · 1 bath", "property_type": "Entire rental unit", "person_capacity": 3, "price": "$674", "rating": 4.89, "review_count": 188, "coordinate": { "lat": 41.89, "lng": 12.49 }, "amenities": ["Wifi", "Kitchen", "Air conditioning"], "host": { "host_id": "12345678", "name": "Ally", "profile_url": "https://www.airbnb.com/users/show/12345678", "is_superhost": true, "is_verified": true, "years_hosting": 6, "host_rating": 4.99 }, "scraped_at": "2026-07-10T16:40:00+00:00" } ``` ### Scheduling & integrations Run on a schedule (hourly/daily) from the Apify Console, or trigger via the API. Pipe results to Google Sheets, Make, Zapier, or S3 with Apify integrations, and receive a webhook when a run finishes. ### MCP / AI assistants Prefer to query Airbnb live from Claude, Cursor or a custom agent? Use the companion **Airbnb MCP Server** actor, which exposes search, listing detail, reviews and availability as MCP tools. ### FAQ **How many listings can I get per search?** Airbnb caps a single search at roughly 250–300 results across pages. For larger coverage, split by neighborhood, price band, or date, or feed `listingUrls` directly. **Is the data fresh?** Every row is fetched live at run time and stamped with `scraped_at`. **Does it return host email or phone?** No. Airbnb does not expose host email/phone; this actor returns the host's **public profile** (name, profile URL, superhost/verified status, tenure, ratings). **Is it reliable?** It calls Airbnb's official GraphQL API with browser-grade TLS, so it avoids most HTML-scraping breakage. Failed individual listings are skipped and logged rather than crashing the run. **Is scraping Airbnb legal?** This actor collects only publicly available listing data. You are responsible for complying with Airbnb's terms and applicable laws in your jurisdiction. # Actor input Schema ## `location` (type: `string`): A place name Airbnb resolves, e.g. 'Austin, Texas' or 'Rome, Italy'. Leave empty if you provide listing URLs instead. ## `listingUrls` (type: `array`): Optional. One or more direct Airbnb room links (https://www.airbnb.com/rooms/) to scrape specific listings instead of searching. ## `maxItems` (type: `integer`): Stop after collecting this many listings. ## `scrapeMode` (type: `string`): 'full' fetches each listing's detail page (amenities, description, host, coordinates). 'fast' returns only search-result fields (price, rating, image) — cheaper and quicker. ## `checkIn` (type: `string`): Optional ISO date (YYYY-MM-DD) for price and availability context. ## `checkOut` (type: `string`): Optional ISO date (YYYY-MM-DD). ## `adults` (type: `integer`): Number of adults for pricing. ## `children` (type: `integer`): Number of children (ages 2-12) for pricing. ## `infants` (type: `integer`): Number of infants (under 2) for pricing. ## `pets` (type: `integer`): Number of pets for pricing. ## `minPrice` (type: `integer`): Optional minimum nightly price filter (in the chosen currency). ## `maxPrice` (type: `integer`): Optional maximum nightly price filter. ## `includeReviews` (type: `boolean`): Attach guest reviews to each listing. ## `maxReviews` (type: `integer`): Cap the reviews attached per listing when 'Include reviews' is on. ## `includeAvailability` (type: `boolean`): Attach a month-by-month availability calendar to each listing. ## `availabilityMonths` (type: `integer`): How many months of availability to fetch when enabled. ## `currency` (type: `string`): ISO currency code for prices, e.g. USD, EUR, GBP. ## `locale` (type: `string`): Language code for localized text, e.g. en, es, fr. ## Actor input object example ```json { "location": "Austin, Texas", "listingUrls": [], "maxItems": 100, "scrapeMode": "full", "adults": 1, "children": 0, "infants": 0, "pets": 0, "includeReviews": false, "maxReviews": 10, "includeAvailability": false, "availabilityMonths": 3, "currency": "USD", "locale": "en" } ``` # 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": "Austin, Texas", "listingUrls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("axlymxp/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": "Austin, Texas", "listingUrls": [], } # Run the Actor and wait for it to finish run = client.actor("axlymxp/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": "Austin, Texas", "listingUrls": [] }' | apify call axlymxp/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=axlymxp/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Scraper", "description": "Scrape Airbnb listings by location or room URL — nightly price, amenities, host profile, guest reviews, availability calendar, ratings, photos and GPS as clean JSON. Powered by Airbnb's official GraphQL API for reliable, cookieless data. Pay only for the results you get.", "version": "1.0", "x-build-id": "xws9QZsfEdzmhYSMJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-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/axlymxp~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-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/axlymxp~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-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 / search query", "type": "string", "description": "A place name Airbnb resolves, e.g. 'Austin, Texas' or 'Rome, Italy'. Leave empty if you provide listing URLs instead." }, "listingUrls": { "title": "Listing URLs", "type": "array", "description": "Optional. One or more direct Airbnb room links (https://www.airbnb.com/rooms/) to scrape specific listings instead of searching.", "items": { "type": "string" } }, "maxItems": { "title": "Max listings", "minimum": 1, "type": "integer", "description": "Stop after collecting this many listings.", "default": 100 }, "scrapeMode": { "title": "Scrape mode", "enum": [ "full", "fast" ], "type": "string", "description": "'full' fetches each listing's detail page (amenities, description, host, coordinates). 'fast' returns only search-result fields (price, rating, image) — cheaper and quicker.", "default": "full" }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Optional ISO date (YYYY-MM-DD) for price and availability context." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Optional ISO date (YYYY-MM-DD)." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Number of adults for pricing.", "default": 1 }, "children": { "title": "Children", "minimum": 0, "type": "integer", "description": "Number of children (ages 2-12) for pricing.", "default": 0 }, "infants": { "title": "Infants", "minimum": 0, "type": "integer", "description": "Number of infants (under 2) for pricing.", "default": 0 }, "pets": { "title": "Pets", "minimum": 0, "type": "integer", "description": "Number of pets for pricing.", "default": 0 }, "minPrice": { "title": "Minimum price", "type": "integer", "description": "Optional minimum nightly price filter (in the chosen currency)." }, "maxPrice": { "title": "Maximum price", "type": "integer", "description": "Optional maximum nightly price filter." }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Attach guest reviews to each listing.", "default": false }, "maxReviews": { "title": "Max reviews per listing", "minimum": 0, "type": "integer", "description": "Cap the reviews attached per listing when 'Include reviews' is on.", "default": 10 }, "includeAvailability": { "title": "Include availability calendar", "type": "boolean", "description": "Attach a month-by-month availability calendar to each listing.", "default": false }, "availabilityMonths": { "title": "Availability months", "minimum": 1, "type": "integer", "description": "How many months of availability to fetch when enabled.", "default": 3 }, "currency": { "title": "Currency", "type": "string", "description": "ISO currency code for prices, e.g. USD, EUR, GBP.", "default": "USD" }, "locale": { "title": "Locale", "type": "string", "description": "Language code for localized text, e.g. en, es, fr.", "default": "en" } } }, "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 } } } } } } } } } } ```