get_new_items
Fetch the most recently listed items for a search query (newest first). To monitor a search, call it repeatedly and pass the previous response's latestId as afterId — only items listed since then are returned (truncated: true means more…
Instructions
Fetch the most recently listed items for a search query (newest first). To monitor a search, call it repeatedly and pass the previous response's latestId as afterId — only items listed since then are returned (truncated: true means more than perPage arrived; raise perPage or poll more often). Supports the same filters as search_items (brand, category, size, color, price, condition).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Size labels, e.g. ["M"]; automatically resolved to IDs | |
| brand | No | Brand names; automatically resolved to IDs | |
| color | No | Color names, e.g. ["black"]; automatically resolved to IDs | |
| query | Yes | Search keywords to monitor, e.g. "Nike Air Max 90 size 42" | |
| afterId | No | Return only items with an ID greater than this (use latestId from the previous call). Omit on the first call. | |
| country | No | Vinted country site to monitor | fr |
| perPage | No | Number of newest items to inspect, 1–96 | |
| sizeIds | No | Size IDs to filter by | |
| brandIds | No | Numeric brand IDs from search_brands | |
| colorIds | No | Color IDs to filter by | |
| priceMax | No | Maximum price in local currency | |
| priceMin | No | Minimum price in local currency | |
| condition | No | Item condition filter | |
| categoryId | No | Category ID from get_categories |