Vinted APIvinted.co.uk ↗
Access Vinted UK marketplace data via API. Search listings, fetch item details, compare prices, and batch-retrieve product info across categories.
What is the Vinted API?
The Vinted UK API provides 6 endpoints for querying second-hand product listings on vinted.co.uk, returning fields like price, brand, condition, category, and image URL. The search_listings endpoint supports full-text search with optional category filtering and returns up to 96 items per page. Batch endpoints allow fetching details or running keyword searches across up to 20 items or terms in a single call.
curl -X GET 'https://api.parse.bot/scraper/4134c107-4d58-43bb-bf6d-24a642f27b69/search_listings?page=1&category_id=1904&search_text=nike+shoes' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over Vinted UK product listings. Returns paginated results with item summaries including price, brand, condition, and image. Each page returns up to ~96 items. Filtering by category_id narrows results to a specific product category (use get_categories for valid IDs).
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| category_id | integer | Category ID to filter results. Accepted values include 1904 (Women), 5 (Men), 1194 (Electronics), 3054 (Cameras). 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 summary 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": 9134604641,
"url": "https://www.vinted.co.uk/items/9134604641-toddler-nike-dunks",
"brand": "Nike",
"title": "Toddler Nike dunks",
"currency": "GBP",
"condition": "Very good",
"image_url": "https://images1.vinted.net/t/06_01ca6_vh9GyTWd1NhaBW7CJe3g4sBE/f800/1781054211.webp?s=0875e4a0df1ababd48a89e2a19f079e03eac2da6",
"price_gbp": "15.13",
"like_count": 18
}
],
"total": 96
},
"status": "success"
}
}About the Vinted API
Search and Browse Listings
The search_listings endpoint accepts a search_text parameter and returns paginated arrays of listing summaries. Each item object includes id, title, brand, price_gbp, currency, url, image_url, condition, and like_count. Results can be narrowed using category_id — for example, 1904 for Women, 5 for Men, or 1194 for Electronics. Use get_categories (no inputs required) to retrieve the full list of valid top-level category IDs and names before constructing filtered queries.
Listing Detail and Price Intelligence
get_listing_detail takes a single item_id (obtainable from search results) and returns the complete listing record, adding description, color, availability, and a category path string to the summary fields. For quick price scanning without fetching full records, get_search_prices returns an array of price strings (e.g. '18.74 GBP') for the first 10 results of any keyword query — useful for fast market-rate checks.
Batch Operations
Two endpoints reduce round-trips for multi-item workflows. get_listing_details_batch accepts up to 20 listing IDs as a JSON array and returns the same field set as get_listing_detail for each, plus a failed array that reports any IDs that could not be fetched with a typed reason (invalid_id_format, not_found, or upstream_error). search_by_keyword_list accepts up to 20 search terms in one POST call and returns up to 10 newest-first results per keyword, with an empty_keywords array identifying terms that returned no matches.
The Vinted API is a managed, monitored endpoint for vinted.co.uk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when vinted.co.uk 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.co.uk 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 resale prices for specific brands or models by running repeated
get_search_pricesqueries over time. - Build a price comparison tool that batches up to 20 item IDs through
get_listing_details_batchto display side-by-side condition and price data. - Aggregate second-hand inventory across multiple product types using
search_by_keyword_listwith up to 20 keywords in a single call. - Filter Vinted UK listings by top-level category (e.g. Electronics, Men, Women) using
category_idfromget_categoriesto scopesearch_listingsresults. - Track like_count and condition fields from search results to identify high-demand or near-new listings before they sell.
- Enrich a product catalogue with second-hand market data by matching titles, brands, and prices from
get_listing_detailto existing SKUs.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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 `search_listings` provides?+
search_listings returns summary fields: id, title, brand, price_gbp, currency, url, image_url, condition, and like_count. get_listing_detail adds the item's description (full text), color, availability status, and a structured category path string — fields not present in the search summary objects.How does pagination work in `search_listings`, and what is the per-page limit?+
page parameter to step through results. Each page returns up to approximately 96 listing summary objects. The response includes a total field reflecting the count of items returned on that page, not the total number of matching listings across all pages.Does the API cover seller profile data such as ratings, follower counts, or seller location?+
Can I retrieve sold or inactive listings through the API?+
availability field on individual listings fetched via get_listing_detail or get_listing_details_batch, indicating whether an item is currently active. Historical sold listings and transaction history are not covered by the current endpoints. You can fork this API on Parse and revise it to add an endpoint targeting sold-item data if your use case requires it.