vinted.co.uk APIvinted.co.uk ↗
Access Vinted UK marketplace data via API. Search listings, get item details, compare prices, and browse categories across second-hand fashion and more.
curl -X GET 'https://api.parse.bot/scraper/4134c107-4d58-43bb-bf6d-24a642f27b69/search_listings?search_text=nike+shoes' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for product listings on Vinted UK by keyword and optional filters. Returns paginated results with item details including price, brand, condition, and image.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| category_id | integer | Category ID to filter results. Use get_categories to retrieve valid IDs. |
| search_textrequired | string | Search keyword (e.g. 'nike shoes', 'levi jeans'). |
{
"type": "object",
"fields": {
"page": "integer current page number",
"items": "array of listing objects with id, title, brand, price_gbp, currency, url, image_url, condition, like_count",
"total": "integer total number of items returned on this page"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"id": 8789338033,
"url": "https://www.vinted.co.uk/items/8789338033-fujifilm-colour-35mm-film",
"brand": "FUJIFILM",
"title": "Fujifilm Colour 35mm Film",
"currency": "GBP",
"condition": "New with tags",
"image_url": "https://images1.vinted.net/t/04_00be5_pvVQqFfa7Y17MbcqnMB2i4dc/f800/1777576841.webp",
"price_gbp": "8.0",
"like_count": 15
}
],
"total": 20
},
"status": "success"
}
}About the vinted.co.uk API
The Vinted UK API provides 5 endpoints for querying live second-hand marketplace listings on vinted.co.uk. Use search_listings to query items by keyword and filter by category, returning fields like price_gbp, condition, brand, and image_url. You can also retrieve individual listing details, pull a fast price summary for any search term, and run batch searches across multiple keywords in a single request.
Search and Filter Listings
search_listings accepts a required search_text parameter plus optional category_id and page inputs. Results come back as an array of item objects including id, title, brand, price_gbp, currency, url, image_url, condition, and like_count, along with a total count for the current page. Use get_categories first to retrieve valid category_id values — it returns an array of objects with integer id and name, covering Vinted's main taxonomy.
Listing Detail and Price Intelligence
get_listing_detail takes a numeric item_id (obtainable from search_listings results) and returns a fuller record: title, description, brand, color, price, currency, condition, category (as a path string), url, and image_url. For quick market scans, get_search_prices accepts a single search_text keyword and returns an array of price strings in 'amount currency' format (e.g. '18.74 GBP') covering the first 10 matching results — useful for fast competitive benchmarking without fetching full listing objects.
Batch Keyword Search
search_by_keyword_list accepts a JSON-encoded array of search terms via the keywords parameter. It returns a results object keyed by each keyword, with each value being an array of matching items containing id, title, brand, price_gbp, and url. This avoids making separate calls when monitoring multiple search terms simultaneously.
Coverage Notes
All endpoints target the Vinted UK storefront (vinted.co.uk) and prices are denominated in GBP. Pagination is supported on search_listings via the page parameter. Seller profile data, buyer/seller messaging, and transaction history are not part of the current endpoint set.
- Track resale prices for specific brands (e.g. Nike, Levi's) using
get_search_pricesto monitorprice_gbptrends over time - Build a price comparison tool that queries multiple clothing keywords in one call via
search_by_keyword_list - Aggregate second-hand inventory data by category using
get_categoriesIDs withsearch_listingsfilters - Enrich a listing database by fetching
color,condition, andcategorypath fromget_listing_detailusing IDs from search results - Monitor
like_counton search result items to identify high-demand second-hand products - Feed a deal-alert system by polling
search_listingsfor a keyword and flagging items below a targetprice_gbp - Catalogue available Vinted UK category taxonomy for mapping to an internal product classification system
| 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 `get_listing_detail` return beyond what appears in search results?+
search_listings returns a concise item object with fields like title, brand, price_gbp, condition, and image_url. get_listing_detail adds color, a full category path string, and the raw price number (separate from the GBP-labelled field), giving you the structured record for a single item in one call.Does the API cover Vinted marketplaces outside the UK, such as vinted.fr or vinted.de?+
How does pagination work in `search_listings`, and are there limits on how many items are returned?+
page parameter on search_listings is an optional integer that steps through result pages. The total field in each response reflects the count of items returned on that page, not the overall catalogue count. There is no per_page parameter exposed, so page size is determined by Vinted's default result set.