{ "openapi": "3.0.1", "info": { "title": "Airbnb Scraper - Most Comprehensive", "description": "🔥 ~$0.1/1K places 🔥 Scrape Airbnb listings by URL, listing ID, or location search. Returns full listing details including description, amenities, host info, location, photos, policies, and ratings. Optionally fetches reviews inline.", "version": "0.1", "x-build-id": "pt94MXq8AYg2KDLI7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kaix~airbnb-listing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kaix-airbnb-listing-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/kaix~airbnb-listing-scraper/runs": { "post": { "operationId": "runs-sync-kaix-airbnb-listing-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/kaix~airbnb-listing-scraper/run-sync": { "post": { "operationId": "run-sync-kaix-airbnb-listing-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": { "listings": { "title": "Listing URLs or IDs", "type": "array", "description": "Airbnb listing URLs or numeric IDs (e.g. https://www.airbnb.com/rooms/36276450 or 36276450).", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Location to search in (e.g. 'Paris, France', 'New York, NY', 'Tokyo'). Leave blank to use Listing URLs mode instead." }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Latitude for coordinate-based search (-90 to 90). Must be provided with Longitude. Bypasses location string resolution." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude for coordinate-based search (-180 to 180). Must be provided with Latitude." }, "maxLocationDeviation": { "title": "Max Location Deviation (km)", "minimum": 0, "type": "number", "description": "Maximum allowed distance (km) between the intended location and each result. Applied for coordinate search, or when explicitly set for location search. Set to 0 to disable.", "default": 200 }, "checkIn": { "title": "Check-in Date", "type": "string", "description": "Check-in date in YYYY-MM-DD format (e.g. '2026-06-01')." }, "checkOut": { "title": "Check-out Date", "type": "string", "description": "Check-out date in YYYY-MM-DD format (e.g. '2026-06-07')." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Number of adult guests.", "default": 1 }, "children": { "title": "Children", "minimum": 0, "type": "integer", "description": "Number of child guests.", "default": 0 }, "infants": { "title": "Infants", "minimum": 0, "type": "integer", "description": "Number of infant guests.", "default": 0 }, "pets": { "title": "Pets", "minimum": 0, "type": "integer", "description": "Number of pets.", "default": 0 }, "minPrice": { "title": "Min Price", "minimum": 0, "type": "integer", "description": "Minimum price per night, in the currency that Currency sets." }, "maxPrice": { "title": "Max Price", "minimum": 0, "type": "integer", "description": "Maximum price per night, in the currency that Currency sets." }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for search prices and the price filter, such as USD, EUR, or GBP.", "default": "USD" }, "propertyType": { "title": "Property Type", "type": "array", "description": "Filter by room type. Select one or more: entire_home, private_room, shared_room, hotel_room. Airbnb's search ignores shared and hotel rooms, so for these the Actor checks each listing page and reads search listings until it finds Max Listings or reaches Max Search Pages. These types are about 1 in 100 search listings.", "items": { "type": "string" } }, "minBedrooms": { "title": "Min Bedrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms." }, "minBathrooms": { "title": "Min Bathrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bathrooms." }, "minBeds": { "title": "Min Beds", "minimum": 0, "type": "integer", "description": "Minimum number of beds." }, "superhostOnly": { "title": "Superhost Only", "type": "boolean", "description": "Only include listings from Superhosts.", "default": false }, "instantBook": { "title": "Instant Book", "type": "boolean", "description": "Only include listings with Instant Book enabled.", "default": false }, "maxListings": { "title": "Max Listings", "minimum": 1, "type": "integer", "description": "Maximum number of listings to return from search.", "default": 20 }, "maxSearchPages": { "title": "Max Search Pages", "minimum": 1, "type": "integer", "description": "Maximum number of search result pages to crawl.", "default": 5 }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Fetch and include reviews for each listing. Each review is charged separately.", "default": false }, "maxReviewsPerListing": { "title": "Max Reviews Per Listing", "minimum": 0, "type": "integer", "description": "Maximum number of reviews per listing. Set to 0 for no limit. Only used when Include Reviews is enabled.", "default": 20 }, "reviewsSortBy": { "title": "Sort Reviews By", "enum": [ "MOST_RECENT", "RATING_DESC", "RATING_ASC" ], "type": "string", "description": "How to sort reviews (only used when Include Reviews is enabled).", "default": "MOST_RECENT" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Apify Proxy is enabled by default.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }