{ "openapi": "3.0.1", "info": { "title": "Airbnb Full Year Price Tracker Scraper", "description": "Airbnb Full Year Price Tracker Scraper — Track Airbnb listing prices across an entire year, including nightly rates, availability, cleaning fees, guest capacity, ratings, and listing details. Useful for price tracking, rental market research, revenue analysis, and investment insights.", "version": "0.2", "x-build-id": "QySZ9ZNW0qTFOxcpf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fastdataapi~airbnb-full-year-price-tracker-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fastdataapi-airbnb-full-year-price-tracker-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/fastdataapi~airbnb-full-year-price-tracker-scraper/runs": { "post": { "operationId": "runs-sync-fastdataapi-airbnb-full-year-price-tracker-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/fastdataapi~airbnb-full-year-price-tracker-scraper/run-sync": { "post": { "operationId": "run-sync-fastdataapi-airbnb-full-year-price-tracker-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", "required": [ "startUrls", "checkInDate" ], "properties": { "startUrls": { "title": "🔗 Airbnb listing URLs or IDs", "type": "array", "description": "Add one or more Airbnb listing URLs (any Airbnb domain, e.g. https://www.airbnb.co.uk/rooms/7431972) or numeric listing IDs (e.g. 7431972). Each listing is tracked separately; duplicates are removed. The domain you use decides the canonical URL in the output.", "items": { "type": "string" } }, "checkInDate": { "title": "📅 First check-in date", "type": "string", "description": "The first check-in date to price, in YYYY-MM-DD format. A date in the past is moved to today, because Airbnb shows no prices for past dates.", "default": "2026-08-01" }, "stayDays": { "title": "🔢 Nights per stay", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many nights each priced stay lasts. Check-out = check-in + this many nights. If it is shorter than a host's minimum stay, Airbnb returns no price for those dates.", "default": 1 }, "numberOfDays": { "title": "🔢 Check-in dates to track", "minimum": 1, "maximum": 365, "type": "integer", "description": "How many check-in dates to price per listing, one row per date, starting at the first check-in date. Free plan: up to 20 date rows per run (all listings together) and 200 per month; paid plans have no limit.", "default": 60 }, "adults": { "title": "🔢 Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests used for every price quote.", "default": 2 }, "children": { "title": "🔢 Children", "minimum": 0, "maximum": 15, "type": "integer", "description": "Number of children used for every price quote.", "default": 0 }, "infants": { "title": "🔢 Infants", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of infants (under 2) used for every price quote.", "default": 0 }, "pets": { "title": "🔢 Pets", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of pets used for every price quote. Pet fees, when the host charges them, are part of the price.", "default": 0 }, "currency": { "title": "🔧 Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "3-letter currency code for all prices, e.g. USD, GBP, EUR.", "default": "USD" }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings. The run starts on a direct connection. If Airbnb blocks it, the Actor switches to these proxy settings when Apify Proxy is on (and to a residential proxy if those are blocked too), or straight to a residential proxy when Apify Proxy is off. Your own proxy URLs are not used." } } }, "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 } } } } } } } } } }