Search Homejourney listings
search_listingsRead-only
Primary listing-discovery tool. Use this when a logged-in user asks what properties are available or supplies natural-language or structured Singapore property criteria. Omit query for a broad availability request; query is full-text search over project, title, address and description. pagination.total is the exact number of matching listings. Returns active, published, AI-channel-authorized, public-safe listing summaries only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| sort | No | newest is the recommended order; listed_newest is strictly by listing date. | newest |
| limit | No | ||
| query | No | ||
| towns | No | HDB towns or URA planning areas the listing lies in, such as "Tampines" or "Bukit Timah". | |
| tenure | No | ||
| psf_max | No | Price per square foot in SGD. | |
| psf_min | No | Price per square foot in SGD. | |
| bedrooms | No | ||
| district | No | ||
| size_max | No | Floor area in square feet. | |
| size_min | No | Floor area in square feet. | |
| districts | No | Singapore postal districts, such as "D09" or "15". | |
| mrt_lines | No | MRT lines; a listing matches when its nearest station is on one. Combines with mrt_stations as 'near any'. | |
| price_max | No | ||
| price_min | No | ||
| bedrooms_min | No | ||
| listing_type | No | ||
| mrt_stations | No | Nearest MRT station names, such as "Orchard" or "Tanjong Pagar". | |
| project_name | No | Exact condominium or development name. | |
| bathrooms_min | No | ||
| property_type | No | ||
| available_from | No | ||
| bedroom_counts | No | Exact bedroom counts to match, such as [2, 3]; 0 is a studio. Combines with bedrooms_min, so [0] plus bedrooms_min 5 means studio or 5+. | |
| hdb_flat_types | No | HDB flat types, such as "4-room" or "executive". | |
| bathroom_counts | No | Exact bathroom counts to match; combines with bathrooms_min. | |
| subletting_type | No | ||
| listed_within_days | No | ||
| lease_duration_months | No |