{ "openapi": "3.0.1", "info": { "title": "Airbnb Multi-Listing Hosts by City", "description": "Find the hosts running more than one Airbnb listing in a city. One row per host with portfolio size, superhost status, average rating, total reviews and median price. The listing data is public; the portfolio is not, and that is the product.", "version": "1.0", "x-build-id": "bsS9hSNcHmk0qLrMs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wellbuilt_zythem~airbnb-host-portfolio/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wellbuilt_zythem-airbnb-host-portfolio", "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-host-portfolio/runs": { "post": { "operationId": "runs-sync-wellbuilt_zythem-airbnb-host-portfolio", "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-host-portfolio/run-sync": { "post": { "operationId": "run-sync-wellbuilt_zythem-airbnb-host-portfolio", "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": "Cities", "type": "array", "description": "Write them as you would in the Airbnb search box: \"Madrid, Spain\", \"Lisbon, Portugal\", \"Austin, TX\".", "default": [ "Austin, TX" ], "items": { "type": "string" } }, "minListings": { "title": "Minimum listings per host", "minimum": 1, "type": "integer", "description": "The filter that defines the product. 2 finds anyone with a second flat. 3 finds the operators worth a sales call: 5 to 22 per city with 20 pages in Austin, New York, Madrid, Miami, Los Angeles, Chicago and Nashville (5 November 2026). 5 returned 0 to 7 per city, because a run compares at most about 300 listings.", "default": 2 }, "outputMode": { "title": "What to return", "enum": [ "hosts", "listings", "both" ], "type": "string", "description": "Hosts is one row per host, which is what most buyers want. Listings is the raw listing rows with a host id attached. Both returns hosts first, then listings.", "default": "hosts" }, "pagesPerLocation": { "title": "Pages per city", "minimum": 1, "maximum": 20, "type": "integer", "description": "About 16 to 20 listings per page; 20 pages, the maximum, read about 300. On 5 November 2026, 20 pages found 29 to 41 hosts with two or more listings in Austin, New York, Madrid, Miami, Los Angeles, Chicago and Nashville; in the first three, 8 pages found 11 to 18. More pages means more listings compared against each other, which is what makes a shared host show up.", "default": 20 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "AUD", "CAD" ], "type": "string", "description": "Prices come back in this currency. Without it Airbnb uses the currency of the server's country, which is not yours.", "default": "USD" }, "maxResults": { "title": "Maximum rows", "minimum": 0, "type": "integer", "description": "0 for no limit. Hosts arrive sorted by portfolio size, so a capped run keeps the biggest operators.", "default": 0 }, "includeHotels": { "title": "Include hotels", "type": "boolean", "description": "Hotels listed on Airbnb (Fairmont, Drury Inn and the like) are left out by default, already in the search, so every page is filled with flats and rooms run by hosts. Turn this on to keep them; their rows come with isHotel set to true.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave it off. The Actor connects directly and only requests that Airbnb refuses are retried through the Apify proxy, which is faster: 14 s against 75 s for the same city in our test of 31 October 2026. Turn a proxy on only if you need every request to leave from it.", "default": { "useApifyProxy": 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 } } } } } } } } } }