Input schema (JSON)
{
"type": "object",
"properties": {
"area": {
"type": [
"string",
"null"
],
"default": null,
"description": "One area name, e.g. \"Canggu\". Free text, geocoded server-side."
},
"page": {
"type": [
"integer",
"null"
],
"default": null,
"description": "1-based page number."
},
"offer": {
"type": [
"string",
"null"
],
"default": null,
"description": "\"rent\" or \"sale\". Omit for both."
},
"currency": {
"type": [
"string",
"null"
],
"default": null,
"description": "\"IDR\" (default), \"USD\", or \"EUR\"."
},
"latitude": {
"type": [
"number",
"null"
],
"default": null,
"description": "Center latitude for coordinate-based location filtering (use with longitude; alternative to area)."
},
"maxPrice": {
"type": [
"number",
"null"
],
"default": null,
"description": "Budget in `currency`, compared against the price shown for this search: the stay TOTAL when check-in and check-out are given, otherwise the monthly rate (yearly in yearly mode) or the asking price for sales."
},
"minPrice": {
"type": [
"number",
"null"
],
"default": null,
"description": "Minimum budget in `currency`, same unit rules as maxPrice."
},
"minRooms": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Minimum number of bedrooms."
},
"pageSize": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Results per page, 1-100 (default 20)."
},
"amenities": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"default": null,
"description": "Amenity filters, e.g. [\"pool\",\"wifi\",\"pet_friendly\"]."
},
"longitude": {
"type": [
"number",
"null"
],
"default": null,
"description": "Center longitude for coordinate-based location filtering (use with latitude)."
},
"excludeIds": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"default": null,
"description": "Listing GUIDs to exclude, e.g. results already shown to the user."
},
"rentalMode": {
"type": [
"string",
"null"
],
"default": null,
"description": "How a rental stay is priced: \"dates\" (default — give checkInDate + checkOutDate, or neither to browse monthly rates), \"open_ended\" (checkInDate only, monthly rate, no end date), \"yearly\" (checkInDate only, fixed 12-month term)."
},
"checkInDate": {
"type": [
"string",
"null"
],
"default": null,
"description": "Check-in date, yyyy-MM-dd."
},
"areaRadiusKm": {
"type": [
"number",
"null"
],
"default": null,
"description": "Search radius in km around the area or the coordinates (default 10, max 20)."
},
"checkOutDate": {
"type": [
"string",
"null"
],
"default": null,
"description": "Check-out date, yyyy-MM-dd. Omit for open_ended and yearly."
},
"propertyType": {
"type": [
"string",
"null"
],
"default": null,
"description": "Property type name, e.g. \"Villa\", \"Apartment\"."
},
"ownershipType": {
"type": [
"string",
"null"
],
"default": null,
"description": "Ownership type for sales, e.g. \"Freehold\". Not used for rentals."
},
"includeInsights": {
"type": "boolean",
"default": false,
"description": "Include AI-extracted photo and description insights. Off by default — they are large."
}
}
}