> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vinted Scraper Overview

> Scrape Vinted listings, user profiles, and catalog data across 26 European markets with structured JSON responses.

# 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

<CardGroup cols={3}>
  <Card title="26 Markets" icon="earth-europe">
    Access all Vinted markets including FR, DE, UK, IT, ES, PL, NL, BE, CZ, LT, and more.
  </Card>

  <Card title="Anti-Bot Bypass" icon="shield-halved">
    Automatic session management and fingerprint rotation to avoid blocks.
  </Card>

  <Card title="Fast Responses" icon="bolt">
    Median response time under 2 seconds for search and item detail requests.
  </Card>

  <Card title="Structured Data" icon="database">
    Clean JSON responses with prices, photos, sizes, brands, conditions, and seller info.
  </Card>

  <Card title="Country Proxies" icon="globe">
    Requests are routed through proxies matching the target market for accurate results.
  </Card>

  <Card title="SDK Support" icon="code">
    First-class support via the ScrapeBadger Node.js and Python SDKs.
  </Card>
</CardGroup>

## Supported Markets

Vinted operates across 26 country domains. Use the `market` query parameter to target a specific one.

| Market                 | Domain       | Market           | Domain        |
| ---------------------- | ------------ | ---------------- | ------------- |
| :fr: `fr`              | vinted.fr    | :de: `de`        | vinted.de     |
| :gb: `uk`              | vinted.co.uk | :it: `it`        | vinted.it     |
| :es: `es`              | vinted.es    | :pl: `pl`        | vinted.pl     |
| :nl: `nl`              | vinted.nl    | :be: `be`        | vinted.be     |
| :czech\_republic: `cz` | vinted.cz    | :lithuania: `lt` | vinted.lt     |
| :portugal: `pt`        | vinted.pt    | :at: `at`        | vinted.at     |
| :luxembourg: `lu`      | vinted.lu    | :sk: `sk`        | vinted.sk     |
| :denmark: `dk`         | vinted.dk    | :finland: `fi`   | vinted.fi     |
| :sweden: `se`          | vinted.se    | :romania: `ro`   | vinted.ro     |
| :hungary: `hu`         | vinted.hu    | :croatia: `hr`   | vinted.hr     |
| :greece: `gr`          | vinted.gr    | :us: `us`        | vinted.com    |
| :canada: `ca`          | vinted.ca    | :australia: `au` | vinted.com.au |
| :latvia: `lv`          | vinted.lv    | :estonia: `ee`   | vinted.ee     |

<Tip>
  If no `market` is specified, it defaults to `fr`. Use the [`/v1/vinted/markets`](/api-reference/endpoint/vinted/list-markets) endpoint to get the full list programmatically.
</Tip>

## 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`](/api-reference/endpoint/vinted/search-items) accepts an optional `seller_country` parameter:

```bash theme={null}
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.

<Note>
  `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.
</Note>

<Warning>
  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.
</Warning>

<Note>
  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.
</Note>

## Quick Start

<CodeGroup>
  ```javascript Node.js theme={null}
  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);
  ```

  ```python Python theme={null}
  from scrapebadger import ScrapeBadger

  client = ScrapeBadger(api_key="YOUR_API_KEY")

  results = client.vinted.search(
      query="nike air force 1",
      market="fr",
      per_page=20,
  )

  print(results.items)
  ```

  ```bash cURL theme={null}
  curl "https://scrapebadger.com/v1/vinted/search?query=nike+air+force+1&market=fr&per_page=20" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

## Endpoints

| Endpoint                                                                            | Method | Description                                  |
| ----------------------------------------------------------------------------------- | ------ | -------------------------------------------- |
| [`/v1/vinted/search`](/api-reference/endpoint/vinted/search-items)                  | GET    | Search Vinted catalog items with filters     |
| [`/v1/vinted/items/{item_id}`](/api-reference/endpoint/vinted/get-item-detail)      | GET    | Get detailed information about a single item |
| [`/v1/vinted/users/{user_id}`](/api-reference/endpoint/vinted/get-user-profile)     | GET    | Get a user's profile information             |
| [`/v1/vinted/users/{user_id}/items`](/api-reference/endpoint/vinted/get-user-items) | GET    | List items from a specific user              |
| [`/v1/vinted/brands`](/api-reference/endpoint/vinted/search-brands)                 | GET    | Search for brand IDs by name                 |
| [`/v1/vinted/colors`](/api-reference/endpoint/vinted/list-colors)                   | GET    | List all available color filters             |
| [`/v1/vinted/statuses`](/api-reference/endpoint/vinted/list-statuses)               | GET    | List item condition statuses                 |
| [`/v1/vinted/markets`](/api-reference/endpoint/vinted/list-markets)                 | GET    | List all supported Vinted markets            |

## Credit Costs

| Endpoint         | Cost      |
| ---------------- | --------- |
| Search items     | 1 credit  |
| Get item detail  | 1 credit  |
| Get user profile | 1 credit  |
| Get user items   | 1 credit  |
| Search brands    | 1 credit  |
| List colors      | 1 credit  |
| List statuses    | 1 credit  |
| List markets     | 1 credit  |
| Failed requests  | 0 credits |

## Next Steps

<CardGroup cols={2}>
  <Card title="Search Items" icon="magnifying-glass" href="/api-reference/endpoint/vinted/search-items">
    Full API reference for searching the Vinted catalog
  </Card>

  <Card title="Get Item Details" icon="shirt" href="/api-reference/endpoint/vinted/get-item-detail">
    Retrieve full details for a specific listing
  </Card>
</CardGroup>