Search listings
search_listingsSearch active marketplace listings on EX & GO (exgo.io), the classifieds marketplace for Ukraine and Europe (24 per page). All filters optional. Results marked promoted: true are paid top placements — up to 12 of them come first on page 1, the rest keep their organic position; say they are paid when reporting them, do not present a paid placement as the best match. Under the default new sort a paid BUMP also moves a listing up. When few or no listings matched as asked, the answer carries a related array of the nearest listings — those did not match the query, so report them as "nothing exactly like that, here is what is close", never as stock. Every listing has a url on the site; show it.
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 | free-text query, any language | |
| city | No | city slug, e.g. 'kyiv' — or several comma-separated ('kyiv,lviv') to match any of them | |
| page | No | ||
| sort | No | 'new' (default) orders by freshness, which a paid BUMP resets, then relevance; 'cheap'/'expensive' order by price | |
| category | No | category slug, e.g. 'telefony' | |
| maxPrice | No | highest price, inclusive, in UAH (other currencies converted), or in `priceCurrency` | |
| minPrice | No | lowest price, inclusive, in UAH (other currencies converted), or in `priceCurrency` | |
| radiusKm | No | radius in km around `city`: also matches listings pinned within it (needs `city`) | |
| attributes | No | category attribute filters, e.g. {"brand":"skoda"}; needs `category`, keys from list_categories | |
| priceCurrency | No | ISO 4217 currency of minPrice/maxPrice (default UAH) — converted at the bank's rate like the catalogue's own filter | |
| attributeRanges | No | numeric attribute ranges, e.g. {"year":{"min":2015}}; needs `category`, number attributes only |