# Airbnb Scraper (`simpleapi/airbnb-scraper`) Actor Scrape live Airbnb listings to fuel travel content, destination guides, or SEO research. Find top listings, popular amenities, and guest trends to create high-converting content strategies. - **URL**: https://apify.com/simpleapi/airbnb-scraper.md - **Developed by:** [SimpleAPI](https://apify.com/simpleapi) (community) - **Categories:** E-commerce, Travel, Lead generation - **Stats:** 5 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 An Airbnb Scraper is a smart solution for extracting valuable Airbnb listing data quickly and efficiently. ๐Ÿก It helps businesses, researchers, and marketers collect pricing, reviews, availability, and host insights at scale. With support for Airbnb Scraper Python, Apify, and free tools, it enables data-driven decisions while respecting Airbnb scraping policy. ### ๐Ÿ  What does Airbnb Scraper do? An Airbnb Scraper is a powerful data extraction tool designed to collect Airbnb listing data at scaleโ€”quickly, accurately, and efficiently. ๐Ÿ” It allows users to scrape structured information such as property details, prices, reviews, ratings, host profiles, and availability directly from Airbnb listings. From market research to SEO analysis, Airbnb scraping data empowers businesses and individuals to make data-driven decisions. Instead of manually browsing listings, an Airbnb Scraper app or software automates the process, saving hours of effort. โฑ๏ธ Modern tools like Airbnb Scraper Apify, Airbnb Scraper Python, or even a free Airbnb Scraper option provide flexible ways to extract data without deep technical knowledge. Whether you're a real estate investor, travel analyst, or SEO professional, an Airbnb Scraper helps unlock insights hidden within Airbnbโ€™s massive marketplaceโ€”while staying mindful of the Airbnb scraping policy and ethical usage. โœ… * * * ### ๐Ÿ“Š What Airbnb Scraper can I extract? An Airbnb Scraper enables you to extract a wide variety of structured and unstructured data from Airbnb listings. Below is a detailed breakdown of what you can collect using an Airbnb Scraper software or app: #### ๐Ÿงพ Extractable Data Types | Data Type | Description | | --- | --- | | ๐Ÿก Listing Title | Property name and headline | | ๐Ÿ“ Location | City, neighborhood, country | | ๐Ÿ’ฒ Price | Nightly rate, cleaning fee | | โญ Ratings | Overall rating & review count | | ๐Ÿ“ Reviews | Guest comments and feedback | | ๐Ÿ›๏ธ Amenities | WiFi, pool, parking, etc. | | ๐Ÿง‘ Host Info | Host name, status, response rate | | ๐Ÿ“… Availability | Available and booked dates | | ๐Ÿท๏ธ Property Type | Apartment, villa, shared room | | ๐Ÿ“ธ Images | Listing photos URLs | With Airbnb scraping data, businesses can analyze pricing trends, compare competitors, or even build datasets for AI models. ๐Ÿ“ˆ Tools like Airbnb Scraper GitHub projects, Airbnb Scraper Python scripts, or Airbnb Scraper Chrome extension make this extraction flexible and scalable. * * * #### โœจ Key Features of Airbnb Scraper An advanced Airbnb Scraper comes packed with features that simplify large-scale Airbnb scraping while maintaining accuracy and performance. ๐Ÿ’ก #### ๐Ÿ”‘ Core Features * ๐Ÿš€ High-speed scraping for thousands of Airbnb listings * ๐Ÿง  Smart data extraction with clean, structured outputs * ๐Ÿ”„ Supports bulk URLs & location-based scraping * ๐Ÿ Compatible with Airbnb Scraper Python workflows * ๐ŸŒ Works as Airbnb Scraper app, software, or API-based solution * ๐Ÿงฉ Integration-friendly with Airbnb API alternatives * ๐Ÿ†“ Options for Airbnb Scraper free usage or trials * ๐Ÿงช Community-backed tools like Airbnb Scraper GitHub repositories * ๐Ÿงญ Location, date, and price filters for targeted scraping * ๐Ÿ›ก๏ธ Designed with Airbnb scraping policy awareness Whether you're using a magical Airbnb Scraper, a Chrome extension, or a cloud-based Airbnb Scraper Apify actor, these features ensure scalable and reliable Airbnb data collection. * * * ### ๐Ÿ› ๏ธ How to use Airbnb Scraper Using an Airbnb Scraper is simpleโ€”even for beginners. Follow this step-by-step guide to start Airbnb scraping data efficiently: #### ๐Ÿชœ Step-by-Step Guide 1. Log in to Apify ๐Ÿ” Create a free account or sign in to your existing Apify profile. 2. Select the Actor ๐ŸŽฏ Search for โ€œAirbnb Scraperโ€ in the Apify Store. 3. Enter Input Data ๐Ÿงพ Paste Airbnb listing URLs or search pages into the startUrls field. 4. Choose Options โš™๏ธ Select filters like location, price range, dates, or output format. 5. Run the Actor โ–ถ๏ธ Click โ€œStartโ€ and let the Airbnb Scraper Apify extract data automatically. 6. Download Results ๐Ÿ“ฅ Export results in JSON, CSV, or Excel format. This process works seamlessly whether youโ€™re building an Airbnb Scraper Python pipeline, testing a free Airbnb Scraper, or using a full-featured Airbnb Scraper software. * * * ### ๐ŸŽฏ Use Cases An Airbnb Scraper unlocks countless real-world applications across industries. ๐ŸŒ #### ๐Ÿ’ผ Popular Use Cases * ๐Ÿ“Š Market Research โ€“ Analyze pricing trends and occupancy rates * ๐Ÿ˜๏ธ Real Estate Investment โ€“ Identify profitable Airbnb locations * ๐Ÿ“ฃ Digital Marketing โ€“ Optimize listings using competitor insights * ๐Ÿค– AI & Data Science โ€“ Train models using Airbnb scraping data * ๐Ÿงณ Travel Platforms โ€“ Aggregate short-term rental insights * ๐Ÿ“ฐ Academic Research โ€“ Study tourism and hospitality patterns * ๐Ÿ” SEO & Content Strategy โ€“ Extract reviews and keywords From startups to enterprises, an Airbnb Scraper app or magical Airbnb Scraper helps transform raw Airbnb data into actionable intelligenceโ€”while respecting Airbnb scrapping policy guidelines. * * * ### ๐Ÿ’Ž Why choose us? We offer a reliable, scalable, and ethical Airbnb Scraper designed for professionals who value accuracy and performance. ๐ŸŒŸ #### ๐Ÿ† Our Advantages * โœ… Built for high-volume Airbnb scraping * ๐Ÿ” Secure & compliant with Airbnb scraping policy best practices * ๐Ÿงฉ Easy integration with Airbnb API alternatives * ๐Ÿ†“ Flexible plans, including Airbnb Scraper free options * ๐Ÿ Python-friendly for developers using Airbnb Scraper Python * ๐ŸŒ Cloud-based access via Airbnb Scraper Apify * ๐Ÿ“ž Dedicated support & active documentation Whether youโ€™re exploring a GitHub Airbnb Scraper, a browser extension, or a full-scale Airbnb Scraper software, we deliver trusted results at scale. * * * ### ๐Ÿ“ˆ How many results can you scrape with Airbnb Scraper? Scalability is one of the strongest advantages of a modern Airbnb Scraper. ๐Ÿš€ Depending on your configuration, you can scrape hundreds to millions of Airbnb listings without performance issues. #### ๐Ÿ”ข Scalability Highlights * ๐Ÿ™๏ธ Scrape entire cities, regions, or countries * ๐Ÿ” Run multiple scraping jobs in parallel * โšก Optimized for speed and data consistency * โ˜๏ธ Cloud-based scaling with Airbnb Scraper Apify * ๐Ÿ“ฆ Suitable for enterprise-grade Airbnb scraping data pipelines For smaller projects, a free Airbnb Scraper or Airbnb Scraper Chrome extension may be sufficient. For larger datasets, using an Airbnb Scraper app, software, or Python-based solution ensures uninterrupted performance. Whether you need 500 listings or 5 million, the Airbnb Scraper adapts to your data needsโ€”making it ideal for long-term analytics, dashboards, and research. * * * ### โš–๏ธ Is it legal to scrape Airbnb? The legality of Airbnb scraping depends on how and why the data is collected. ๐Ÿง  Airbnb has terms of service that outline acceptable usage, often referred to as the Airbnb scraping policy. #### ๐Ÿ“ Key Considerations * โœ”๏ธ Scrape publicly available data only * โŒ Avoid personal or sensitive user data * ๐Ÿ“œ Review Airbnbโ€™s Terms of Service regularly * ๐Ÿงฉ Use scraped data for research, analysis, or internal use * ๐ŸŒ Follow local data protection laws (GDPR, etc.) Using an Airbnb Scraper API, Apify actor, or Airbnb Scraper Python tool responsibly helps maintain ethical compliance. Always consult legal guidance if scraping data for commercial redistribution. * * * ### โš™๏ธ Input Parameters #### ๐Ÿงพ Example Input JSON ```json { "proxyConfiguration": { "useApifyProxy": false }, "startItems": [ "https://www.airbnb.com/s/London/homes" ] } ```` ### ๐Ÿ“ค Output Format #### ๐Ÿงพ Example Output JSON ```json { "thumbnail": "https://a0.muscache.com/im/pictures/miso/Hosting-934718546911668796/original/c105003a-834c-4d6c-9141-ef47c1ecada7.jpeg", "id": "934718546911668796", "title": "1.5 baths", "description": "Welcome to our wonderful, spacious gem in Hoxton! Our unique loft is a stylish retreat with an open-plan living area and kitchen that benefits from abundant natural light. Cooks will love the well-equipped kitchen with top-notch appliances and quality cookware.\n\nFrom here, you can discover the surrounding vibrant neighbourhoods of Shoreditch, Dalston, Hackney, and Islington. You are within reach of numerous excellent restaurants, cafรฉs, markets, and easy transportation to other areas of London.", "rating": { "accuracy": 5, "checking": 5, "cleanliness": 5, "communication": 5, "location": 4.78, "value": 10, "guestSatisfaction": null, "reviewsCount": 28 }, "price": { "label": "$281 for 5 nights", "qualifier": "for 5 nights", "price": "$281", "originalPrice": null, "discountedPrice": null, "breakDown": { "basePrice": { "description": "5 nights x $56.09", "price": "$280.46" }, "basePriceBreakdown": [], "serviceFee": null, "taxes": null, "total": { "price": "$280", "description": "Total (calculated price, may vary)" }, "totalBeforeTaxes": null, "cleaningFee": null, "specialOffer": null, "earlyBirdDiscount": null } }, "coordinates": { "latitude": 51.5364, "longitude": -0.08245 }, "url": "https://www.airbnb.com/rooms/934718546911668796?locale=en-US¤cy=USD&check_in=2025-01-01&check_out=2025-01-08", "currency": "USD" }, ``` ### โ“ FAQ โ€“ Airbnb Scraper #### 1๏ธโƒฃ What is an Airbnb Scraper? An Airbnb Scraper extracts structured Airbnb listing data automatically. #### 2๏ธโƒฃ Is there a free Airbnb Scraper available? Yes, many tools offer Airbnb Scraper free plans or trials. #### 3๏ธโƒฃ Can I use Airbnb Scraper with Python? Absolutely! Airbnb Scraper Python integrations are widely supported. #### 4๏ธโƒฃ Is Airbnb scraping legal? Yes, when done responsibly and in line with Airbnb scraping policy. #### 5๏ธโƒฃ Do you support Airbnb Scraper Apify? Yes, our solution works seamlessly with Apify Airbnb Scraper actors. #### 6๏ธโƒฃ Is there a Chrome extension for Airbnb scraping? Some tools provide an Airbnb Scraper Chrome extension for quick tasks. #### 7๏ธโƒฃ Can I use scraped data commercially? Commercial use depends on compliance with Airbnbโ€™s terms and local laws. ### โœ… Conclusion โ€“ Airbnb Scraper In conclusion, an Airbnb Scraper empowers you to transform Airbnb listings into actionable insights. ๐Ÿ“Š Whether you use an Airbnb Scraper app, software, GitHub project, or Apify actor, it offers scalable, flexible data extraction. When used responsibly, Airbnb scraping data becomes a powerful asset for research, analysis, and growth. ๐Ÿš€ #### โœจ Ready to unlock powerful Airbnb insights? Choose a scalable, ethical, and high-performance Airbnb Scraper today! ### What are other Airbnb scraping tools? If you want to scrape specific Airbnb data, you can use any of the dedicated scrapers below for faster and more targeted results. | Scraper Name | Scraper Name | |---|---| | [Airbnb Availability Calendar](https://apify.com/simpleapi/airbnb-availability-calendar) | [Airbnb Occupancy Scraper](https://apify.com/simpleapi/airbnb-occupancy-scraper) | | [Airbnb Email Scraper](https://apify.com/simpleapi/airbnb-email-scraper) | [Airbnb Phone Number Scraper](https://apify.com/simpleapi/airbnb-phone-number-scraper) | | [Airbnb Full Year Price Tracker Scraper](https://apify.com/simpleapi/airbnb-full-year-price-tracker-scraper) | [Airbnb Review Scraper](https://apify.com/simpleapi/airbnb-review-scraper) | | [Airbnb Image Scraper](https://apify.com/simpleapi/airbnb-image-scraper) | [Airbnb Rooms URLs Scraper](https://apify.com/simpleapi/Airbnb-Rooms-URLs-Scraper) | | [Airbnb Images Scraper](https://apify.com/simpleapi/airbnb-Images-scraper) | | # Actor input Schema ## `locationQueries` (type: `array`): Examples: `london`, `paris`, or for the US `Austin--TX` so the right area is clear. Add one entry per line. ๐ŸŒ† ## `startItems` (type: `array`): Optional: full Airbnb search URLs or other start links โ€” weโ€™ll figure out the place from them. ๐Ÿ”— ## `checkin` (type: `string`): When your stay starts โ€” calendar date **or** relative (e.g. `14 days`, `2 weeks`). Future trip dates work best for live prices. ๐Ÿ“† ## `checkout` (type: `string`): When your stay ends โ€” must be **after** check-in. Same calendar or relative style as above. ๐ŸŒ… ## `currency` (type: `string`): Prices will be shown in this money format. ๐Ÿ’ถ ## `locale` (type: `string`): How Airbnb labels listings and prices for you (language/region). ๐Ÿ—ฃ๏ธ ## `maxItems` (type: `integer`): Stop after this many stays that **match your search** (and your area rules below). ๐Ÿ“Š ## `maxPages` (type: `integer`): Advanced: limit how many result pages to scroll. Leave empty and weโ€™ll pick a sensible cap for you. ๐Ÿ“‘ ## `strictGeo` (type: `boolean`): When **on** โœ… we only keep stays that really belong to the area you meant (great when a city name exists in many countries). When **off**, more results may appear from nearby or similar names. ๐ŸŒ ## `state` (type: `string`): Optional dropdown of regions worldwide โ€” pick the closest match, or none. US tip: you can also use `City--ST` in the location field. ๐Ÿ‡บ๐Ÿ‡ธ ## `country` (type: `string`): Optional: which country the place should be in (helps when two cities share a name). Leave empty if youโ€™re sure. ๐Ÿณ๏ธ ## `proxyConfiguration` (type: `object`): Configure Apify Proxy if needed; otherwise we connect directly. โ˜๏ธ ## Actor input object example ```json { "locationQueries": [ "paris" ], "startItems": [ "https://www.airbnb.com/s/london/homes" ], "checkin": "2026-06-01", "checkout": "2026-06-08", "currency": "USD", "locale": "en-US", "maxItems": 20, "strictGeo": true, "state": "", "country": "", "proxyConfiguration": { "useApifyProxy": false } } ``` # 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": [ "paris" ], "startItems": [ "https://www.airbnb.com/s/london/homes" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("simpleapi/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": ["paris"], "startItems": ["https://www.airbnb.com/s/london/homes"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("simpleapi/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": [ "paris" ], "startItems": [ "https://www.airbnb.com/s/london/homes" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call simpleapi/airbnb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=simpleapi/airbnb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Airbnb Scraper", "description": "Scrape live Airbnb listings to fuel travel content, destination guides, or SEO research. Find top listings, popular amenities, and guest trends to create high-converting content strategies.", "version": "0.1", "x-build-id": "EEUoHEqEdpzO0b1wC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-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": { "locationQueries": { "title": "๐Ÿ“ Location keywords", "type": "array", "description": "Examples: `london`, `paris`, or for the US `Austin--TX` so the right area is clear. Add one entry per line. ๐ŸŒ†", "items": { "type": "string" } }, "startItems": { "title": "๐Ÿ”— Or paste search links / URLs", "type": "array", "description": "Optional: full Airbnb search URLs or other start links โ€” weโ€™ll figure out the place from them. ๐Ÿ”—", "items": { "type": "string" } }, "checkin": { "title": "๐Ÿ›Ž๏ธ Check-in", "type": "string", "description": "When your stay starts โ€” calendar date **or** relative (e.g. `14 days`, `2 weeks`). Future trip dates work best for live prices. ๐Ÿ“†", "default": "2026-06-01" }, "checkout": { "title": "๐Ÿšช Check-out", "type": "string", "description": "When your stay ends โ€” must be **after** check-in. Same calendar or relative style as above. ๐ŸŒ…", "default": "2026-06-08" }, "currency": { "title": "๐Ÿ’ต Currency", "enum": [ "USD", "EUR", "GBP", "JPY", "AUD", "CAD", "CHF", "CNY", "INR", "BRL", "MXN", "SEK", "NOK", "DKK", "PLN", "NZD", "SGD", "HKD", "KRW", "TRY", "ZAR", "AED", "THB", "MYR", "PHP", "IDR", "CZK", "HUF", "ILS", "SAR", "CLP", "ARS", "COP", "PEN", "RON", "BGN", "HRK", "ISK", "TWD", "VND" ], "type": "string", "description": "Prices will be shown in this money format. ๐Ÿ’ถ", "default": "USD" }, "locale": { "title": "๐ŸŒ Language & region (locale)", "enum": [ "en-US", "en-GB", "en-AU", "en-CA", "en-IN", "en-IE", "fr-FR", "fr-CA", "de-DE", "es-ES", "es-MX", "es-AR", "it-IT", "pt-BR", "pt-PT", "ja-JP", "ko-KR", "zh-CN", "zh-TW", "nl-NL", "nl-BE", "sv-SE", "da-DK", "nb-NO", "fi-FI", "pl-PL", "ru-RU", "tr-TR", "el-GR", "cs-CZ", "hu-HU", "ro-RO", "uk-UA", "id-ID", "th-TH", "vi-VN", "ms-MY", "hi-IN", "he-IL", "ar-SA", "ca-ES", "hr-HR", "sk-SK", "sl-SI", "bg-BG", "lt-LT", "lv-LV", "et-EE" ], "type": "string", "description": "How Airbnb labels listings and prices for you (language/region). ๐Ÿ—ฃ๏ธ", "default": "en-US" }, "maxItems": { "title": "๐Ÿ”ข Max stays", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many stays that **match your search** (and your area rules below). ๐Ÿ“Š", "default": 20 }, "maxPages": { "title": "๐Ÿ“„ Max search pages (optional)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Advanced: limit how many result pages to scroll. Leave empty and weโ€™ll pick a sensible cap for you. ๐Ÿ“‘" }, "strictGeo": { "title": "๐Ÿ“Œ Strictly stay in my search area", "type": "boolean", "description": "When **on** โœ… we only keep stays that really belong to the area you meant (great when a city name exists in many countries). When **off**, more results may appear from nearby or similar names. ๐ŸŒ", "default": true }, "state": { "title": "๐Ÿ“ Region / state / province", "enum": [ "", "Addis Ababa", "Alberta", "Andalusia", "Antioquia", "Auckland", "Australian Capital Territory", "Baden-Wรผrttemberg", "Bali", "Bangkok", "Bavaria", "Beijing", "Berlin", "Bogotรก D.C.", "Brussels-Capital Region", "British Columbia", "Buenos Aires Province", "Busan", "California", "Cairo Governorate", "Casablanca-Settat", "Catalonia", "Cรณrdoba", "Delhi", "Dubai", "Dublin", "Eastern Cape", "England", "Flanders", "Florida", "Gauteng", "Guangdong", "Hanoi", "Hokkaido", "Ho Chi Minh City", "Hong Kong", "Istanbul", "Jakarta", "Jalisco", "Kanagawa Prefecture", "Karnataka", "KwaZulu-Natal", "Lagos State", "Lazio", "Lesser Poland", "Lima Province", "Lombardy", "Madrid", "Maharashtra", "Manitoba", "Metropolitan Manila", "Mexico City", "Minas Gerais", "Moscow Oblast", "New Brunswick", "New South Wales", "New York", "North Holland", "North Rhine-Westphalia", "Northern Ireland", "Nova Scotia", "Ohio", "Ontario", "Oregon", "Osaka Prefecture", "Pennsylvania", "Provence-Alpes-Cรดte d'Azur", "Quebec", "Queensland", "Rio de Janeiro", "Riyadh Province", "Saint Petersburg", "Santiago Metropolitan", "Saskatchewan", "Sรฃo Paulo", "Scotland", "Seoul", "Shanghai", "Sichuan", "Singapore", "South Australia", "South Holland", "Stockholm County", "Taipei", "Tamil Nadu", "Tasmania", "Tel Aviv District", "Texas", "Tokyo", "Victoria", "Viken", "Wales", "Wallonia", "Wellington", "Western Australia", "Western Cape", "Zurich", "รŽle-de-France" ], "type": "string", "description": "Optional dropdown of regions worldwide โ€” pick the closest match, or none. US tip: you can also use `City--ST` in the location field. ๐Ÿ‡บ๐Ÿ‡ธ", "default": "" }, "country": { "title": "๐ŸŒŽ Country", "enum": [ "", "United States", "United Kingdom", "Canada", "Australia", "France", "Germany", "Italy", "Spain", "Japan", "India", "Brazil", "Mexico", "Ireland", "Netherlands", "Portugal", "Belgium", "Austria", "Switzerland", "Sweden", "Norway", "Denmark", "Poland", "Czech Republic", "Hungary", "Greece", "Turkey", "South Korea", "China", "Taiwan", "Hong Kong", "Singapore", "New Zealand", "South Africa", "United Arab Emirates", "Saudi Arabia", "Israel", "Argentina", "Chile", "Colombia", "Thailand", "Malaysia", "Indonesia", "Philippines", "Vietnam", "Egypt", "Nigeria", "Russia", "Ukraine", "Romania", "Finland", "Croatia", "Slovenia", "Slovakia", "Bulgaria", "Serbia", "Iceland", "Luxembourg", "Estonia", "Latvia", "Lithuania", "Pakistan", "Bangladesh", "Peru", "Ecuador", "Uruguay", "Costa Rica", "Panama", "Morocco", "Kenya", "Qatar", "Kuwait", "Bahrain", "Oman", "Cyprus", "Malta", "Montenegro", "Albania", "North Macedonia" ], "type": "string", "description": "Optional: which country the place should be in (helps when two cities share a name). Leave empty if youโ€™re sure. ๐Ÿณ๏ธ", "default": "" }, "proxyConfiguration": { "title": "๐Ÿ”Œ Proxy", "type": "object", "description": "Configure Apify Proxy if needed; otherwise we connect directly. โ˜๏ธ" } } }, "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 } } } } } } } } } } ```