Shopping
Vinted API
Search Vinted listings and discover categories, item attributes, price breakdowns, member profiles, wardrobes, feedback and brands.
Discover category IDs, search listings with filters, and retrieve item attributes, seller badges and pricing components. Read profiles, wardrobes, feedback and brands on your selected marketplace.
API availability: Available
http://localhost:3031Public API: https://api.scrapeatlas.com.Endpoints
/v1/vinted/searchSearch the Vinted catalog
Search listings by keyword, category, brand, condition, colour, size, material and price range, with display labels and pagination.
Reference/v1/vinted/itemGet a Vinted item
Read item photos, descriptions, category-specific attributes including book ISBN and language, seller badges, availability and separate item, buyer-protection and shipping prices.
Reference/v1/vinted/profileGet a Vinted member profile
Read a member profile with identity, activity and online status, item and follower counts, feedback reputation, bundle discounts and verification flags.
Reference/v1/vinted/user/itemsGet a member's wardrobe
Page through a member’s wardrobe with listing prices, photos, reserved and closed flags, processing status and bulky-item indicators.
Reference/v1/vinted/user/feedbacksGet a member's feedback
Page through the feedback a member received, from buyers and from the system, with ratings, authors and written replies.
Reference/v1/vinted/brandsSearch Vinted brands
Find brand ids by keyword, with follower and listing counts and luxury/authenticity flags, for use as brand_ids in search.
Reference/v1/vinted/categoriesGet Vinted categories
Discover marketplace category IDs, names, URLs, images and parent-child relationships for building category filters and searching listings.
ReferenceQuick start
Create an API key on your account page, then call the public API. Values below are placeholders.
curl "https://api.scrapeatlas.com/v1/vinted/search?query=nike+zoom&domain=fr" \
-H "x-api-key: YOUR_API_KEY"Coverage & limits
Coverage notes for this platform are not published yet.
| HTTP | failure.code | Meaning |
|---|---|---|
| 400 | invalid_request | Missing, duplicate, unsupported or invalid parameters, more than one selector, a domain that does not match the URL host, or a page beyond what the source accepts. |
| 401 | unauthorized | Missing or invalid service key. |
| 404 | not_found | Unknown item or member. |
| 429 | upstream_rate_limited | Vinted rate limited the request; no automatic retry. |
| 502 | upstream_challenged | DataDome/Cloudflare challenge, HTTP 401/403/503, or no anonymous token issued. |
| 502 | unsupported_page unsafe_redirect response_too_large request_limit upstream_error | Bounded retrieval failed, the page belongs to another item, or the response no longer matches the expected structure. |
| 503 | busy | All worker slots occupied. |
| 504 | timeout | Deadline exceeded. |
| 200 | partial | Coverage warnings such as pricing_missing, photos_missing or pagination_missing. |
