{ "openapi": "3.0.1", "info": { "title": "Airbnb Search Scraper", "description": "$0.75 / 1000 results. A powerful scraper to extract Airbnb search results across Homes Apartments, Experiences, and Services, with full support for filters, locations, pricing, ratings, and media. Designed for market research, pricing intelligence, trend analysis, and travel-tech applications.", "version": "0.0", "x-build-id": "0zQyiM8yl6P9gajSz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/saswave~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-saswave-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/saswave~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-saswave-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/saswave~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-saswave-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", "required": [ "where" ], "properties": { "search_type": { "title": "Search Feature", "enum": [ "StaysSearch", "ExperiencesSearch", "ServicesSearchQuery" ], "type": "string", "description": "Select one of the 3", "default": "StaysSearch" }, "where": { "title": "Where", "type": "string", "description": "Provide location on where to search for accommodation" }, "checkin": { "title": "Checkin Date", "type": "string", "description": "Provide dates for your stay. Both checkin and checkout need to be provided, else we use today and today + 1", "default": "" }, "checkout": { "title": "Checkout Date", "type": "string", "description": "Provide dates for your stay. Both checkin and checkout need to be provided, else we use today and today + 1", "default": "" }, "adults": { "title": "Adults number", "minimum": 1, "maximum": 15, "type": "integer", "description": "Provide number of guests", "default": 1 }, "children": { "title": "Children number", "minimum": 0, "maximum": 15, "type": "integer", "description": "Provide number of guests", "default": 0 }, "infants": { "title": "Infants number", "minimum": 0, "maximum": 15, "type": "integer", "description": "Provide number of guests", "default": 0 }, "price_min": { "title": "Minimum Price Range", "minimum": 0, "type": "integer", "description": "Provide range price", "default": 0 }, "price_max": { "title": "Maximum Price Range", "minimum": 0, "type": "integer", "description": "Provide range price", "default": 0 }, "flexible_date_search": { "title": "Flexible date", "enum": [ "", "0", "3", "1", "2", "6" ], "type": "string", "description": "Room type filter", "default": "" }, "pets": { "title": "Pets number", "minimum": 0, "maximum": 15, "type": "integer", "description": "Provide number of guests", "default": 0 }, "room_types": { "title": "Room Type", "enum": [ "", "Private room", "Entire home/apt" ], "type": "string", "description": "Room type filter", "default": "" }, "min_bathrooms": { "title": "Minimum Bathrooms", "minimum": 0, "maximum": 8, "type": "integer", "description": "Provide range price", "default": 0 }, "min_bedrooms": { "title": "Minimum Bedrooms", "minimum": 0, "maximum": 8, "type": "integer", "description": "Provide range price", "default": 0 }, "min_beds": { "title": "Minimum Beds", "minimum": 0, "maximum": 8, "type": "integer", "description": "Provide range price", "default": 0 }, "amenities": { "title": "Amenities", "type": "array", "description": "Multi Select amenities", "items": { "type": "string", "enum": [ "4", "8", "33", "34", "5", "30", "47", "58", "45", "46", "7", "25", "9", "97", "286", "1000", "15", "99", "16", "27", "11", "35", "36", "110", "114", "111", "115", "116", "120", "121", "295", "294", "296", "297", "291" ], "enumTitles": [ "wifi", "kitchen", "washer", "dryer", "AC", "heating", "dedicated workspace", "TV", "hair dryer", "iron", "hot tub", "free parking", "EV charger", "crib", "king bed", "gym", "BBQ grill", "breakfast", "indoor fireplace", "smocking allowed", "smoke alarm", "carbon monoxide alarm", "step free access entrance & parking", "disabled parking spot", "guest entrance wider 32 inches", "step free bathroom", "bathroom entrance wider 32 inches", "Step-free bathroom access", "Bathroom entrance wider than 32 inches", "Toilet grab bar", "Shower grab bar", "Step-free shower", "Shower or bath chair", "Ceiling or mobile hoist" ] }, "default": [] }, "instant_booking": { "title": "Instant Booking option", "type": "boolean", "description": "Select if needed", "default": false }, "guest_favorite": { "title": "Guest Favorite option", "type": "boolean", "description": "The most loved homes on Airbnb", "default": false }, "luxury": { "title": "Luxury option", "type": "boolean", "description": "Luxury homes with elevated design", "default": false }, "properties_id": { "title": "Properties Types", "type": "array", "description": "Multi Select properties Types", "items": { "type": "string", "enum": [ "3", "1", "2", "4" ], "enumTitles": [ "Apartment", "House", "Guest House", "Hotel" ] }, "default": [] }, "host_languages": { "title": "Host Languages", "type": "array", "description": "Multi Select host languages", "items": { "type": "string", "enum": [ "zh", "en", "fr", "de", "it", "ja", "ko", "pt", "ru", "es", "ar", "ca", "hr", "cs", "da", "nl", "fi", "el", "he", "hi", "hu", "is", "id", "ms", "no", "pl", "sv", "th", "tr", "af", "sq", "hy", "az", "eu", "be", "bn", "bs", "bg", "my", "et", "fil", "gl", "ka", "gu", "ht", "ga", "kn", "km", "ky", "lo", "lv", "lt", "mk", "mt", "fa", "pa", "ro", "sr", "sk", "sl", "sw", "tl", "ta", "te", "uk", "ur", "vi", "xh", "zu", "sgn" ], "enumTitles": [ "Chinese (Simplified)", "English", "French", "German", "Italian", "Japanese", "Korean", "Portuguese", "Russian", "Spanish", "Arabic", "Catalan", "Croatian", "Czech", "Danish", "Dutch", "Finnish", "Greek", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Indonesian", "Malay", "Norwegian", "Polish", "Swedish", "Thai", "Turkish", "Afrikaans", "Albanian", "Armenian", "Azerbaijani", "Basque", "Belarusian", "Bengali", "Bosnian", "Bulgarian", "Burmese", "Estonian", "Filipino", "Galician", "Georgian", "Gujarati", "Haitian Creole", "Irish", "Kannada", "Khmer", "Kyrgyz", "Lao", "Latvian", "Lithuanian", "Macedonian", "Maltese", "Persian", "Punjabi", "Romanian", "Serbian", "Slovakian", "Slovenian", "Swahili", "Tagalog", "Tamil", "Telugu", "Ukrainian", "Urdu", "Vietnamese", "Xhosa", "Zulu", "Sign Language" ] }, "default": [] }, "exp_type": { "title": "Experiences Types", "type": "array", "description": "Multi Select experiences types", "items": { "type": "string", "enum": [ "Tag:9010", "Tag:8953", "Tag:8959", "Tag:8957", "Tag:8970", "Tag:8972", "Tag:9011", "Tag:8960", "Tag:8954", "Tag:8971", "Tag:9013", "Tag:8961", "Tag:9048", "Tag:8955", "Tag:9012", "Tag:8962", "Tag:8968", "Tag:8963", "Tag:8969" ], "enumTitles": [ "Architecture", "Art", "Beauty", "Cooking", "Cultural Tours", "Dining", "Flying", "Food Tours", "Galleries", "Landmarks", "Museums", "Outdoors", "Performances", "Shopping & Fashion", "Tastings", "Water Sports", "Wellness", "Wildlife", "Workouts" ] }, "default": [] }, "traveler_type": { "title": "Traveler Type", "type": "array", "description": "Multi Select traveler type", "items": { "type": "string", "enum": [ "Tag:9008", "Tag:9007", "Tag:9006", "Tag:9045" ], "enumTitles": [ "Kids", "Big Groups", "Solo Travelers", "Date Night" ] }, "default": [] }, "duration_min": { "title": "Minimum Duration Range", "enum": [ "", "45", "60", "90", "120", "180" ], "type": "string", "description": "Room type filter", "default": "" }, "duration_max": { "title": "Minimum Duration Range", "enum": [ "45", "60", "90", "120", "180", "" ], "type": "string", "description": "Room type filter", "default": "" }, "time_of_day": { "title": "Time of Day", "type": "array", "description": "Multi Select time of day", "items": { "type": "string", "enum": [ "evening", "afternoon", "morning" ], "enumTitles": [ "Evening", "Afternoon", "Morning" ] }, "default": [] }, "exp_access_tags": { "title": "Experience Access Tags", "type": "array", "description": "Multi Select Access Tags", "items": { "type": "string", "enum": [ "Tag:5169", "Tag:5176", "Tag:5182", "Tag:6006" ], "enumTitles": [ "Step-free access", "Sign language options", "Designated sighted guide", "No extreme sensory stimuli" ] }, "default": [] }, "experience_languages": { "title": "Experience Languages", "type": "array", "description": "Multi Select Languages", "items": { "type": "string", "enum": [ "1", "2", "4", "8", "16", "32", "64", "128", "256", "512", "1024", "2048", "4096", "8192", "16384", "32768", "65536", "131072", "262144", "524288", "1048576", "2097152", "4194304", "8388608", "16777216", "33554432", "67108864", "134217728", "268435456", "536870912", "1073741824" ], "enumTitles": [ "English", "French", "German", "Japanese", "Italian", "Russian", "Spanish", "Chinese (Simplified)", "Arabic", "Hindi", "Portuguese", "Turkish", "Indonesian", "Dutch", "Korean", "Bengali", "Thai", "Punjabi", "Greek", "Sign Language", "Hebrew", "Polish", "Malay", "Tagalog", "Danish", "Swedish", "Norwegian", "Finnish", "Czech", "Hungarian", "Ukrainian" ] }, "default": [] }, "service_duration_min": { "title": "Minimum Duration Range", "enum": [ "", "45", "60", "90", "120", "180" ], "type": "string", "description": "Room type filter", "default": "" }, "service_duration_max": { "title": "Minimum Duration Range", "enum": [ "45", "60", "90", "120", "180", "" ], "type": "string", "description": "Room type filter", "default": "" }, "service_time_of_day": { "title": "Time of Day", "type": "array", "description": "Multi Select time of day", "items": { "type": "string", "enum": [ "evening", "afternoon", "morning" ], "enumTitles": [ "Evening", "Afternoon", "Morning" ] }, "default": [] }, "service_accessibility_tags": { "title": "Service Accessibility Tags", "type": "array", "description": "Multi Select Access Tags", "items": { "type": "string", "enum": [ "Tag:5176" ], "enumTitles": [ "Sign language" ] }, "default": [] }, "service_languages": { "title": "Service Languages", "type": "array", "description": "Multi Select services languages", "items": { "type": "string", "enum": [ "1", "2", "4", "8", "16", "32", "64", "128", "256", "512", "1024", "2048", "4096", "8192", "16384", "32768", "65536", "131072", "262144", "524288", "1048576", "2097152", "4194304", "8388608", "16777216", "33554432", "67108864", "134217728", "268435456", "536870912", "1073741824" ], "enumTitles": [ "English", "French", "German", "Japanese", "Italian", "Russian", "Spanish", "Chinese (Simplified)", "Arabic", "Hindi", "Portuguese", "Turkish", "Indonesian", "Dutch", "Korean", "Bengali", "Thai", "Punjabi", "Greek", "Sign Language", "Hebrew", "Polish", "Malay", "Tagalog", "Danish", "Swedish", "Norwegian", "Finnish", "Czech", "Hungarian", "Ukrainian" ] }, "default": [] }, "service_type_tag": { "title": "Service Type", "enum": [ "Tag:8949", "Tag:8950", "Tag:8941", "Tag:8939", "Tag:8942", "Tag:8952", "Tag:8944", "Tag:8943", "Tag:8951", "Tag:8946" ], "type": "string", "description": "Service Type filter", "default": "Tag:8949" } } }, "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 } } } } } } } } } }