vinted.it APIvinted.it ↗
Access Vinted.it secondhand listings via API. Retrieve homepage items and search results with item IDs, names, promotion status, and direct URLs.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e71bdd90-2192-497d-9fdc-eb595d3b28f3/get_ads' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve items currently listed on the Vinted.it homepage. Returns recently listed or featured items visible on the landing page.
No input parameters required.
{
"type": "object",
"fields": {
"ads": "array of item objects with id, name, is_promoted, and url",
"total": "integer count of items returned"
},
"sample": {
"data": {
"ads": [
{
"id": "8846398964",
"url": "https://www.vinted.it/items/8846398964",
"name": "Abito Fluido Nero con Balze e Volant – Flower by Charm`s Paris",
"is_promoted": false
},
{
"id": "8846395602",
"url": "https://www.vinted.it/items/8846395602",
"name": "Borsa bauletto braccialini",
"is_promoted": false
}
],
"total": 17
},
"status": "success"
}
}About the vinted.it API
The Vinted.it API exposes 2 endpoints that return structured listing data from Italy's Vinted marketplace. The get_ads endpoint surfaces items currently visible on the homepage, while search_items lets you query the catalog by keyword and receive matching listings — each response includes item id, name, is_promoted, url, and a total count of results.
Endpoints
The API has two endpoints. get_ads takes no parameters and returns an ads array of items currently featured on the Vinted.it landing page, along with a total integer. Each item object includes id, name, is_promoted (boolean indicating promoted status), and url (direct link to the listing). This is useful for tracking which items are actively being surfaced to visitors without a search query.
Search
The search_items endpoint accepts a required query string and returns an items array with the same four fields: id, name, is_promoted, and url. The query parameter accepts single words like scarpe or multi-word Italian-language phrases like vintage borsa, as well as brand names like Nike. The total field in the response tells you how many matching items were returned for that query.
Data Scope and Fields
Both endpoints return the same item object shape. The is_promoted flag distinguishes organically listed items from paid or boosted ones, which is useful for competitive research or filtering. The url field points directly to the Vinted.it item page. Neither endpoint exposes pricing, seller information, item condition, photos, or category metadata — only the four core identification and promotion fields are returned.
- Monitor which items are currently promoted on the Vinted.it homepage using
is_promotedfromget_ads - Build a keyword-based alert system that tracks new listings matching a brand or product type via
search_items - Compare search result counts (
total) across different queries to gauge category demand on Vinted Italy - Aggregate item URLs for a price comparison tool that visits individual listing pages for further detail
- Detect trending secondhand categories by running periodic keyword searches and comparing result volumes
- Filter promoted vs. organic listings in homepage results to analyze paid visibility on the platform
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Vinted have an official public developer API?+
What does `is_promoted` mean in the response?+
is_promoted boolean field indicates whether a listing has been boosted or featured, as opposed to appearing organically. Both get_ads and search_items include this field on every item object, so you can filter promoted items from organic ones in your own application logic.Does the API return item prices, seller details, or photos?+
id, name, is_promoted, and url only. Pricing, seller profiles, condition grades, and image URLs are not part of the response. You can fork this API on Parse and revise it to add an endpoint that retrieves those fields from individual listing pages.Does `search_items` support pagination or filtering by category?+
search_items endpoint accepts only a query string and returns a single batch of results with a total count. Pagination parameters and category or size filters are not exposed. You can fork this API on Parse and revise it to add offset-based pagination or category filter parameters.