{ "openapi": "3.0.1", "info": { "title": "Airbnb New Listings & Price Drops by City", "description": "Airbnb listings for any city with two signals other scrapers skip: which listings are new (no reviews yet, or not seen in your last run) and which dropped their price (Airbnb's own 'originally' price, plus the change since your last run). Host name and Superhost on request. Schedule it for a feed.", "version": "1.0", "x-build-id": "rzD6trMlTyYZiWmd3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wellbuilt_zythem~airbnb-new-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wellbuilt_zythem-airbnb-new-listings", "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/wellbuilt_zythem~airbnb-new-listings/runs": { "post": { "operationId": "runs-sync-wellbuilt_zythem-airbnb-new-listings", "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/wellbuilt_zythem~airbnb-new-listings/run-sync": { "post": { "operationId": "run-sync-wellbuilt_zythem-airbnb-new-listings", "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": "Cities", "type": "array", "description": "Places as you would type them in Airbnb's search box, one per line: \"Austin, TX\", \"Nashville, TN\", \"Lisbon, Portugal\".", "items": { "type": "string" } }, "pagesPerLocation": { "title": "Pages per city", "minimum": 1, "maximum": 15, "type": "integer", "description": "Search pages to read per city (about 18 listings each, 30 on the first). 1 to 15.", "default": 3 }, "checkin": { "title": "Check-in", "type": "string", "description": "Date like 2026-11-07. With dates, prices are for that stay and comparable between runs. Without dates Airbnb shows a total for dates it picks." }, "checkout": { "title": "Check-out", "type": "string", "description": "Date like 2026-11-10. Give both dates or neither." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Guests for the price. Empty: Airbnb's default." }, "currency": { "title": "Currency", "type": "string", "description": "USD, EUR, GBP...", "default": "USD" }, "onlyChanges": { "title": "Only new listings and price drops since the last run", "type": "boolean", "description": "Deliver only listings not seen in the previous run of this feed, or whose price fell at least \"Price drop %\". Off: every listing found, with the same signals as columns.", "default": false }, "priceDropThresholdPct": { "title": "Price drop %", "minimum": 1, "type": "integer", "description": "A listing counts as a price drop when its price is at least this much lower than in the last run.", "default": 10 }, "includeHost": { "title": "Include host", "type": "boolean", "description": "Open each listing page for the host name, host id, Superhost badge, property type and capacity. One extra request per listing.", "default": false }, "maxResults": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Cap for the run. Empty for no cap." }, "stateStoreName": { "title": "Feed memory name", "type": "string", "description": "Key-value store that remembers the listings and prices seen. One name per feed; the same name every run.", "default": "airbnb-new-listings-seen" }, "resetState": { "title": "Forget previous runs", "type": "boolean", "description": "Start the feed memory from scratch in this run: everything will count as new.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Airbnb refuses some data-center addresses; Apify proxy is on by default.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }