{ "openapi": "3.0.1", "info": { "title": "Airbnb Scraper — Listings, Prices, Hosts & Ratings (No Login)", "description": "Airbnb scraper for listings by city, search URL or room ID. Get prices, ratings, review counts, amenities, host name, room type, guest capacity, coordinates and photos. No login, no cookies, fast. Export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "OG5J8HCPWhqJxeYhL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datasiphon~airbnb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datasiphon-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/datasiphon~airbnb-scraper/runs": { "post": { "operationId": "runs-sync-datasiphon-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/datasiphon~airbnb-scraper/run-sync": { "post": { "operationId": "run-sync-datasiphon-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", "properties": { "locationQueries": { "title": "Locations", "type": "array", "description": "Place names such as \"Paris, France\" or \"Austin, TX\".", "items": { "type": "string" } }, "startUrls": { "title": "Search URLs", "type": "array", "description": "Optional full airbnb.com/s/… search URLs (filters in the URL are kept).", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Needed to get total stay prices." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD." }, "adults": { "title": "Adults", "type": "integer", "description": "Number of adult guests.", "default": 2 }, "children": { "title": "Children", "type": "integer", "description": "Number of children.", "default": 0 }, "infants": { "title": "Infants", "type": "integer", "description": "Number of infants.", "default": 0 }, "pets": { "title": "Pets", "type": "integer", "description": "Number of pets.", "default": 0 }, "currency": { "title": "Currency", "type": "string", "description": "ISO currency code, e.g. USD, EUR, GBP.", "default": "USD" }, "locale": { "title": "Language", "type": "string", "description": "Interface language, e.g. en-US, fr-FR.", "default": "en-US" }, "priceMin": { "title": "Min price", "type": "integer", "description": "Minimum nightly price in the chosen currency." }, "priceMax": { "title": "Max price", "type": "integer", "description": "Maximum nightly price in the chosen currency." }, "minBeds": { "title": "Min beds", "type": "integer", "description": "Minimum number of beds." }, "minBedrooms": { "title": "Min bedrooms", "type": "integer", "description": "Minimum number of bedrooms." }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Adds amenities, sub-ratings, host name, room type, capacity, superhost flag (one extra page per listing).", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Cap on billed results. Airbnb exposes up to ~270 listings per search; split large areas into several searches.", "default": 100 }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Skip listings already returned by a previous run (price/availability monitoring of new listings).", "default": false }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Detail pages fetched in parallel.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional datacenter proxy if Airbnb blocks the default IP. Residential proxy is not supported (uneconomic at this price) and is replaced with datacenter." }, "roomIds": { "title": "Room IDs", "type": "array", "description": "Airbnb listing IDs (the number in airbnb.com/rooms/) to scrape directly. Room URLs in Search URLs also work.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }