{ "openapi": "3.0.1", "info": { "title": "Airbnb Scraper: Every Stay, Past the 15-Page Limit", "description": "Every stay of an Airbnb search, past the 15 pages Airbnb shows, checked against its count. $0.20 per 1,000 listings. 848 of 848 in McCall, Idaho. Dates, guests.", "version": "0.1", "x-build-id": "CMSdewa2QBSYXSx1a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luzivanlt~airbnb-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luzivanlt-airbnb-listings-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/luzivanlt~airbnb-listings-scraper/runs": { "post": { "operationId": "runs-sync-luzivanlt-airbnb-listings-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/luzivanlt~airbnb-listings-scraper/run-sync": { "post": { "operationId": "run-sync-luzivanlt-airbnb-listings-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": { "locations": { "title": "Locations", "type": "array", "description": "Places to search, one per line, as you would type them in Airbnb's search box: a city, a region, a neighborhood (McCall, Idaho; Lisbon, Portugal). Each place is one search, up to 120 characters. The dates, guests and price range below apply to them. A link here is refused: paste it under Search links. Example: Lisbon, Portugal", "items": { "type": "string" } }, "startUrls": { "title": "Search links", "type": "array", "description": "Airbnb search results links for stays (airbnb.com/s//homes) from any Airbnb site (airbnb.co.uk, airbnb.de, …), copied from your browser after you set the dates, guests and filters you want. Each link is read from its first page and keeps its own dates, guests and filters; the fields below apply to the locations only, except the currency. Example: https://www.airbnb.com/s/Lisbon/homes?adults=2", "items": { "type": "string" } }, "checkIn": { "title": "Check-in", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Check-in date for the locations, YYYY-MM-DD; give it with the check-out date. It cannot be in the past, and a stay can be at most a year long. With dates, prices are for that stay and only places free on those dates are listed. Without, Airbnb picks a short stay to price each place. Example: 2026-12-10" }, "checkOut": { "title": "Check-out", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Check-out date for the locations, YYYY-MM-DD. Give it with the check-in date: it must come after it, at most a year later. Search links keep their own dates. Leave both empty to search without dates. Example: 2026-12-14" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Adult guests, for the locations, from 1 to 16. Give dates and guests and every price is for that stay. Leave it empty to search without a guest count. Search links keep their own guests. Example: 2" }, "children": { "title": "Children", "minimum": 0, "maximum": 15, "type": "integer", "description": "Children (ages 2 to 12), for the locations, from 0 to 15. Leave it empty or at 0 to search without children. Give dates and guests and every price is for that stay. Search links keep their own guests. Example: 1" }, "infants": { "title": "Infants", "minimum": 0, "maximum": 5, "type": "integer", "description": "Infants (under 2), for the locations, from 0 to 5. Leave it empty or at 0 to search without infants. Give dates and guests and every price is for that stay. Search links keep their own guests. Example: 1" }, "pets": { "title": "Pets", "minimum": 0, "maximum": 5, "type": "integer", "description": "Pets, for the locations, from 0 to 5. With pets, only places that allow them are listed. Leave it empty or at 0 to search without pets. Search links keep their own guests and filters. Example: 1" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "For the locations: only places priced at least this much, in the currency below, a whole number from 0 to 1,000,000. Airbnb filters on the whole stay's price when you give dates. Leave it empty for no minimum. Search links keep their own price range. Example: 100" }, "maxPrice": { "title": "Maximum price", "minimum": 1, "type": "integer", "description": "For the locations: only places priced at most this much, in the currency below, a whole number from 1 to 1,000,000. It must be above the minimum price. Leave it empty for no maximum. Search links keep their own price range. Example: 500" }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for the prices (USD, EUR, GBP, …), for the locations and the search links. USD by default; a search link keeps its own currency unless you set one here. The minimum and maximum price are in this currency. Example: EUR" }, "maxListingsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop each search after this many listings, from 1 to 50,000 (1,000 by default). Airbnb's own site shows at most 15 pages of a search; this Actor goes past that to every place Airbnb counts, so set this above Airbnb's count to get them all. You pay per listing saved ($0.20 per 1,000), so this also caps what each search costs. Example: 5000", "default": 1000 } } }, "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 } } } } } } } } } }