Airbnb Stay Listings

{  "type": "object",  "additionalProperties": false,  "properties": {    "location": {      "type": "string",      "maxLength": 2000,      "title": "Destination",      "description": "Typed exactly as it would be into Airbnb’s search box. Ignored when map bounds are set.",      "default": "Lisbon, Portugal",      "examples": [        "Lisbon, Portugal"      ]    },    "checkin": {      "type": "string",      "maxLength": 2000,      "title": "Check-in",      "description": "YYYY-MM-DD. Leave both dates empty for undated prices — Airbnb then quotes its own default stay, which is not comparable between runs.",      "examples": [        "2026-10-10"      ]    },    "checkout": {      "type": "string",      "maxLength": 2000,      "title": "Check-out",      "description": "YYYY-MM-DD. Only applied together with a check-in.",      "examples": [        "2026-10-14"      ]    },    "adults": {      "type": "number",      "minimum": 1,      "maximum": 16,      "title": "Adults",      "description": "Guest count filters out listings too small for the party, so it changes which listings exist, not only their price.",      "default": 2    },    "children": {      "type": "number",      "minimum": 0,      "maximum": 15,      "title": "Children",      "default": 0    },    "currency": {      "type": "string",      "maxLength": 2000,      "title": "Currency",      "description": "ISO code. Airbnb renders every price in it, so mixing currencies between runs makes the price columns incomparable.",      "default": "USD",      "examples": [        "USD"      ]    },    "maxListings": {      "type": "number",      "minimum": 1,      "maximum": 50000,      "title": "Max listings per run",      "description": "Rows upsert on re-run, so this bounds one run rather than the dataset.",      "default": 540    },    "priceMin": {      "type": "number",      "minimum": 0,      "maximum": 100000,      "title": "Min price per night",      "description": "0 leaves the filter off.",      "default": 0    },    "priceMax": {      "type": "number",      "minimum": 0,      "maximum": 100000,      "title": "Max price per night",      "description": "0 leaves the filter off. Bounds are per night before fees, in the run’s currency, and Airbnb applies them server-side — a 30-60 cap and a 400 floor return visibly different markets.",      "default": 0    },    "infants": {      "type": "number",      "minimum": 0,      "maximum": 5,      "title": "Infants",      "default": 0    },    "pets": {      "type": "number",      "minimum": 0,      "maximum": 5,      "title": "Pets",      "description": "Non-zero restricts results to pet-friendly listings.",      "default": 0    },    "mapBounds": {      "type": "string",      "maxLength": 2000,      "title": "Map bounds",      "description": "swLat,swLng,neLat,neLng. Searches a viewport instead of a named destination — the way to cover an area with no Airbnb place id, or to sweep a city in tiles.",      "examples": [        "41.34,2.10,41.42,2.23"      ]    },    "placeId": {      "type": "string",      "maxLength": 2000,      "title": "Place id",      "description": "Google place id for the destination. Worth setting where the name is ambiguous; Airbnb resolves the text itself otherwise.",      "examples": [        "ChIJ…"      ]    },    "zoomLevel": {      "type": "number",      "minimum": 1,      "maximum": 20,      "title": "Zoom level",      "description": "Accompanies map bounds. Only affects how Airbnb clusters, not what it returns.",      "default": 12    },    "maxPages": {      "type": "number",      "minimum": 1,      "maximum": 200,      "title": "Max pages",      "description": "Airbnb hands out 15 page cursors (18 results each) and then stops; pages beyond that need deep paging, and repeat more the further they go.",      "default": 30    },    "deepPaging": {      "type": "boolean",      "title": "Page past Airbnb’s last cursor",      "description": "Airbnb stops issuing cursors after page 15, but still answers a hand-built one — its cursor is just a base64 result offset. Measured on Lisbon, that took one search from 229 listings to 331. Turn it off to stay strictly inside what Airbnb offers.",      "default": true    },    "locale": {      "type": "string",      "maxLength": 2000,      "title": "Locale",      "description": "Response language. Changing it changes the number formatting inside the price strings, which the price parser assumes is English.",      "default": "en"    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between pages (ms)",      "default": 1200    },    "apiKey": {      "type": "string",      "maxLength": 2000,      "title": "API key override",      "description": "Defaults to AIRBNB_API_KEY, then the public browser key airbnb.com ships in its own page source. Set only if Airbnb rotates that key."    },    "persistedQueryHash": {      "type": "string",      "maxLength": 2000,      "title": "Persisted query hash",      "description": "The hash in the request path. Airbnb ignores it because the request carries its own query document, so this is here for the day it stops doing so."    }  }}