airbnb.stay.search
View connectorSearch Airbnb stays with dates, filters and map bounds
POST /v1/operations/airbnb.stay.searchHeaders
Authorization: Bearer YOUR_CONNECTOR_TOKEN
Content-Type: application/jsonInputs
| Parameter | Example type | Example value |
|---|---|---|
| query | string | "London" |
| stay | object | {"checkin":"2026-10-04","checkout":"2026-10-07","adults":2,"currency":"GBP"} |
| filters | object | {"price_max":1000,"amenities":[7],"min_rating":4.8} |
Example input
{
"query": "London",
"stay": {
"checkin": "2026-10-04",
"checkout": "2026-10-07",
"adults": 2,
"currency": "GBP"
},
"filters": {
"price_max": 1000,
"amenities": [
7
],
"min_rating": 4.8
}
}Illustrative response for the example input. Availability, prices and result order vary. Replace example references and URLs with values returned by your own requests.
Example response
{
"items": [
{
"listing_id": "123",
"listing": {
"title": "Example London stay",
"avgRatingLocalized": "4.95"
},
"selected_stay": {
"checkin": "2026-10-04",
"checkout": "2026-10-07",
"adults": 2,
"currency": "GBP"
}
}
],
"filters": {},
"filter_state": [],
"next_cursor": null,
"search_context": {
"checkin": "2026-10-04",
"checkout": "2026-10-07",
"adults": 2,
"currency": "GBP"
},
"date_search": null,
"map": null
}Input schema
{
"$id": "https://useajar.com/schemas/airbnb/stay-search.input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"oneOf": [
{
"properties": {
"stay": {
"not": {
"anyOf": [
{
"required": [
"checkin"
]
},
{
"required": [
"checkout"
]
}
]
}
}
},
"required": [
"flexible_dates"
]
},
{
"not": {
"required": [
"flexible_dates"
]
},
"properties": {
"stay": {
"required": [
"checkin",
"checkout"
]
}
}
}
],
"properties": {
"cursor": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"filters": {
"additionalProperties": false,
"properties": {
"amenities": {
"items": {
"maximum": 100000000,
"minimum": 0,
"type": "integer"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"bathroom_privacy": {
"items": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"flexible_cancellation": {
"type": "boolean"
},
"guest_favorite": {
"type": "boolean"
},
"host_languages": {
"items": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"ib": {
"type": "boolean"
},
"kg_and_tags": {
"items": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"l2_property_type_ids": {
"items": {
"maximum": 100000000,
"minimum": 0,
"type": "integer"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"min_bathrooms": {
"maximum": 10000000,
"minimum": 0,
"type": "number"
},
"min_bedrooms": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"min_beds": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"min_rating": {
"maximum": 5,
"minimum": 0,
"type": "number"
},
"neighborhood_ids": {
"items": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"price_max": {
"maximum": 10000000,
"minimum": 0,
"type": "number"
},
"price_min": {
"maximum": 10000000,
"minimum": 0,
"type": "number"
},
"room_types": {
"items": {
"enum": [
"Entire home/apt",
"Private room"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
},
"tier_ids": {
"items": {
"maximum": 100000000,
"minimum": 0,
"type": "integer"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
}
},
"required": [],
"type": "object"
},
"flexible_dates": {
"additionalProperties": false,
"properties": {
"duration": {
"enum": [
"weekend_trip",
"one_week",
"one_month"
],
"type": "string"
},
"months": {
"items": {
"enum": [
"january",
"february",
"march",
"april",
"may",
"june",
"july",
"august",
"september",
"october",
"november",
"december"
],
"type": "string"
},
"maxItems": 12,
"type": "array",
"uniqueItems": true
}
},
"required": [
"duration"
],
"type": "object"
},
"map_bounds": {
"additionalProperties": false,
"properties": {
"east": {
"maximum": 180,
"minimum": -180,
"type": "number"
},
"north": {
"maximum": 90,
"minimum": -90,
"type": "number"
},
"south": {
"maximum": 90,
"minimum": -90,
"type": "number"
},
"west": {
"maximum": 180,
"minimum": -180,
"type": "number"
},
"zoom": {
"maximum": 22,
"minimum": 0,
"type": "number"
}
},
"required": [
"north",
"south",
"east",
"west",
"zoom"
],
"type": "object"
},
"place_id": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"query": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"stay": {
"additionalProperties": false,
"properties": {
"adults": {
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"checkin": {
"format": "date",
"type": "string"
},
"checkout": {
"format": "date",
"type": "string"
},
"children": {
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"currency": {
"description": "Airbnb display currency for prices and price filters; GBP by default. No local currency conversion.",
"enum": [
"AED",
"AUD",
"BRL",
"BGN",
"CAD",
"CHF",
"CLP",
"CNY",
"COP",
"CRC",
"CZK",
"DKK",
"EGP",
"EUR",
"GBP",
"GHS",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"JPY",
"KES",
"KRW",
"KZT",
"MAD",
"MXN",
"MYR",
"NOK",
"NZD",
"PEN",
"PLN",
"PHP",
"QAR",
"RON",
"SAR",
"SEK",
"SGD",
"THB",
"TRY",
"TWD",
"UAH",
"UGX",
"USD",
"UYU",
"VND",
"ZAR"
],
"type": "string"
},
"infants": {
"maximum": 5,
"minimum": 0,
"type": "integer"
},
"pets": {
"maximum": 5,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"required": [
"query",
"stay"
],
"type": "object"
}