Vinted APIvinted.it ↗
Retrieve secondhand listings from Vinted.it. Access homepage items and keyword search results with item IDs, names, promotion status, and direct URLs.
What is the Vinted API?
The Vinted.it API covers 2 endpoints that return secondhand fashion and goods listings from the Italian Vinted marketplace. The get_ads endpoint surfaces items currently visible on the homepage, while search_items accepts a keyword query and returns up to 96 matching catalog items per call. Every item object includes a unique ID, name, promotion flag, and direct listing URL.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace vinted-it-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.vinted_it_api import Vinted, Item
vinted = Vinted()
# Browse homepage items
for item in vinted.items.list_homepage():
print(item.id, item.name, item.is_promoted, item.url)
# Search for specific items by keyword
for item in vinted.items.search(query="Nike"):
print(item.id, item.name, item.is_promoted, item.url)
Retrieve items currently listed on the Vinted.it homepage. Returns recently listed or featured items visible on the landing page. No pagination — returns a single page of the most recent items (typically 15-20).
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": "9136242821",
"url": "https://www.vinted.it/items/9136242821",
"name": "Fantastico jeans a gamba larga",
"is_promoted": false
},
{
"id": "9136228913",
"url": "https://www.vinted.it/items/9136228913",
"name": "Giacca NBA vintage",
"is_promoted": false
}
],
"total": 18
},
"status": "success"
}
}About the Vinted API
Endpoints and Response Shape
The get_ads endpoint takes no parameters and returns a snapshot of items currently featured on the Vinted.it landing page — typically 15 to 20 listings. Each entry in the ads array carries four fields: id (the item's unique identifier), name (the listing title as posted by the seller), is_promoted (a boolean indicating whether the item has paid promotion), and url (a direct link to the listing page on vinted.it). The total field gives the count of items in the response.
Searching the Catalog
The search_items endpoint accepts a required query string and returns up to 96 items from the first page of search results. Queries can be single words (scarpe, Nike) or multi-word phrases (vintage borsa, giacca invernale) in any language. The response shape mirrors get_ads: an items array of objects with id, name, is_promoted, and url, plus a total count.
Coverage and Limitations
Both endpoints reflect results from the Italian vinted.it domain only and cover only the first page of results — there is no offset or page parameter to retrieve deeper pages. The is_promoted flag lets you distinguish organically ranked listings from paid ones. Item-level detail fields such as price, condition, size, brand, or seller information are not part of the current response schema.
The Vinted API is a managed, monitored endpoint for vinted.it — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when vinted.it changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official vinted.it API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor which item categories or keywords appear most frequently on the Vinted.it homepage using
get_ads. - Build a resale price research tool by pulling listing names and URLs for a given category keyword via
search_items. - Detect promoted vs. organic listings to study how promotion affects search placement using the
is_promotedflag. - Aggregate trending secondhand items across Italian fashion keywords by querying
search_itemsrepeatedly. - Feed a deal-alert bot that checks whether specific items (by name match) have appeared in fresh homepage listings.
- Track listing volume for a brand or product category over time using the
totalfield fromsearch_items.
| 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 | 100 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 the `is_promoted` field tell me, and can I filter results to only promoted or only organic listings?+
get_ads and search_items includes an is_promoted boolean. It distinguishes paid promoted listings from organically ranked ones. The endpoints do not accept a filter parameter to return only one type — filtering must be done client-side on the is_promoted value in the response array.Can the API return more than the first page of search results?+
search_items returns up to 96 items from the first results page only. There is no page or offset parameter in the current API. You can fork this API on Parse and revise it to add pagination support.Does the API return item price, condition, size, or seller details?+
id, name, is_promoted, and url per item. Price, condition, size, brand, and seller fields are not exposed. You can fork this API on Parse and revise it to add an item-detail endpoint that returns those fields.