{ "openapi": "3.0.1", "info": { "title": "Airbnb Rooms URLs Scraper Host Email & Phone Finder", "description": "Use this actor to automatically gather Airbnb room URLs from search pages and map results. Perfect for bulk research, market studies, and automated pipelines. Output includes validated, ready-to-crawl URLs for deeper Airbnb listing extraction.", "version": "0.1", "x-build-id": "YYy2F0LabAe8VNCDt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~Airbnb-Rooms-URLs-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-Airbnb-Rooms-URLs-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/scrapio~Airbnb-Rooms-URLs-Scraper/runs": { "post": { "operationId": "runs-sync-scrapio-Airbnb-Rooms-URLs-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/scrapio~Airbnb-Rooms-URLs-Scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-Airbnb-Rooms-URLs-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🏠 Airbnb listing URLs or search phrases", "type": "array", "description": "One Airbnb room URL per line (https://www.airbnb.com/rooms/12937), or a plain search phrase such as `Lisbon apartments` which is resolved to listings automatically. Every listing produces one host lead row.", "default": [ "https://www.airbnb.com/rooms/53997462", "https://www.airbnb.com/rooms/12937" ], "items": { "type": "string" } }, "maxListingsPerKeyword": { "title": "πŸ”’ Listings per search phrase", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many listings to pull from each search phrase. Ignored for direct room URLs. Default 20.", "default": 20 }, "hostQualification": { "title": "🎚️ Only keep hosts that are…", "enum": [ "any", "superhost", "identity-verified", "multi-property", "contact-signal" ], "type": "string", "description": "any = keep every listing. superhost = Airbnb Superhosts only. identity-verified = hosts with a verified identity badge. multi-property = hosts running more than one property. contact-signal = only rows where the contact scan actually found an email / phone / website / social handle (measured: 1 listing in 139 β€” expect a near-empty dataset).", "default": "any" }, "minPropertiesUnderManagement": { "title": "πŸ“Š Minimum properties under management", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Drops hosts who manage fewer properties than this, read live from the host's public profile (`hostPropertiesUnderManagement`). 0 keeps everyone, 10 keeps only professional operators. Needs the host profile request switched on.", "default": 0 }, "fetchHostProfile": { "title": "πŸͺͺ Open the host's public profile", "type": "boolean", "description": "One extra request per distinct host (cached inside the run). Adds properties under management, identity verifications, the profile bio, host location, guest-review count and account age. Turn off for a listing-card-only run.", "default": true }, "hostContactScan": { "title": "πŸ” Scan host-written text for contact details", "type": "boolean", "description": "Scans the listing description, the house rules, the host card bio, the host highlights and (when enabled) the profile bio. Results land in `contactScan` with the source each hit came from. `contactScanCharacters` shows how much text was actually scanned on every row.", "default": true }, "contactScanDepth": { "title": "πŸ“š Text the scan reads", "enum": [ "listing-text", "listing-and-profile" ], "type": "string", "description": "listing-text = description + house rules + host card bio + host highlights. listing-and-profile = the above plus the host's public profile bio (needs the profile request). The profile bio is where an operator pitch usually lives.", "default": "listing-and-profile" }, "checkIn": { "title": "πŸ“… Check-in", "type": "string", "description": "YYYY-MM-DD, or a relative value such as `3 days` / `2 weeks`. Leave empty to scrape the listing without dates." }, "checkOut": { "title": "πŸ“… Check-out", "type": "string", "description": "YYYY-MM-DD, or a relative value such as `10 days`. Leave empty to scrape the listing without dates." }, "adults": { "title": "πŸ§‘ Adults in the party", "minimum": 1, "type": "integer", "description": "Guest count sent with the listing request. Leave empty to let Airbnb default it." }, "children": { "title": "πŸ§’ Children", "minimum": 0, "type": "integer", "description": "Children in the party. Leave empty to skip." }, "infants": { "title": "πŸ‘Ά Infants", "minimum": 0, "type": "integer", "description": "Infants in the party. Leave empty to skip." }, "pets": { "title": "🐾 Pets", "minimum": 0, "type": "integer", "description": "Pets in the party. Leave empty to skip." }, "locale": { "title": "🌐 Result language", "enum": [ "en-US", "az-AZ", "id-ID", "bs-BA", "ca-ES", "cs-CZ", "sr-ME", "da-DK", "de-DE", "de-AT", "de-CH", "de-LU", "et-EE", "en-AU", "en-CA", "en-GB", "en-GY", "en-IN", "en-IE", "en-NZ", "en-SG", "en-AE", "es-AR", "es-BZ", "es-BO", "es-CL", "es-CO", "es-CR", "es-EC", "es-SV", "es-ES", "es-US", "es-GT", "es-HN", "es-419", "es-MX", "es-NI", "es-PA", "es-PY", "es-PE", "es-VE", "fr-BE", "fr-CA", "fr-FR", "fr-CH", "fr-LU", "ga-IE", "hr-HR", "xh-ZA", "zu-ZA", "is-IS", "it-IT", "it-CH", "sw-XX", "lv-LV", "lt-LT", "hu-HU", "mt-MT", "ms-MY", "nl-BE", "nl-NL", "no-NO", "pl-PL", "pt-BR", "pt-PT", "ro-RO", "sq-AL", "sk-SK", "sl-SI", "sr-RS", "fi-FI", "sv-SE", "tl-PH", "vi-VN", "tr-TR", "el-GR", "bg-BG", "mk-MK", "ru-RU", "uk-UA", "ka-GE", "hy-AM", "he-IL", "ar-XX", "hi-IN", "th-TH", "ko-KR", "ja-JP", "zh-US", "zh-TW-US", "zh-CN", "zh-HK", "zh-TW" ], "type": "string", "description": "Airbnb locale used for the listing and the host profile. Keep en-US for English lead text.", "default": "en-US" }, "currency": { "title": "πŸ’± Currency", "enum": [ "USD", "CZK", "AUD", "BRL", "BGN", "CAD", "CLP", "CNY", "COP", "CRC", "HRK", "DKK", "EGP", "AED", "EUR", "GHS", "HKD", "HUF", "INR", "IDR", "ILS", "JPY", "KZT", "KES", "MYR", "MXN", "MAD", "TWD", "NZD", "NOK", "PEN", "PHP", "PLN", "GBP", "QAR", "RON", "SAR", "SGD", "ZAR", "KRW", "SEK", "CHF", "THB", "TRY", "UGX", "UAH", "UYU", "VND" ], "type": "string", "description": "Currency used for any price value returned with the listing.", "default": "USD" }, "enrichUserProfiles": { "title": "πŸ‘€ Enrich user profiles (original actor switch)", "type": "boolean", "description": "Compatibility switch from the original Airbnb Rooms URLs Scraper: attaches the legacy `host.profile` / `coHosts[].profile` objects and also turns the host-profile request on. The modern equivalent is 'πŸͺͺ Open the host's public profile' above.", "default": false }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy", "type": "object", "description": "Starts with no proxy and escalates automatically to Apify datacenter, then residential, if Airbnb soft-blocks a request. Set your own groups here to override." } } }, "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 } } } } } } } } } }