Skip to main content

​
Vinted Scraper API

Search listings, fetch item details, and retrieve user profiles from Vinted — the largest European second-hand marketplace. The API handles authentication, anti-bot bypass, and market routing automatically.

​
Key Features

26 Markets

Access all Vinted markets including FR, DE, UK, IT, ES, PL, NL, BE, CZ, LT, and more.

Anti-Bot Bypass

Automatic session management and fingerprint rotation to avoid blocks.

Fast Responses

Median response time under 2 seconds for search and item detail requests.

Structured Data

Clean JSON responses with prices, photos, sizes, brands, conditions, and seller info.

Country Proxies

Requests are routed through proxies matching the target market for accurate results.

SDK Support

First-class support via the ScrapeBadger Node.js and Python SDKs.

​
Supported Markets

Vinted operates across 26 country domains. Use the market query parameter to target a specific one.
MarketDomainMarketDomain
:fr: frvinted.fr:de: devinted.de
:gb: ukvinted.co.uk:it: itvinted.it
:es: esvinted.es:pl: plvinted.pl
:nl: nlvinted.nl:be: bevinted.be
:czech_republic: czvinted.cz:lithuania: ltvinted.lt
:portugal: ptvinted.pt:at: atvinted.at
:luxembourg: luvinted.lu:sk: skvinted.sk
:denmark: dkvinted.dk:finland: fivinted.fi
:sweden: sevinted.se:romania: rovinted.ro
:hungary: huvinted.hu:croatia: hrvinted.hr
:greece: grvinted.gr:us: usvinted.com
:canada: cavinted.ca:australia: auvinted.com.au
:latvia: lvvinted.lv:estonia: eevinted.ee
If no market is specified, it defaults to fr. Use the /v1/vinted/markets endpoint to get the full list programmatically.

​
Filtering by seller country (cross-border listings)

Vinted markets federate listings across borders. A search on vinted.fr does not only return items from French sellers — it surfaces items from sellers physically located in IT, DE, NL, ES, and elsewhere. Vinted localizes the rendering (EUR prices, French labels), but the seller may be abroad. Vinted exposes no native country facet — its catalog filters cover only size, brand, status, color, price, and material, and the undocumented country_ids parameter is ignored. To solve this, /v1/vinted/search accepts an optional seller_country parameter: 
curl "https://scrapebadger.com/v1/vinted/search?query=nike+air+force+1&market=fr&seller_country=fr,be" \
  -H "x-api-key: YOUR_API_KEY"
  • Value: comma-separated ISO 3166-1 alpha-2 codes, case-insensitive (e.g. fr or fr,be).
  • Behavior: ScrapeBadger resolves each result item’s seller country and drops items whose seller isn’t in the requested set.
  • Response additions: each item gains a seller_country_code field (ISO-2 string or null), and the response gains a top-level seller_country echoing the normalized filter.
market and seller_country are different axes. market chooses which Vinted domain (catalog + currency) you search; seller_country filters on where the seller physically is. market=fr&seller_country=it searches the French catalog but returns only items shipped from Italy.
Pagination (total_entries / total_pages) still reflects Vinted’s unfiltered totals, so a filtered page may return fewer than per_page items. Keep requesting pages until you have collected enough matching items.
Filtering adds 1 credit per uncached seller looked up, on top of the 1 base credit. Seller countries are cached for 7 days, so cache hits are free — a fresh page of 20 distinct sellers costs ≈ 21 credits, while repeated or overlapping searches are far cheaper. Omitting seller_country keeps the search at 1 credit.

​
Quick Start

import ScrapeBadger from "scrapebadger";

const client = new ScrapeBadger({ apiKey: "YOUR_API_KEY" });

const results = await client.vinted.search({
  query: "nike air force 1",
  market: "fr",
  per_page: 20,
});

console.log(results.items);

​
Endpoints

EndpointMethodDescription
/v1/vinted/searchGETSearch Vinted catalog items with filters
/v1/vinted/items/{item_id}GETGet detailed information about a single item
/v1/vinted/users/{user_id}GETGet a user’s profile information
/v1/vinted/users/{user_id}/itemsGETList items from a specific user
/v1/vinted/brandsGETSearch for brand IDs by name
/v1/vinted/colorsGETList all available color filters
/v1/vinted/statusesGETList item condition statuses
/v1/vinted/marketsGETList all supported Vinted markets

​
Credit Costs

EndpointCost
Search items1 credit
Get item detail1 credit
Get user profile1 credit
Get user items1 credit
Search brands1 credit
List colors1 credit
List statuses1 credit
List markets1 credit
Failed requests0 credits

​
Next Steps

Search Items

Full API reference for searching the Vinted catalog

Get Item Details

Retrieve full details for a specific listing