{ "openapi": "3.0.1", "info": { "title": "Airbnb Calendar Availability Scraper", "description": "Read an authorized Airbnb iCalendar export to return date-level blocked and inferred-open availability. Use for host operations and STR workflows, not public listing scraping. Returns one row per date with availability and block count. $0.002/day plus a $0.00005 start fee; platform usage extra.", "version": "0.2", "x-build-id": "DDMbH22yNO84lzvNc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~airbnb-calendar-availability-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-airbnb-calendar-availability-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/khadinakbar~airbnb-calendar-availability-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-airbnb-calendar-availability-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/khadinakbar~airbnb-calendar-availability-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-airbnb-calendar-availability-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": { "calendarUrls": { "title": "Authorized Airbnb iCalendar URLs", "maxItems": 20, "type": "array", "description": "Use this when you have permission to read one or more Airbnb calendar exports. Enter HTTPS Airbnb iCalendar links such as https://www.airbnb.com/calendar/ical/12345678.ics?s=REDACTED. Up to 20 feeds are accepted and their tokenized URLs are treated as secret. This is not a public listing URL or an Airbnb account-login field.", "items": { "type": "string" } }, "icalText": { "title": "Authorized iCalendar text", "type": "string", "description": "Use this when you can paste an authorized Airbnb iCalendar document instead of exposing its export URL. Paste the complete text beginning with BEGIN:VCALENDAR, for example a feed copied from your host tooling. It is optional when calendarUrls is supplied and is treated as secret. This is not a booking confirmation, guest message, or public listing HTML." }, "startDate": { "title": "First date", "type": "string", "description": "Use this when you need a calendar window that starts on a particular day. Enter an ISO date such as 2026-08-01; an empty value starts on the day the Actor runs. The selected range is inclusive and cannot exceed maxDaysPerCalendar. This is not a check-in request sent to Airbnb.", "default": "" }, "endDate": { "title": "Last date", "type": "string", "description": "Use this when you need a calendar window that ends on a particular day. Enter an ISO date such as 2026-10-31; an empty value uses startDate plus maxDaysPerCalendar minus one. The selected range is inclusive and must end on or after startDate. This is not the departure date of an Airbnb booking flow.", "default": "" }, "maxDaysPerCalendar": { "title": "Maximum days per calendar", "minimum": 1, "maximum": 731, "type": "integer", "description": "Use this when you want to bound returned date-level availability and the associated per-day charge. Enter an integer from 1 to 731, for example 366; the default is 366. If explicit dates span more days than this limit, the Actor returns an actionable invalid-input result. This is not a network-request or listing-count limit.", "default": 366 } } }, "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 } } } } } } } } } }