{ "openapi": "3.0.1", "info": { "title": "Airbnb Scraper CHEAP [$0.10/1K💰] - Listings · Reviews · Prices", "description": "REVIEWS CHEAPEST FOR [$0.10/1K💰] and LISTINGS FOR [$1.5💰] Scrape Airbnb rentals in your chosen destinations. Extract descriptions, locations, prices per night, ratings, reviews count, host details, amenities and more. Download scraped data in various formats including HTML, JSON and Excel.", "version": "0.0", "x-build-id": "Jgxggq6YicJ6vmtbU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~airbnb-scraper-listings-prices-hosts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-airbnb-scraper-listings-prices-hosts", "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/ahmed_jasarevic~airbnb-scraper-listings-prices-hosts/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-airbnb-scraper-listings-prices-hosts", "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/ahmed_jasarevic~airbnb-scraper-listings-prices-hosts/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-airbnb-scraper-listings-prices-hosts", "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": [ "locationQueries", "maxListingsPerLocation" ], "properties": { "locationQueries": { "title": "Location Queries", "type": "array", "description": "List of cities or areas to search (e.g., ['Paris', 'Berlin']). Provide at least one location for the scraper to work.", "default": [ "Prague" ], "items": { "type": "string" } }, "listingUrls": { "title": "Direct Listing URLs or IDs", "type": "array", "description": "Optional list of Airbnb listing URLs (e.g. 'https://www.airbnb.com/rooms/1096229739856534197') or plain listing IDs. These are scraped directly without a location search.", "default": [], "items": { "type": "string" } }, "maxListingsPerLocation": { "title": "Max Listings per Location", "minimum": 1, "type": "integer", "description": "The maximum number of listing results to collect for each location query.", "default": 20 }, "includeHostDetails": { "title": "Include Host Details", "type": "boolean", "description": "If enabled, the scraper will query each listing page API to extract detailed host information like response rate and bio.", "default": true }, "scrapeReviews": { "title": "Scrape Reviews", "type": "boolean", "description": "If enabled, the scraper will also fetch guest reviews for each listing (one extra fast request per listing).", "default": false }, "maxReviewsPerListing": { "title": "Max Reviews per Listing", "minimum": 1, "maximum": 100, "type": "integer", "description": "The maximum number of reviews to scrape for each listing when 'Scrape Reviews' is enabled.", "default": 10 }, "checkIn": { "title": "Check-in Date", "type": "string", "description": "First night of the stay (YYYY-MM-DD). If omitted, the scraper defaults to a few days from today." }, "checkOut": { "title": "Check-out Date", "type": "string", "description": "Day the guest leaves (YYYY-MM-DD). Defaults to 1 night after check-in." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Number of adults in the party. Defaults to 1.", "default": 1 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Select proxy settings. Not required for API-based scraping, but available for compatibility." } } }, "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 } } } } } } } } } }