Search listings
search_listingsSearch what is for sale or rent in Vietnam on this marketplace: apartments and rooms, motorbikes and cars, electronics, furniture, jobs, services and more. Words can include a district ("2 bedroom apartment district 7", "căn hộ quận 2"). Returns up to 20 live listings with price in VND and a link to each listing's page, where the person sees the photos and contacts the seller.
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 |
|---|---|---|---|
| q | No | What to look for, in English or Vietnamese; a district or area in the words narrows to it | |
| lang | No | Language of the titles (default "en") | |
| sort | No | "best" (the default) ranks by relevance and freshness; "recent" is newest first | |
| type | No | What the listing offers: for sale, for rent, a job, or a wanted ad | |
| limit | No | How many listings, 1–20 (default 10) | |
| offset | No | Skip this many results, for the next page (up to 200) | |
| category | No | A category slug from list_categories, e.g. "rentals", "vehicles", "electronics" | |
| province | No | City or province name, e.g. "Ho Chi Minh", "Ha Noi", "Da Nang" | |
| condition | No | Item condition: "new" (includes like_new items) or "used"; other values do not filter | |
| price_max | No | Highest price in VND | |
| price_min | No | Lowest price in VND | |
| subcategory | No | A subcategory slug of that category, from list_categories |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | About how many live listings match on the site | |
| capped | Yes | true when more listings match but this server only pages through the first 220: narrow the search instead | |
| listings | Yes | This page of results | |
| next_offset | Yes | Pass as `offset` for more results; null when there are no more, or when `capped` is true |