{ "openapi": "3.0.1", "info": { "title": "Airbnb Images Scraper With Metadata Enrichment", "description": "Airbnb Ld Scraper extracts listing details from any Airbnb property URL. Collect prices, photos, amenities, host info, ratings, availability, and descriptions. Ideal for market research, pricing analysis, investment insights, and workflows needing structured Airbnb listing data.", "version": "0.1", "x-build-id": "Meu2ae05PSyPVCGQ1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~airbnb-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-airbnb-images-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/api-empire~airbnb-images-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-airbnb-images-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/api-empire~airbnb-images-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-airbnb-images-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", "properties": { "roomUrls": { "title": "🏠 Airbnb room URLs", "type": "array", "description": "One or more Airbnb room page URLs, e.g. https://www.airbnb.com/rooms/782682596976136912. Add one per line. At least one URL is required (here or in the legacy 'urls' field below).", "items": { "type": "string" } }, "urls": { "title": "πŸ”— Legacy: room URLs (compat)", "type": "array", "description": "Legacy alias for 'Airbnb room URLs' β€” kept for compatibility with the original actor's input field. If both are set, entries from both lists are merged and de-duplicated.", "items": { "type": "string" } }, "fetchTimeoutSecs": { "title": "⏱️ Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Maximum time in seconds to wait for each page response before the request is skipped. Default: 30. Allowed range: 5–120.", "default": 30 }, "requestTimeoutSecs": { "title": "⏱️ Legacy: request timeout (compat)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Legacy alias for 'Request timeout (seconds)' β€” kept for compatibility with the original actor's input field. Used only if 'fetchTimeoutSecs' is not set." }, "includeListingContext": { "title": "πŸ—ΊοΈ Include listing context metadata", "type": "boolean", "description": "Adds `roomType`, `coordinates` (latitude/longitude) and `personCapacity` to each row, read from the listing's own page data. Also always adds a query-stripped `canonicalUrl` and a stable `listingId` regardless of this toggle. Turn off to skip the extra parsing step and get only the base fields.", "default": true }, "proxyConfiguration": { "title": "🌍 Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings. Configure proxy groups and country below if you want to use a proxy.", "properties": { "useApifyProxy": { "title": "βœ… Use Apify Proxy", "type": "boolean", "description": "When enabled, the run starts every request on Apify Proxy immediately instead of waiting for a block to be detected." }, "apifyProxyGroups": { "title": "πŸ“Œ Proxy groups", "type": "array", "items": { "type": "string" }, "description": "Apify proxy groups to use once proxy is engaged. Leave empty to use the platform default." }, "apifyProxyCountry": { "title": "🌎 Proxy country", "type": "string", "description": "Optional ISO-2 country code for the proxy (e.g. US, GB). Leave empty for no restriction." } } } } }, "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 } } }, "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 } } } } } } } } } }