vinted.fr APIwww.vinted.fr ↗
Search Vinted.fr product listings via API. Filter by price, sort by relevance or newest, and retrieve item details, seller info, photos, and pagination.
curl -X GET 'https://api.parse.bot/scraper/36af9f94-6ab8-4b56-bd31-20dd8a02f0eb/search_items?page=2&query=jacket&per_page=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for product listings on Vinted with optional price filters and sorting. Returns items with prices, URLs, seller info, and photos. Results are paginated.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| order | string | Sort order. Accepted values: relevance, price_low_to_high, price_high_to_low, newest_first |
| query | string | Search keyword |
| per_page | integer | Number of results per page (max 96) |
| price_to | number | Maximum price filter in EUR |
| price_from | number | Minimum price filter in EUR |
{
"type": "object",
"fields": {
"items": "array of product objects with id, title, price, currency, total_price, service_fee, brand, size, url, photo_url, favourite_count, view_count, status, is_promoted, and seller info",
"pagination": "object with current_page, total_pages, total_entries, per_page"
},
"sample": {
"data": {
"items": [
{
"id": 8917855111,
"url": "https://www.vinted.fr/items/8917855111-iphone-6s-plus-128-go",
"size": "",
"brand": "Apple",
"price": "40.0",
"title": "iPhone 6S Plus / 128 Go",
"seller": {
"id": 3154418477,
"login": "Jane Doe",
"profile_url": "https://www.vinted.fr/member/3154418477-nirma269"
},
"status": "Neuf sans étiquette",
"currency": "EUR",
"photo_url": "https://images1.vinted.net/t/06_00f40_RpQqxork8bRandwQSW4r6tcf/f800/1778842520.webp?s=d7ce7966c8ae2533d93087a50e453ecf2db0b660",
"view_count": 0,
"is_promoted": false,
"service_fee": "2.7",
"total_price": "42.7",
"favourite_count": 0
}
],
"pagination": {
"per_page": 5,
"total_pages": 192,
"current_page": 1,
"total_entries": 960
}
},
"status": "success"
}
}About the vinted.fr API
The Vinted.fr API exposes one endpoint, search_items, that returns up to 96 secondhand product listings per page from the Vinted.fr marketplace. Each response includes 11 item-level fields — title, price, currency, service_fee, brand, size, photo_url, seller info, and more — alongside a pagination object covering total pages and total entries. Filters for minimum and maximum price in EUR, keyword search, and four sort orders give precise control over results.
What the API Returns
The search_items endpoint returns an array of product objects from Vinted.fr, each carrying the listing's id, title, price, total_price, currency, service_fee, brand, size, url, photo_url, and favourite_count. The total_price field reflects the buyer-facing amount including fees, while service_fee isolates the platform charge — useful when building price-comparison or arbitrage tooling. A pagination object accompanies every response with current_page, total_pages, total_entries, and per_page.
Filtering and Sorting
The query parameter accepts free-text keywords matching Vinted's catalogue. Price range filtering is available through price_from and price_to, both denominated in EUR. The order parameter supports four sort modes: relevance, price_low_to_high, price_high_to_low, and newest_first. Pagination is controlled with page and per_page (maximum 96 results per page). All parameters are optional, so an empty request returns default trending listings.
Coverage and Scope
This API covers the French Vinted domain (vinted.fr) and returns prices in EUR. Listing data is read-only; the API retrieves catalogue items but does not cover seller profiles, transaction history, messaging, or user account data. The photo_url field surfaces the primary listing image, but multi-image galleries are not currently exposed through this endpoint.
- Monitor secondhand price trends for specific brands or product categories using
price_from,price_to, andquery. - Build a deal-alert tool that polls
newest_firstorder for a given keyword and flags new listings below a target price. - Aggregate Vinted.fr listings into a cross-platform secondhand marketplace comparison dashboard.
- Track how many listings exist for a particular brand by reading
total_entriesfrom the pagination object. - Populate a price estimation tool for resellers using
priceandtotal_pricefield distributions across search results. - Identify popular items by sorting on
favourite_countvalues returned across paginated result sets. - Feed a fashion analytics pipeline with
brandandsizefields to map supply distribution across categories.
| 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 the `search_items` endpoint return beyond the listing price?+
price (the listed amount), total_price (buyer-facing total with fees), service_fee, brand, size, photo_url, favourite_count, and a direct url to the listing on vinted.fr. The pagination object tells you total_entries and total_pages for the query.Can I retrieve listings from other Vinted country domains like vinted.de or vinted.co.uk?+
Are seller profiles or transaction history available through this API?+
What is the maximum number of results I can retrieve per request?+
per_page parameter accepts a maximum value of 96. To retrieve more results, increment the page parameter and use total_pages from the pagination object to determine when you have reached the last page of results.