wallapop_search
Search public Wallapop listings by query and coordinates, with filters for category, price, condition, distance, shipping, and sort order; returns paginated listing cards with item URLs.
Instructions
Search Wallapop public listings. Returns one page of public Wallapop listing cards with title, price, currency, images, coarse location, taxonomy, shipping state, and a public item URL. q is a free-text search. latitude and longitude are required caller-provided coordinates because Wallapop otherwise infers location from the server's network location. category_id accepts any ID returned by /wallapop/categories, including descendants. sort is one of closest, most_relevance, newest, price_low_to_high, or price_high_to_low. When category_id is supplied, discover condition values from /wallapop/filters; categories can add values beyond the base set. Use /wallapop/filter-options for remote filter values. Pass next_cursor back as cursor by itself to fetch the next page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>",
"latitude": "<latitude>",
"longitude": "<longitude>"
},
"name": "wallapop_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Free-text listing search, 2 to 200 characters | |
| sort | No | Wallapop sort order | |
| cursor | No | Opaque next_cursor returned by a previous response. Use it alone, without initial search parameters. | |
| filter | No | Repeatable category-specific key:value pair discovered from /wallapop/filters, e.g. brand:BMW, color:Black, has_warranty:true, storage_capacity:128gb, item_language:english, or fashion_size:3,4. For remote values use IDs returned by /wallapop/filter-options. | |
| latitude | Yes | Caller-provided search latitude, -90 through 90 | |
| condition | No | Repeatable or comma-separated condition values. With category_id, use the current values from /wallapop/filters; without category_id, base values are new, as_good_as_new, good, fair, and has_given_it_all. | |
| longitude | Yes | Caller-provided search longitude, -180 through 180 | |
| max_price | No | Maximum sale price | |
| min_price | No | Minimum sale price | |
| category_id | No | Any live search taxonomy ID from /wallapop/categories | |
| time_filter | No | Listing date window | |
| is_shippable | No | Pass true to limit to shipping-capable listings; omit to include all. false is rejected because Wallapop ignores it. | |
| distance_in_km | No | Maximum distance from the supplied coordinates, 0 through 1000 km |