Search listings
search_listingsRead-onlyIdempotent
Search second-hand listings on Marktplaats or 2dehands with filters for category, price, condition, recency, and distance from a postal code.
Instructions
Search second-hand listings on Marktplaats or 2dehands with filters for category, price range, condition, recency and distance from a postal code.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | No | Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium). | marktplaats |
| limit | No | Results per page (1-100). | |
| query | No | Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given. | |
| offset | No | Pagination offset: page_number * limit. | |
| compact | No | True (default) returns a token-efficient shortlist; False adds description, seller, images and attributes per listing. | |
| sort_by | No | 'relevance' (default), 'date' (newest first with desc), 'price' or 'location'. | relevance |
| category | No | Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories. | |
| postcode | No | Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering. | |
| price_to | No | Maximum price in euros. | |
| condition | No | Filter by item condition. | |
| price_from | No | Minimum price in euros. | |
| sort_order | No | 'asc' or 'desc'. | desc |
| distance_km | No | Max distance from postcode in kilometers. | |
| subcategory | No | Subcategory name (e.g. 'Fietsen | Racefietsen') or numeric id. | |
| include_sponsored | No | Include paid promotions (DAGTOPPER/TOPADVERTENTIE) and the sponsored top block. | |
| offered_since_days | No | Only listings placed within the last N days. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||