{ "openapi": "3.0.1", "info": { "title": "Airbnb Price & Availability Scraper — MaviStay", "description": "Airbnb scraper for exact stay price and Airbnb availability checks. Verify the bookable total, nightly average and taxes for exact dates, or run a destination market scan. No login; pay only for delivered data. Unofficial.", "version": "0.2", "x-build-id": "WMXgqAYFssLush8qt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mavilinklabs~airbnb-verified-price/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mavilinklabs-airbnb-verified-price", "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/mavilinklabs~airbnb-verified-price/runs": { "post": { "operationId": "runs-sync-mavilinklabs-airbnb-verified-price", "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/mavilinklabs~airbnb-verified-price/run-sync": { "post": { "operationId": "run-sync-mavilinklabs-airbnb-verified-price", "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": { "mode": { "title": "Choose your workflow", "enum": [ "exactCompare", "fastScan" ], "type": "string", "description": "Exact Price checks specific listings against Airbnb's booking and checkout surfaces. Fast Scan explores search-card price signals for a destination.", "default": "exactCompare" }, "listings": { "title": "Listing URLs or IDs", "type": "array", "description": "Exact Compare / Exact Price: paste one or more Airbnb room URLs or listing IDs. Required for this workflow and ignored by Fast Scan.", "items": { "type": "string" } }, "searchQuery": { "title": "Destination", "type": "string", "description": "Enter a place such as London, United Kingdom. Leave blank when verifying specific listings." }, "searchUrl": { "title": "Airbnb search URL", "type": "string", "description": "Optional Airbnb /s/.../homes URL instead of a destination name." }, "maxListings": { "title": "Maximum market results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique discovery cards to deliver and charge. Duplicates and failed cards are not charged." }, "startDate": { "title": "Check-in date", "type": "string", "description": "Check-in date for either mode. Use together with check-out to price this stay." }, "endDate": { "title": "Check-out date", "type": "string", "description": "Check-out date for either mode. It must be after check-in and within 12 months." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests. Used by Exact Compare and Fast Scan.", "default": 2 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "TRY", "AED", "CHF", "CAD", "AUD", "JPY", "SEK", "NOK", "DKK", "PLN", "CZK", "MXN", "BRL", "ZAR", "SGD", "THB", "INR", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BSD", "BTN", "BWP", "BYN", "BZD", "CDF", "CLP", "CNY", "COP", "CRC", "CUC", "CUP", "CVE", "DJF", "DOP", "DZD", "EGP", "ERN", "ETB", "FJD", "FKP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "IQD", "IRR", "ISK", "JMD", "JOD", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MYR", "MZN", "NAD", "NGN", "NIO", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SHP", "SLE", "SLL", "SOS", "SRD", "SSP", "STN", "SVC", "SYP", "SZL", "TJS", "TMT", "TND", "TOP", "TTD", "TWD", "TZS", "UAH", "UGX", "UYU", "UZS", "VES", "VND", "VUV", "WST", "XAF", "XCD", "XCG", "XDR", "XOF", "XPF", "XSU", "YER", "ZMW", "ZWG", "ZWL" ], "type": "string", "description": "Currency used for the request and every returned price.", "default": "USD" }, "marketCountry": { "title": "Market country", "enum": [ "US", "GB", "TR", "DE", "FR", "ES", "IT", "NL", "AE", "CA", "AU", "JP", "CH", "SE", "PT", "GR", "MX", "BR", "TH", "SG", "AC", "AD", "AF", "AG", "AI", "AL", "AM", "AN", "AO", "AQ", "AR", "AS", "AT", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BS", "BT", "BU", "BV", "BW", "BY", "BZ", "CC", "CD", "CF", "CG", "CI", "CK", "CL", "CM", "CN", "CO", "CP", "CQ", "CR", "CS", "CU", "CV", "CW", "CX", "CY", "CZ", "DD", "DG", "DJ", "DK", "DM", "DO", "DY", "DZ", "EA", "EC", "EE", "EG", "EH", "ER", "ET", "EU", "EZ", "FI", "FJ", "FK", "FM", "FO", "FX", "GA", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "HV", "IC", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "JE", "JM", "JO", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NH", "NI", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PW", "PY", "QA", "QO", "RE", "RH", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SU", "SV", "SX", "SY", "SZ", "TA", "TC", "TD", "TF", "TG", "TJ", "TK", "TL", "TM", "TN", "TO", "TP", "TT", "TV", "TW", "TZ", "UA", "UG", "UK", "UM", "UN", "UY", "UZ", "VA", "VC", "VD", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "XA", "XB", "XK", "YD", "YE", "YT", "YU", "ZA", "ZM", "ZR", "ZW", "ZZ" ], "type": "string", "description": "Country used for the request. It can change Airbnb taxes and prices independently of currency.", "default": "US" }, "locale": { "title": "Locale", "type": "string", "description": "Language used for Airbnb responses, for example en, tr, de or en-GB.", "default": "en" }, "calendarMonths": { "title": "Calendar months", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many months of availability to fetch per listing, starting from the current month (1-12).", "default": 3 }, "pricingMode": { "title": "Pricing mode", "enum": [ "sampled", "allAvailableDates" ], "type": "string", "description": "Sample a few dates, or price every eligible date with an explicit limit.", "default": "sampled" }, "quoteNights": { "title": "Nights per quote", "minimum": 0, "maximum": 30, "type": "integer", "description": "Use 0 for the listing's minimum-stay rule. Exact dates are priced as one stay.", "default": 0 }, "enrichPrices": { "title": "Get real price quotes", "type": "boolean", "description": "Fetch checkout-confirmed bookable totals and per-night breakdowns for eligible stays.", "default": true }, "maxQuotesPerListing": { "title": "Max price quotes per listing", "minimum": 1, "maximum": 24, "type": "integer", "description": "Maximum delivered and charged quotes per listing in sampled mode.", "default": 4 }, "maxPricedDates": { "title": "Maximum priced dates", "minimum": 1, "type": "integer", "description": "Required only for All available dates. Sets the quote limit per listing." }, "onCostLimitExceeded": { "title": "When the price limit is reached", "enum": [ "error", "truncate" ], "type": "string", "description": "Stop without pricing, or return only the first dates up to your limit.", "default": "error" }, "deepScan": { "title": "Deep scan (Fast Scan, optional)", "type": "boolean", "description": "Split a large map into tiles. Requires a bounding box and maximum cost.", "default": false }, "bbox": { "title": "Map area (Deep Scan)", "type": "object", "description": "Bounding box with west, south, east and north coordinates. Used only by Deep Scan." }, "maxCostUSD": { "title": "Maximum deep-scan cost (USD)", "minimum": 0.001, "maximum": 25, "type": "number", "description": "Hard request-cost stop required for Deep Scan." }, "maxSplitDepth": { "title": "Map split depth", "minimum": 0, "maximum": 8, "type": "integer", "description": "Maximum number of map subdivision levels used by Deep Scan." }, "minDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Minimum delay between Fast Scan search requests." }, "proxyConfiguration": { "title": "Network settings", "type": "object", "description": "Residential Apify Proxy is preselected for reliable public-page access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }