# Airbnb Unique Stays · 18 Categories · City or URL (`corent1robert/airbnb-atypical-stays-scraper`) Actor Scrape Airbnb unique stays by city: castle, treehouse, dome, yurt, igloo, houseboat, barn, island, and 10 more. Full listing detail per row. Apify Actor. - **URL**: https://apify.com/corent1robert/airbnb-atypical-stays-scraper.md - **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Unique Stays Scraper · Castles, Treehouses, Domes Discover and export Airbnb's **unique stay inventory** by city and category — castles, treehouses, domes, tiny homes, yurts, houseboats, islands, and 18 more verified types. Each run returns a clean dataset with full listing detail: title, amenities, capacity, ratings, GPS coordinates, photos, and host fields. **No API key. No Airbnb account. Public search only.** Built on the same extraction pipeline as [Airbnb Property Details Scraper](https://apify.com/corent1robert/airbnb-property-details-scraper) — identical schema, same completeness score, same dataset output. --- ### Where this fits in the Airbnb scraper suite | Your goal | Use this actor | |---|---| | **Find castles, treehouses, domes, yurts** in a city → full listing detail | **This actor** | | Scrape **any Airbnb listing** (not category-filtered) by URL or city search | [Property Details Scraper](https://apify.com/corent1robert/airbnb-property-details-scraper) | | Find **professional hosts / property managers** with emails and phones | [Professional Host Scraper](https://apify.com/corent1robert/airbnb-professional-host-scraper) | | Get all listings from **one specific host's portfolio** | [Host Portfolio Scraper](https://apify.com/corent1robert/airbnb-host-portfolio-scraper) | | Monitor **price changes** on specific listings over time | [Price Monitor](https://apify.com/corent1robert/airbnb-price-monitor) | | Find **Airbnb Experiences** (activities, tours) in a city | [Experiences Scraper](https://apify.com/corent1robert/airbnb-experiences-scraper) | **Common workflow:** Use this actor to find unique stays in a city → then feed those listing URLs into [Professional Host Scraper](https://apify.com/corent1robert/airbnb-professional-host-scraper) to get the operator's contact details (email, phone, company) for B2B outreach. --- ### Who is this for? | You are… | Typical goal | Suggested setup | |---|---|---| | **Travel data team / marketplace** | Build a "unique stays" inventory or comp set for a region | City search · castle or treehouse · export JSON/CSV | | **Market researcher** | Compare atypical supply across multiple cities | Add several cities in the location field | | **Revenue manager / host operator** | Track local castle or dome competitors | City search · your category · schedule weekly | | **Data analyst** | Consistent output schema across all atypical types | Any category · same field names as Property Details actor | | **Agency / scraping operator** | Batch collect listings for a client's brief | List of cities or paste `/rooms/` URLs directly | **What you get by default:** title, description, listing URL, GPS, capacity, bedrooms, bathrooms, amenities list, star rating, review count, host display name, host type, photos, price range indicators, and a completeness score. Around 90–100% of listings returned by Airbnb's search filter yield a full detail row. **When to paste URLs directly:** If you already have specific listing URLs, paste them in the location field — the search phase is skipped and only those listings are extracted. --- ### Quick start 1. Open the actor and click **Try for free**. 2. Set **Stay category** (e.g. Castle). 3. Enter a **City** — `Lyon, France`, `Edinburgh, United Kingdom`, etc. 4. Click **Start**. Results appear in the Dataset tab as listings are scraped. --- ### What it extracts | Category | Fields | |---|---| | **Identity** | `listingId`, `title`, `url`, `description` | | **Location** | `city`, `countryCode`, `lat`, `lng`, `fullAddress` | | **Capacity** | `guests`, `bedrooms`, `beds`, `bathrooms` | | **Amenities** | `amenities` (array), `amenitiesCount` | | **Ratings** | `rating`, `reviewCount` | | **Photos** | `photos` (array of URLs), `photoCount` | | **Host** | `hostDisplayName`, `hostType`, `isSuperhost`, `hostId` | | **Search metadata** | `searchAtypicalStayType`, `searchKgTagId`, `searchCity` | | **Quality** | `completenessScore` (0–100) | --- ### Input | Parameter | Type | Description | Default | |---|---|---|---| | `atypicalStayType` | string | Stay category (see dropdown) | `castle` | | `location` | string[] | City names or `/rooms/` URLs | `["Lyon, France"]` | #### API-only parameters (not shown in Console form) These can be passed via the Apify API or `input.json` for advanced use: | Parameter | Type | Default | Description | |---|---|---|---| | `proxyConfiguration` | object | RESIDENTIAL (auto) | Override proxy settings. On Apify, residential proxy is used automatically. | | `maxPages` | number | `0` (all) | Limit search result pages per city. `0` = no limit. | | `includeBlockedPdpInDataset` | boolean | `false` | Include hotel/unavailable pages in dataset for debugging. | | `debug` | boolean | `false` | Verbose input log. | #### JSON example ```json { "atypicalStayType": "treehouse", "location": ["Lyon, France", "Bordeaux, France"] } ```` #### Paste listing URLs directly ```json { "atypicalStayType": "castle", "location": [ "https://www.airbnb.com/rooms/12345678", "https://www.airbnb.com/rooms/87654321" ] } ``` *** ### How it works 1. **Search phase (Phase 1):** For each city, the actor calls Airbnb's search with the correct `kg_and_tags` category filter, resolves the city's `place_id` via autocomplete, and paginates through all result pages. Only actual search results are collected (no map suggestions, no "you might also like" recommendations). 2. **Extraction phase (Phase 2):** Each listing page is fetched and parsed. Data is extracted from Airbnb's embedded `niobeClientData` JSON payload — no browser needed, pure HTTP. 3. **Output:** Rows are pushed to the dataset as soon as each listing is processed. You see results before the run ends. *** ### Output sample ```json { "listingId": "12345678", "title": "Medieval Castle with Tower View", "url": "https://www.airbnb.com/rooms/12345678", "city": "Lyon, France", "lat": 45.748, "lng": 4.847, "guests": 8, "bedrooms": 4, "beds": 6, "bathrooms": 3, "rating": 4.92, "reviewCount": 147, "amenities": ["WiFi", "Pool", "Kitchen", "Parking", "Air conditioning"], "amenitiesCount": 32, "isSuperhost": true, "hostDisplayName": "Marie", "searchAtypicalStayType": "castle", "searchKgTagId": 8047, "searchCity": "Lyon, France", "completenessScore": 91 } ``` *** ### Important / Limitations - **Proxy:** On Apify, a residential proxy is used automatically — no configuration needed. For local development, pass `proxyConfiguration` explicitly in `input.json`. - **Category coverage:** 18 types are verified against Airbnb's `kg_and_tags` filter API. Some Airbnb-internal categories (tipi, tent, train) are not supported by the standard search endpoint and are excluded. - **Hotel listings:** Airbnb occasionally surfaces hotel-type pages in category searches; these are excluded from the dataset (they don't have the same data structure). - **Search precision:** The actor targets only the listings Airbnb displays for your category + city combination — typically 12–20 per search page, same as what you see on airbnb.com. - **Tag IDs:** Airbnb's internal tag IDs (e.g. `8047` for castles) can change. If a category returns 0 results, contact us. *** ### Local development ```bash cd airbnb-atypical-stays-scraper npm install ## Edit storage/key_value_stores/default/INPUT.json with your test input ## then run: apify run ## Or pass input directly: apify run --input-file=input.json ``` `storage/` is git-ignored. Results appear in `storage/datasets/default/` and as `output.csv`. To use a proxy locally, add to your `input.json`: ```json { "atypicalStayType": "castle", "location": ["Lyon, France"], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### Related actors | Actor | What it does | |---|---| | [Property Details Scraper](https://apify.com/corent1robert/airbnb-property-details-scraper) | Full listing detail for any city or URL — no category filter, same output schema | | [Professional Host Scraper](https://apify.com/corent1robert/airbnb-professional-host-scraper) | Find property managers by city — emails, phones, company name, RCS. EU-focused | | [Host Portfolio Scraper](https://apify.com/corent1robert/airbnb-host-portfolio-scraper) | All listings from one host profile — useful upstream of this actor or Property Details | | [Price Monitor](https://apify.com/corent1robert/airbnb-price-monitor) | Track price changes on saved listings over time | | [Experiences Scraper](https://apify.com/corent1robert/airbnb-experiences-scraper) | Airbnb Experiences (activities, tours) by city | | [Calendar Availability Scraper](https://apify.com/corent1robert/airbnb-calendar-availability-scraper) | Availability calendar for specific listings | *** ### Support Contact for custom scraping, scheduled exports, or bespoke automation. # Actor input Schema ## `atypicalStayType` (type: `string`): Choose the type of unique stay to search for. The actor targets Airbnb's verified category filters (castles, treehouses, domes…) and returns all matching listings in your chosen location. ## `location` (type: `array`): Enter one or more cities in **`City, Country`** format — e.g. `Lyon, France` or `Edinburgh, United Kingdom`. One row per city. Or paste Airbnb `/rooms/…` URLs directly — the actor detects them automatically and skips the search phase. ## Actor input object example ```json { "atypicalStayType": "castle", "location": [ "Lyon, France" ] } ``` # Actor output Schema ## `dataset` (type: `string`): All listings — download CSV, JSON, or Excel from the run ## `overview` (type: `string`): Pre-selected columns for quick review # 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": [ "Lyon, France" ] }; // Run the Actor and wait for it to finish const run = await client.actor("corent1robert/airbnb-atypical-stays-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": ["Lyon, France"] } # Run the Actor and wait for it to finish run = client.actor("corent1robert/airbnb-atypical-stays-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": [ "Lyon, France" ] }' | apify call corent1robert/airbnb-atypical-stays-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=corent1robert/airbnb-atypical-stays-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Unique Stays · 18 Categories · City or URL", "description": "Scrape Airbnb unique stays by city: castle, treehouse, dome, yurt, igloo, houseboat, barn, island, and 10 more. Full listing detail per row. Apify Actor.", "version": "2.8", "x-build-id": "HqDB8uemgXNwwBogP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corent1robert~airbnb-atypical-stays-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corent1robert-airbnb-atypical-stays-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/corent1robert~airbnb-atypical-stays-scraper/runs": { "post": { "operationId": "runs-sync-corent1robert-airbnb-atypical-stays-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/corent1robert~airbnb-atypical-stays-scraper/run-sync": { "post": { "operationId": "run-sync-corent1robert-airbnb-atypical-stays-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": { "atypicalStayType": { "title": "Stay category", "enum": [ "castle", "treehouse", "dome", "tiny_home", "cave", "earth_home", "yurt", "windmill", "farm_stay", "barn", "island", "tower", "shipping_container", "rv", "hut", "igloo", "houseboat", "boat" ], "type": "string", "description": "Choose the type of unique stay to search for. The actor targets Airbnb's verified category filters (castles, treehouses, domes…) and returns all matching listings in your chosen location.", "default": "castle" }, "location": { "title": "City, Country — or listing URL(s)", "type": "array", "description": "Enter one or more cities in **`City, Country`** format — e.g. `Lyon, France` or `Edinburgh, United Kingdom`. One row per city.\n\nOr paste Airbnb `/rooms/…` URLs directly — the actor detects them automatically and skips the search phase.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```