{ "openapi": "3.0.1", "info": { "title": "Airbnb Scraper & Price Monitor - Listing Details, Availability", "description": "For hosts and revenue managers tracking competitor listings: Airbnb listing details by room URL or ID with total and nightly price for your dates, availability and the reason if not, rating, reviews, host, Superhost, bedrooms, amenities. Monitor returns only price, availability or rating changes.", "version": "0.1", "x-build-id": "8vvGrNN0Ydm5GVzoV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~airbnb-listing-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-airbnb-listing-price-monitor", "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/neverempty~airbnb-listing-price-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-airbnb-listing-price-monitor", "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/neverempty~airbnb-listing-price-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-airbnb-listing-price-monitor", "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": "Airbnb listing URLs or listing numbers", "type": "array", "description": "Airbnb listings (rooms), one per line: a listing URL such as https://www.airbnb.com/rooms/53997462 (any Airbnb country domain works, anything after ? is ignored) or just the listing number 53997462. Search pages, experiences, wishlists, host profiles and /h/ short links are not read. Up to 500 listings per run. If empty, three example listings are used.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Arrival date for the price: YYYY-MM-DD (for example 2026-12-18) or +N for N days from today (for example +14). If empty, the stay starts 30 days from today." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Departure date: YYYY-MM-DD or +N days from today. If empty: 1 night after checkIn, or 2 nights when checkIn is also empty. At most 90 nights." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adults for the price and availability (1-16). If empty, 1." }, "children": { "title": "Children (2-12)", "minimum": 0, "maximum": 15, "type": "integer", "description": "Number of children (0-15). If empty, 0." }, "infants": { "title": "Infants (under 2)", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of infants (0-5). If empty, 0." }, "pets": { "title": "Pets", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of pets (0-5). If empty, 0. Listings that do not allow pets answer as unavailable." }, "currency": { "title": "Currency", "type": "string", "description": "3-letter currency code Airbnb shows prices in, such as USD, EUR, GBP, CAD, AUD, JPY. If empty, USD." }, "onlyChanges": { "title": "Monitor mode: only listings that changed", "type": "boolean", "description": "Return only listings whose total price, availability, rating or number of reviews changed since the last run with the same watch name and the same dates, guests and currency, plus listings new to the watch. Each changed row lists changedFields and the previous values. A change is read twice before it is returned. The first run returns every listing as the starting point. An unchanged listing is not returned as a row; it is charged only the small listing-checked fee.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the remembered state used to compare runs (letters, digits, dot, dash, underscore; up to 40). Setting it (or turning on monitor mode) fills changeType, changedFields and previousValues. Use a different name for each list of listings you track on its own schedule. With monitor mode on and no name, the name \"default\" is used. Different dates, guests or currency are remembered separately." }, "minPriceChangePercent": { "title": "Smallest price change to report (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "In monitor mode, a total price move smaller than this percentage is not reported (currency conversion moves prices a little every day). Small moves add up: the remembered price stays the same until the move passes this size. 0 reports every change. If empty, 1." }, "resetMonitoringState": { "title": "Forget what this watch remembered", "type": "boolean", "description": "Start this watch over: forget the remembered listings before this run, so every listing is returned as a first check.", "default": false } } }, "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 } } } } } } } } } }