# 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:** 1 total users, 0 monthly users, 96.7% 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/actors/running/actors-in-store.md#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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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. ## `proxyConfiguration` (type: `object`): Proxy used for every Airbnb request. Airbnb blocks some datacenter IPs with HTTP 403/405 — keep Apify Proxy enabled (RESIDENTIAL recommended) for reliable runs. ## 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", "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 = { "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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).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": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,axlymxp/airbnb-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/JDg4H7oDYJUJPMjnX/builds/MbO2OHKDgWpXf0Xfm/openapi.json