# Vinted Scraper – Listings, Prices & Sellers (26 Countries) (`liveclaude/vinted-scraper`) Actor

Scrape Vinted listings from all 26 countries with every filter or any Vinted URL. Goes past the 960-result limit, returns only new listings and price drops for alerts, adds details and seller profiles, compares prices between countries.

- **URL**: https://apify.com/liveclaude/vinted-scraper.md
- **Developed by:** [FlareWOW](https://apify.com/liveclaude) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Vinted Scraper by FlareWOW](https://api.apify.com/v2/key-value-stores/gVkZayJ9rfCH19ETB/records/cover.png)

## Vinted Scraper: all 26 countries, every filter, monitoring

**From $0.50 per 1,000 listings.** Scrape Vinted search results, brands, categories, single listings and seller wardrobes from **every Vinted marketplace** (EU, UK and US) with **all the filters you know from the website**. Goes past Vinted's 960-result limit, sends you only **new listings and price drops** on scheduled runs, and can **compare prices between countries**.

🌐 **Read in your language:** 🇩🇪 [Deutsch](#-deutsch) · 🇫🇷 [Français](#-français) · 🇮🇹 [Italiano](#-italiano) · 🇪🇸 [Español](#-español) · 🇵🇱 [Polski](#-polski) · 🇳🇱 [Nederlands](#-nederlands)

### ✨ Why this Vinted scraper

| | What you get |
|---|---|
| 🌍 Countries | **26 marketplaces** in one run: PL, FR, DE, IT, ES, NL, BE, AT, PT, LU, UK, IE, CZ, SK, HU, RO, LT, LV, EE, SE, FI, DK, HR, GR, SI, US |
| 🎯 Filters | **any Vinted URL with filters**, or brand, category, size, condition, colour, material, price and sort in the form |
| ♾️ More than 960 results | automatic price-range splitting **collects everything** |
| 🔔 Monitoring | **only new listings + price drops**, and **sold / removed** listings with days on market. You pay only for what's new |
| 📄 Listing details | description, all photos, category path, colour, material, shipping price, sold/reserved |
| 👤 Seller data | country, city, rating, reviews, items sold, followers, last seen, Vinted Pro, bundle discounts, whole wardrobe |
| 📊 Country price comparison | median / min / average per country in EUR, by marketplace or by the seller's real country |
| 🤖 Built for automation | typed output schema, works with the Apify API, MCP / AI agents, Make, Zapier, n8n, Google Sheets |
| 💰 Price | **from $0.50 / 1,000 listings**, proxies included |

### 🚀 How to use it

1. **Paste a Vinted link** (the easiest way). Set any filters on vinted.pl / vinted.fr / vinted.de… in your browser, copy the URL and paste it into **Vinted URLs**. All filters work, including ones Vinted adds in the future.
2. **Or type keywords** in **Search queries**, pick countries and set brand, size, condition, colour or price in the form.
3. Click **Start**. Download results as Excel, CSV, JSON or connect via API, Make, Zapier, n8n or Google Sheets.

**What you can paste:**

| Link | What you get |
|---|---|
| `https://www.vinted.pl/catalog?search_text=nike&brand_ids[]=53&price_to=200` | all listings for that search |
| `https://www.vinted.de/catalog/1242-sneakers` | a whole category |
| `https://www.vinted.co.uk/brand/53-nike` | a whole brand |
| `https://www.vinted.fr/items/1234567890-...` | one listing with full details |
| `https://www.vinted.it/member/123456-username` | seller profile + their whole wardrobe |

### 🔔 Monitoring: new listings, price drops, sold items

Turn on **Only new listings** and schedule the Actor (e.g. every 15 minutes). Each run returns **only listings you haven't seen yet**, plus **price drops** (with the previous price and drop %) and **sold / removed listings** (last price, first and last seen date, days on market - real sell-through data for resellers). Every record has `listingStatus`: `new`, `price-drop`, `sold` or `removed`. You only pay for what's new, so a monitor that finds 5 new items costs a fraction of a cent. Connect a webhook, Slack, email or Telegram integration and you have deal alerts.

### 🌍 Compare prices between countries

Search the same query in several countries and turn on **Compare prices between countries**. You get one summary row per query with min / median / average price per marketplace converted to EUR, plus the cheapest and most expensive country. Vinted shows many cross-border listings on every EU site, so for real arbitrage also turn on **Seller profiles**: the comparison is then grouped by **the country where sellers actually are**.

![Country price comparison](https://api.apify.com/v2/key-value-stores/gVkZayJ9rfCH19ETB/records/screen-compare.png)

### 📦 Output example

![Results table](https://api.apify.com/v2/key-value-stores/gVkZayJ9rfCH19ETB/records/screen-results.png)

```json
{
  "id": 10393133322,
  "url": "https://www.vinted.fr/items/10393133322-zara-strickjacke",
  "title": "Zara Strickjacke",
  "price": 28,
  "currency": "EUR",
  "totalPrice": 30.1,
  "buyerProtectionFee": 2.1,
  "priceEur": 28,
  "brand": "Zara",
  "size": "L",
  "condition": "Neuf sans étiquette",
  "favouriteCount": 0,
  "photoUrls": ["https://images1.vinted.net/..."],
  "description": "Die Strickjacke wurde paar mal getragen...",
  "categoryPath": ["Femmes", "Vêtements", "Sweats et sweats à capuche", "Cardigans"],
  "color": "Gris",
  "material": "Polyester, Laine",
  "shippingPrice": 5.5,
  "isReserved": false,
  "isSold": false,
  "sellerCountry": "DE",
  "sellerRating": 3,
  "sellerReviewCount": 5,
  "sellerItemsSold": 2,
  "country": "fr",
  "marketplace": "vinted.fr",
  "scrapedAt": "2026-10-15T21:08:40.000Z"
}
```

Ready-made table views: **Listings**, **Listings with details**, **Sellers**, **New listings & price drops**, **Country price comparison**.

### 💰 Pricing

You pay only for results. Proxies are included. The price depends on your Apify plan:

| Event | Free | Starter | Scale | Business |
|---|---|---|---|---|
| Listing | $2.00 / 1k | $1.20 / 1k | $0.80 / 1k | **$0.50 / 1k** |
| ➕ Listing details (optional) | $2.00 / 1k | $1.50 / 1k | $1.00 / 1k | $0.80 / 1k |
| ➕ Seller profile (optional, once per seller) | $1.50 / 1k | $1.00 / 1k | $0.80 / 1k | $0.60 / 1k |
| Country comparison row | $0.01 | $0.01 | $0.01 | $0.01 |

Listings filtered out by your keyword or seller filters, already seen listings in monitoring mode and failed pages are **free**. Set a maximum cost per run in the run options and the Actor stops exactly there.

### 🛠️ Input reference

| Field | Description |
|---|---|
| Search queries | keywords, one per line; each runs in every selected country |
| Vinted URLs | any search, category, brand, listing or seller link from any Vinted country |
| Countries / All 26 countries | which marketplaces to search |
| Max listings per search | `0` = everything (goes past 960) |
| Categories, Brands, Sizes | names as shown on Vinted or IDs; sizes work best together with a category |
| Condition, Colours, Material IDs, Min/Max price, Sort by | the same filters as on the website |
| Exclude words / Title must contain | filter titles (excluded listings are free) |
| Seller type / Seller countries / Min favourites | private vs Vinted Pro, sellers located in given countries, demand signal |
| Listing details / Seller profiles | optional enrichment |
| Only new listings / Price drops / Monitor name | monitoring mode |

### ❓ FAQ

**Does it need my Vinted account or cookies?** No. It only reads public pages, like a visitor.

**Why does vinted.fr show sellers from Germany or Spain?** Vinted shows cross-border listings on all EU sites. Use **Seller countries** to keep only local sellers.

**Can I get more than 960 results?** Yes, set *Max listings per search* to `0` or any number. The Actor splits the search into price ranges automatically.

**Is it legal?** The Actor collects publicly available data. You are responsible for using it in line with Vinted's terms and data protection law (GDPR); avoid storing personal data you don't need.

**Something is missing?** Open an issue in the **Issues** tab.

***

### Integrations & API

- **API**: start the Actor and fetch results via the [Apify API](https://docs.apify.com/api/v2) – clients for Python and JavaScript, or plain HTTP.
- **No-code**: connect results to **Make, Zapier, n8n, Google Sheets, Slack, Airbyte** or any webhook.
- **AI agents**: call `liveclaude/vinted-scraper` from Claude, ChatGPT or Cursor through the [Apify MCP server](https://mcp.apify.com).

### 🇩🇪 Deutsch

**Vinted Scraper** liest Anzeigen aus **allen 26 Vinted-Ländern** (Deutschland, Österreich, Frankreich, Italien, Spanien, Polen, UK, USA…) **ab $0.50 pro 1.000 Anzeigen**, Proxys inklusive.

- **Beliebigen Vinted-Link einfügen** (mit allen Filtern von der Website) oder Suchbegriffe mit Marke, Kategorie, Größe, Zustand, Farbe, Material und Preis eingeben.
- **Mehr als 960 Ergebnisse**: die Suche wird automatisch in Preisbereiche aufgeteilt.
- **Monitoring**: bei geplanten Läufen nur **neue Anzeigen, Preissenkungen und verkaufte Artikel** (mit Tagen bis zum Verkauf). Bezahlt wird nur Neues.
- **Anzeigendetails** (Beschreibung, alle Fotos, Kategorie, Versandkosten) und **Verkäuferprofile** (Land, Bewertung, verkaufte Artikel, ganzer Kleiderschrank).
- **Preisvergleich zwischen Ländern** in EUR.

**Start:** Filter auf vinted.de setzen, Link kopieren, in **Vinted URLs** einfügen, **Start** klicken. Export als Excel, CSV, JSON oder per API, Make, Zapier, n8n.

### 🇫🇷 Français

**Vinted Scraper** récupère les annonces des **26 pays Vinted** (France, Belgique, Luxembourg, Italie, Espagne, Allemagne, Pologne, UK, USA…) **dès $0.50 pour 1 000 annonces**, proxys inclus.

- **Collez n'importe quel lien Vinted** avec vos filtres, ou saisissez des mots-clés avec marque, catégorie, taille, état, couleur, matière et prix.
- **Plus de 960 résultats** : la recherche est découpée automatiquement par tranches de prix.
- **Surveillance** : à chaque exécution planifiée, uniquement les **nouvelles annonces, baisses de prix et articles vendus** (avec le nombre de jours en vente). Vous ne payez que la nouveauté.
- **Détails de l'annonce** (description, toutes les photos, catégorie, frais de port) et **profils vendeurs** (pays, note, articles vendus, dressing complet).
- **Comparaison des prix entre pays** en EUR.

**Démarrer :** réglez vos filtres sur vinted.fr, copiez le lien, collez-le dans **Vinted URLs** et cliquez sur **Start**. Export Excel, CSV, JSON ou via API, Make, Zapier, n8n.

### 🇮🇹 Italiano

**Vinted Scraper** estrae gli annunci da **tutti i 26 paesi Vinted** (Italia, Francia, Spagna, Germania, Polonia, UK, USA…) **da $0.50 ogni 1.000 annunci**, proxy inclusi.

- **Incolla qualsiasi link Vinted** con i tuoi filtri, oppure cerca per parole chiave con marca, categoria, taglia, condizioni, colore, materiale e prezzo.
- **Oltre i 960 risultati**: la ricerca viene divisa automaticamente in fasce di prezzo.
- **Monitoraggio**: a ogni esecuzione programmata solo **nuovi annunci, ribassi di prezzo e articoli venduti** (con giorni in vendita). Paghi solo le novità.
- **Dettagli dell'annuncio** (descrizione, tutte le foto, categoria, spedizione) e **profili venditore** (paese, valutazione, articoli venduti, armadio completo).
- **Confronto prezzi tra paesi** in EUR.

**Inizia:** imposta i filtri su vinted.it, copia il link, incollalo in **Vinted URLs** e premi **Start**. Esporta in Excel, CSV, JSON o tramite API, Make, Zapier, n8n.

### 🇪🇸 Español

**Vinted Scraper** extrae anuncios de **los 26 países de Vinted** (España, Portugal, Francia, Italia, Alemania, Polonia, UK, EE. UU.…) **desde $0.50 por cada 1.000 anuncios**, proxies incluidos.

- **Pega cualquier enlace de Vinted** con tus filtros, o busca por palabras clave con marca, categoría, talla, estado, color, material y precio.
- **Más de 960 resultados**: la búsqueda se divide automáticamente por rangos de precio.
- **Monitorización**: en cada ejecución programada solo **anuncios nuevos, bajadas de precio y artículos vendidos** (con días en venta). Solo pagas lo nuevo.
- **Detalles del anuncio** (descripción, todas las fotos, categoría, envío) y **perfiles de vendedor** (país, valoración, artículos vendidos, armario completo).
- **Comparación de precios entre países** en EUR.

**Empieza:** pon tus filtros en vinted.es, copia el enlace, pégalo en **Vinted URLs** y pulsa **Start**. Exporta a Excel, CSV, JSON o vía API, Make, Zapier, n8n.

### 🇵🇱 Polski

**Vinted Scraper** pobiera ogłoszenia z **wszystkich 26 rynków Vinted** (Polska, Czechy, Litwa, Niemcy, Francja, UK, USA…) **od $0.50 za 1000 ogłoszeń**, proxy w cenie.

- **Wklejasz dowolny link z Vinted** z ustawionymi filtrami albo wpisujesz frazy z marką, kategorią, rozmiarem, stanem, kolorem, materiałem i ceną.
- **Ponad 960 wyników**: wyszukiwanie dzieli się automatycznie na przedziały cenowe.
- **Monitoring**: przy cyklicznym uruchamianiu tylko **nowe ogłoszenia, obniżki cen i sprzedane przedmioty** (z liczbą dni do sprzedaży). Płacisz tylko za nowe.
- **Szczegóły ogłoszenia** (opis, wszystkie zdjęcia, kategoria, koszt wysyłki) i **profile sprzedawców** (kraj, ocena, sprzedane przedmioty, cała szafa).
- **Porównanie cen między krajami** w EUR.

**Start:** ustaw filtry na vinted.pl, skopiuj link, wklej w **Vinted URLs** i kliknij **Start**. Eksport do Excela, CSV, JSON albo przez API, Make, Zapier, n8n.

### 🇳🇱 Nederlands

**Vinted Scraper** haalt advertenties op uit **alle 26 Vinted-landen** (Nederland, België, Duitsland, Frankrijk, UK, VS…) **vanaf $0.50 per 1.000 advertenties**, proxies inbegrepen.

- **Plak elke Vinted-link** met je filters, of zoek op trefwoorden met merk, categorie, maat, staat, kleur, materiaal en prijs.
- **Meer dan 960 resultaten**: de zoekopdracht wordt automatisch in prijsklassen opgesplitst.
- **Monitoring**: bij geplande runs alleen **nieuwe advertenties, prijsdalingen en verkochte items** (met dagen te koop). Je betaalt alleen voor wat nieuw is.
- **Advertentiedetails** en **verkopersprofielen**, plus **prijsvergelijking tussen landen** in EUR.

**Starten:** stel je filters in op vinted.nl, kopieer de link, plak hem in **Vinted URLs** en klik op **Start**.

***

💬 Questions or a missing feature? Open an issue in the **Issues** tab. / Fragen? Questions ? Domande? ¿Preguntas? Pytania? Vragen? → **Issues**.

# Changelog

This Actor's version history is a separate document: https://apify.com/liveclaude/vinted-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search on Vinted, one per line (e.g. <code>nike air max</code>). Each query runs in every selected country.<br>🇵🇱 Frazy do wyszukania, jedna w linii. Każda fraza jest wyszukiwana w każdym wybranym kraju.

## `startUrls` (type: `array`):

Paste any Vinted link: a search page with filters set on the website, a brand or category page, a single listing (<code>/items/…</code>) or a seller profile (<code>/member/…</code>). All Vinted filters in the URL are supported.<br>🇵🇱 Wklej dowolny link z Vinted: wyszukiwanie z ustawionymi filtrami, markę, kategorię, ogłoszenie albo profil sprzedawcy. Działają wszystkie filtry z linku.

## `countries` (type: `array`):

Vinted marketplaces to search (used for search queries, brands and categories). 🇵🇱 Rynki Vinted do przeszukania.

## `allCountries` (type: `boolean`):

Search every Vinted marketplace at once (overrides the list above). 🇵🇱 Wszystkie 26 rynków naraz.

## `maxItemsPerSearch` (type: `integer`):

Limit per query and country. <code>0</code> = everything. Vinted shows max 960 results per search - this Actor goes past that limit automatically (see below).<br>🇵🇱 Limit na frazę i kraj, 0 = wszystko.

## `sortBy` (type: `string`):

Order of results. Newest first is best for monitoring. 🇵🇱 Kolejność wyników (najnowsze najlepsze do monitoringu).

## `categories` (type: `array`):

Category IDs (e.g. <code>1242</code>) or names as shown on the selected Vinted site (e.g. <code>Sneakers</code> or a path <code>Men > Shoes > Sneakers</code>).<br>🇵🇱 ID kategorii albo nazwa jak na Vinted (np. <code>Kurtki</code>).

## `brands` (type: `array`):

Brand names or IDs, e.g. <code>Nike</code>, <code>Zara</code>. Names are matched to Vinted brand IDs automatically. 🇵🇱 Marki po nazwie lub ID.

## `sizes` (type: `array`):

Size labels exactly as on Vinted, e.g. <code>M</code>, <code>42</code>, <code>W32</code>. Combine with a category for precise matching (e.g. size 42 in Men's sneakers). Raw size IDs: <code>id:786</code>. 🇵🇱 Rozmiary jak na Vinted (np. M, 42). Najlepiej razem z kategorią. ID rozmiaru: <code>id:786</code>.

## `conditions` (type: `array`):

🇵🇱 Stan przedmiotu.

## `colors` (type: `array`):

🇵🇱 Kolory.

## `materialIds` (type: `array`):

Vinted material IDs (easiest: set the material filter on the website and paste the URL instead). 🇵🇱 ID materiałów.

## `priceMin` (type: `number`):

In the local currency of each country (PLN on vinted.pl, EUR on vinted.de…). 🇵🇱 W walucie danego kraju.

## `priceMax` (type: `number`):

In the local currency of each country. 🇵🇱 W walucie danego kraju.

## `excludeKeywords` (type: `array`):

Skip listings whose title contains any of these words (e.g. <code>fake</code>, <code>damaged</code>). Skipped listings are free. 🇵🇱 Pomiń ogłoszenia z tymi słowami w tytule (bez opłaty).

## `titleMustInclude` (type: `array`):

Keep only listings whose title contains at least one of these words. 🇵🇱 Zostaw tylko ogłoszenia z jednym z tych słów w tytule.

## `sellerType` (type: `string`):

Private people, Vinted Pro businesses or both. 🇵🇱 Osoby prywatne, firmy (Vinted Pro) albo wszyscy.

## `sellerCountries` (type: `array`):

Keep only listings from sellers located in these countries (ISO codes, e.g. <code>PL</code>, <code>DE</code>). Vinted mixes listings from abroad into results - this removes them. 🇵🇱 Tylko sprzedawcy z tych krajów (Vinted miesza oferty z zagranicy).

## `minFavourites` (type: `integer`):

Only listings with at least this many likes (demand signal). 🇵🇱 Minimalna liczba polubień.

## `includeDetails` (type: `boolean`):

Open every listing and add: full description, all photos, category path, colour, material, upload time, shipping price, reserved/sold status and seller rating. Charged as an extra event.<br>🇵🇱 Pełny opis, wszystkie zdjęcia, kategoria, kolor, materiał, czas dodania, koszt wysyłki, status (rezerwacja/sprzedane), ocena sprzedawcy.

## `includeSellerInfo` (type: `boolean`):

Add seller data to each listing: username, country, city, rating, number of reviews, items sold, followers, last seen, Vinted Pro, bundle discounts. Charged once per unique seller.<br>🇵🇱 Dane sprzedawcy: login, kraj, miasto, ocena, opinie, sprzedane, obserwujący, ostatnio online.

## `includeSellerItems` (type: `boolean`):

For seller profile URLs, also return every listing in their wardrobe. 🇵🇱 Dla linków do profili: pobierz całą szafę sprzedawcy.

## `compareCountries` (type: `boolean`):

For each query searched in 2+ countries, add a summary record with min / median / average price per country (also converted to EUR) and the cheapest and most expensive market. Great for cross-border reselling.<br>🇵🇱 Porównanie cen między krajami (mediana, min, średnia, w EUR) - arbitraż.

## `onlyNewItems` (type: `boolean`):

Remember what was already returned and on the next runs output (and charge) only new listings - perfect for scheduled alerts. 🇵🇱 Tryb monitorowania: kolejne uruchomienia zwracają i naliczają tylko nowe ogłoszenia.

## `trackPriceDrops` (type: `boolean`):

In monitoring mode, also return already seen listings whose price went down (with previous price and drop %). 🇵🇱 Zwracaj też obniżki cen.

## `detectSoldItems` (type: `boolean`):

In monitoring mode, listings that disappear from your search are checked: if Vinted marks them as sold (or they were removed) you get a record with the last price, first/last seen date and days on market - great for sell-through and real selling prices. Works when a search returns fewer results than your limit (use precise filters or limit 0). 🇵🇱 Wykrywaj sprzedane / usunięte ogłoszenia: ostatnia cena, kiedy pierwszy raz widziane, ile dni wisiało.

## `emitOnFirstRun` (type: `boolean`):

Off = the first run only saves a baseline (free) and you get alerts from the second run on. 🇵🇱 Wyłączone = pierwsze uruchomienie tylko zapamiętuje stan (bez opłat).

## `monitorId` (type: `string`):

Optional name for the memory of this monitor (letters, digits, dashes). Leave empty to derive it from the input. 🇵🇱 Opcjonalna nazwa monitora.

## `bypassResultLimit` (type: `boolean`):

Vinted never shows more than 960 results per search. When on, the Actor splits large searches into price ranges and collects everything. 🇵🇱 Omijanie limitu 960 wyników.

## `maxConcurrency` (type: `integer`):

Parallel requests. 🇵🇱 Równoległe zapytania.

## `proxyConfiguration` (type: `object`):

Proxies are included in the price - leave as is. Advanced: you can add your own proxy URLs. 🇵🇱 Proxy wliczone w cenę - zostaw domyślne.

## Actor input object example

```json
{
  "searchQueries": [
    "nike air max"
  ],
  "countries": [
    "pl"
  ],
  "allCountries": false,
  "maxItemsPerSearch": 100,
  "sortBy": "newest_first",
  "sellerType": "all",
  "includeDetails": false,
  "includeSellerInfo": false,
  "includeSellerItems": true,
  "compareCountries": false,
  "onlyNewItems": false,
  "trackPriceDrops": true,
  "detectSoldItems": true,
  "emitOnFirstRun": true,
  "bypassResultLimit": true,
  "maxConcurrency": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "nike air max"
    ],
    "countries": [
        "pl"
    ],
    "maxItemsPerSearch": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("liveclaude/vinted-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["nike air max"],
    "countries": ["pl"],
    "maxItemsPerSearch": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("liveclaude/vinted-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "nike air max"
  ],
  "countries": [
    "pl"
  ],
  "maxItemsPerSearch": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call liveclaude/vinted-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,liveclaude/vinted-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/o7q0gRcnOUNGIZEn2/builds/YiMnCj7uNuSPSB2CL/openapi.json
