search_items
Search Vinted second-hand listings with rich filters across 19 country sites. Returns a paginated list of items — each with title, price, currency, brand, size, condition, photo URL, item URL, favourite count, and seller info.
Instructions
Search Vinted second-hand listings with rich filters across 19 country sites. Returns a paginated list of items — each with title, price, currency, brand, size, condition, photo URL, item URL, favourite count, and seller info. Use get_categories to discover valid categoryId values and search_brands to resolve brand names to IDs. For comprehensive multi-page results use search_all_items instead.
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": {
"query": "<query>"
},
"name": "search_items"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number starting at 1 | |
| size | No | Size labels to filter by, e.g. ["M", "L"] or ["42", "43"]. Automatically resolved to IDs via resolve_size_ids. Use instead of sizeIds when you know the label but not the ID. | |
| brand | No | Brand names to filter by, e.g. ["Nike", "Adidas"]. Automatically resolved to IDs via search_brands. | |
| color | No | Color names to filter by, e.g. ["black", "white"]. Automatically resolved to IDs via get_colors. | |
| query | Yes | Search keywords, e.g. "Nike Air Max 90" or "levi 501 jeans" | |
| sortBy | No | Sort order for results. Defaults to relevance. | |
| country | No | Vinted country site to search (fr, de, uk, it, es, nl, pl, pt, be, at, lt, cz, sk, hu, ro, hr, fi, dk, se) | fr |
| perPage | No | Results to return, 1–96. Defaults to 20. Vinted serves fixed pages of 96, so this only truncates a page; at most 960 results are reachable per query. | |
| sizeIds | No | Numeric size IDs. Prefer the size[] parameter for label-based lookup. | |
| brandIds | No | Numeric Vinted brand IDs from search_brands. Prefer the brand[] parameter for name-based lookup. | |
| colorIds | No | Numeric color IDs. Prefer the color[] parameter for name-based lookup. | |
| priceMax | No | Maximum price in the local currency of the selected country | |
| priceMin | No | Minimum price in the local currency of the selected country | |
| condition | No | Item condition filter; multiple values are OR-ed together | |
| categoryId | No | Category ID from get_categories (e.g. 4 = women's clothing, 5 = men's clothing, 1231 = women's shoes) |