Search listings
search_listingsSearches Livuma's live Bali rental and property-sale inventory with the same results, filters and prices as the livuma.com search page. Returns { items, page, pageSize, total, hasMore, filteredAfterPaging }. Each item has the canonical url, the primary photo, the price for this search (the stay total when dates are given, otherwise the per-period rate), the host's rates and minimum stays, amenities, rating, coordinates and isBookable. total is the number of database matches. When filteredAfterPaging is true, the exact per-stay price was applied after paging, so a page can hold fewer items than pageSize while hasMore is still true. One area is searched per request. Search results are not a booking quote: availability, the applicable rate and the exact price are confirmed only by the availability check for specific dates.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_listings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | One area name, e.g. "Canggu". Free text, geocoded server-side. | |
| page | No | 1-based page number. | |
| offer | No | "rent" or "sale". Omit for both. | |
| currency | No | "IDR" (default), "USD", or "EUR". | |
| latitude | No | Center latitude for coordinate-based location filtering (use with longitude; alternative to area). | |
| maxPrice | No | 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 | No | Minimum budget in `currency`, same unit rules as maxPrice. | |
| minRooms | No | Minimum number of bedrooms. | |
| pageSize | No | Results per page, 1-100 (default 20). | |
| amenities | No | Amenity filters, e.g. ["pool","wifi","pet_friendly"]. | |
| longitude | No | Center longitude for coordinate-based location filtering (use with latitude). | |
| excludeIds | No | Listing GUIDs to exclude, e.g. results already shown to the user. | |
| rentalMode | No | 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 | No | Check-in date, yyyy-MM-dd. | |
| areaRadiusKm | No | Search radius in km around the area or the coordinates (default 10, max 20). | |
| checkOutDate | No | Check-out date, yyyy-MM-dd. Omit for open_ended and yearly. | |
| propertyType | No | Property type name, e.g. "Villa", "Apartment". | |
| ownershipType | No | Ownership type for sales, e.g. "Freehold". Not used for rentals. | |
| includeInsights | No | Include AI-extracted photo and description insights. Off by default — they are large. |