{ "openapi": "3.0.1", "info": { "title": "Airbnb Listings Scraper — Prices, Ratings & Changes", "description": "Airbnb search results for any place: price per night and total for your dates, rating, reviews, bedrooms, beds, baths, Guest favourite and Superhost badges, coordinates and photo. Run it again or on a schedule to get new listings, price changes and rank moves since the last run. No login.", "version": "0.1", "x-build-id": "XaET7b9ve9tJg5z6j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~airbnb-listings-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-airbnb-listings-tracker", "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/northbell~airbnb-listings-tracker/runs": { "post": { "operationId": "runs-sync-northbell-airbnb-listings-tracker", "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/northbell~airbnb-listings-tracker/run-sync": { "post": { "operationId": "run-sync-northbell-airbnb-listings-tracker", "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": [ "locations" ], "properties": { "locations": { "title": "Places", "type": "array", "description": "One place per line, in English with the country: \"Lisbon, Portugal\", \"Kyoto, Japan\", \"Alfama, Lisbon\". You can also paste an airbnb.com/s/… search link. Airbnb returns at most about 270 listings per place, so for a big city search a neighbourhood or add a price range.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Optional, YYYY-MM-DD (today or later). Give both dates to get every listing priced for the same stay, which is what you need to compare prices and track price changes. Leave both empty and Airbnb picks a 5-night window per listing." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Optional, YYYY-MM-DD, after the check-in date. Stays of 28 nights or more come back with a monthly price (priceMonthly) instead of a total." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adults the search is priced for (1 to 16).", "default": 2 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "JPY", "AUD", "CAD", "CHF", "KRW", "MXN", "BRL", "INR", "SEK", "NOK", "DKK", "PLN", "CZK", "HUF", "TRY", "ZAR", "NZD", "SGD", "HKD", "THB", "IDR", "MYR", "PHP", "AED", "ILS", "TWD", "CNY", "ARS", "CLP", "COP", "PEN", "SAR", "RON", "BGN", "VND", "EGP", "MAD", "UAH" ], "type": "string", "description": "Currency of the prices. Airbnb converts for you.", "default": "USD" }, "maxListingsPerLocation": { "title": "Max listings per place", "minimum": 1, "maximum": 300, "type": "integer", "description": "How many listings to read for each place, in Airbnb's order (18 per page). Airbnb stops at about 270 per search. Keep it the same between runs so the changes since the last run are comparable.", "default": 50 }, "minPrice": { "title": "Min price per night", "minimum": 0, "type": "integer", "description": "Optional. Only listings from this price per night, in the chosen currency. Applied by Airbnb." }, "maxPrice": { "title": "Max price per night", "minimum": 0, "type": "integer", "description": "Optional. Only listings up to this price per night, in the chosen currency. Applied by Airbnb." } } }, "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 } } } } } } } } } }