{ "openapi": "3.0.1", "info": { "title": "Airbnb Rooms URLs Scraper Host Email & Phone Finder", "description": "Airbnb Rooms URLs Scraper: Extract Airbnb room listing URLs and publicly available host emails, phone numbers, names, property details, locations, and websites. Build structured host lead lists for rental research, property analysis, and hospitality prospecting.", "version": "0.1", "x-build-id": "DPyF88T9uvyjXKDW6" }, "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 } } } } } } } } } }