# Vinted EU & UK Smart Catalog & Price Comps Scraper (`pulse_extract/vinted-catalog-scraper`) Actor

Scrape Vinted EU & UK search listings, prices, buyer protection totals, brands, sizes, conditions, favourite counts, and price comps stats without a headless browser.

- **URL**: https://apify.com/pulse_extract/vinted-catalog-scraper.md
- **Developed by:** [Pulse Extract](https://apify.com/pulse_extract) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 vinted listing returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 EU & UK Smart Catalog & Price Comps Scraper

Extract live **Vinted** listings across **10 EU, UK, and US markets** (`vinted.fr`, `vinted.co.uk`, `vinted.de`, `vinted.es`, `vinted.it`, `vinted.nl`, `vinted.be`, `vinted.pl`, `vinted.pt`, `vinted.com`) — complete with item prices, Buyer Protection totals, brands, sizes, conditions, favourite counts, high-res photos, and automatic **price comps statistics** — **without launching a headless browser**.

Unlike legacy Vinted scrapers still hitting deprecated `/api/v2/catalog/items` endpoints, this Actor uses Chrome TLS fingerprint impersonation paired with Vinted's 2026 Next.js App Router payload + semantic DOM parser for fast, reliable extraction.

***

### Key Features

- **Zero-Browser Speed (96 Listings/Page):** Runs lightweight HTTP requests with Chrome TLS impersonation (`impit`) — fast startup and minimal Compute Unit overhead.
- **Built-In Price Comps (`SUMMARY`):** Automatically calculates `minPrice`, `p25Price`, `medianPrice`, `avgPrice`, `p75Price`, and `maxPrice` for every query so resellers and pricing engines can benchmark comps immediately.
- **Multi-Market EU/UK Support:** Search by plain keywords + country dropdown (`fr`, `co.uk`, `de`, `es`, `it`, `nl`, `be`, `pl`, `pt`, `com`), or paste any pre-filtered Vinted catalog URL directly.
- **Clean Filtering:** Exclude boosted/promoted listings (`excludePromoted`) and enforce `priceFrom`/`priceTo` bounds before billing.
- **Smart Proxy Fallback:** Tries fast direct requests first and invokes Apify Proxy only if blocked (403/429) and proxy access is configured.

***

### Example Input

```json
{
  "queries": [
    "nike air force"
  ],
  "country": "fr",
  "sortBy": "relevance",
  "priceFrom": 15,
  "priceTo": 80,
  "excludePromoted": false,
  "maxItemsPerSearch": 96,
  "useProxyOnBlock": true
}
```

***

### Example Output Item

```json
{
  "country": "fr",
  "itemId": 10825591873,
  "title": "Nike Air Force one noire T39",
  "brand": "Nike",
  "size": "39",
  "condition": "Neuf sans étiquette",
  "price": 30.0,
  "serviceFee": 2.2,
  "totalItemPrice": 32.2,
  "currency": "EUR",
  "favouriteCount": 28,
  "isPromoted": false,
  "sellerId": 192232773,
  "isBusinessSeller": false,
  "dominantColor": "#E1D3D2",
  "itemUrl": "https://www.vinted.fr/items/10825591873-nike-air-force-one-noire-t39",
  "imageUrl": "https://images1.vinted.net/...",
  "thumbnailUrl": "https://images1.vinted.net/...",
  "scrapedAt": "2026-11-19T03:25:00+00:00"
}
```

***

### Pricing & Billing Transparency

This Actor uses **Pay-Per-Event (PPE)** billing:

- **Actor Start:** `$0.00005` per run.
- **Per Listing Returned (`item-scraped`):** `$0.001` per listing (`$1.00 per 1,000 listings`).

***

### Use Cases & Integrations

- **Secondhand Resale Sourcing & Arbitrage:** Spot underpriced designer/sneaker listings by comparing `price` against `medianPrice` comps on schedule via **n8n** / **Make**.
- **E-Commerce Brand & Price Benchmarking:** Track resale supply, condition mix, and favourite demand across Europe (`vinted.fr`, `vinted.de`, `vinted.co.uk`).
- **AI Agents & MCP:** Connect via Apify's MCP server so shopping or reseller assistant agents can pull live secondhand price comps.

***

### FAQ

**Do I need Apify Residential Proxies?**\
Single-page queries often succeed directly; for high-volume multi-page or multi-country schedules, configuring Apify Residential Proxies with `useProxyOnBlock: true` ensures uninterrupted runs.

**Where are the Price Comps summary metrics stored?**\
Every run saves `priceCompsBySearch` (`minPrice`, `p25Price`, `medianPrice`, `avgPrice`, `p75Price`, `maxPrice`) inside the `SUMMARY` record of the default Key-Value Store.

# Actor input Schema

## `searchUrls` (type: `array`):

Full Vinted catalog URLs with any filters pre-applied (e.g. https://www.vinted.fr/catalog?search_text=nike+air+force\&price_to=60).

## `queries` (type: `array`):

Keywords to search on Vinted (combined with Country, Sort Order, and Price filters below).

## `country` (type: `string`):

Target Vinted marketplace domain used for plain search queries.

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

How Vinted orders search results.

## `priceFrom` (type: `number`):

Optional minimum item price (0 disables lower bound).

## `priceTo` (type: `number`):

Optional maximum item price (0 disables upper bound).

## `excludePromoted` (type: `boolean`):

Skip bumped/promoted items so organic listings and price comps stay clean.

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

Maximum listings returned per search query or URL (one catalog page returns up to 96 listings).

## `useProxyOnBlock` (type: `boolean`):

Try fast direct Chrome TLS requests first; fall back to Apify Proxy only if blocked and proxy access is configured.

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

Optional Apify Proxy settings (EU residential proxies recommended for heavy multi-page runs).

## Actor input object example

```json
{
  "searchUrls": [],
  "queries": [
    "nike air force"
  ],
  "country": "fr",
  "sortBy": "relevance",
  "priceFrom": 0,
  "priceTo": 0,
  "excludePromoted": false,
  "maxItemsPerSearch": 96,
  "useProxyOnBlock": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (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 = {
    "queries": [
        "nike air force"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pulse_extract/vinted-catalog-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 = { "queries": ["nike air force"] }

# Run the Actor and wait for it to finish
run = client.actor("pulse_extract/vinted-catalog-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 '{
  "queries": [
    "nike air force"
  ]
}' |
apify call pulse_extract/vinted-catalog-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pulse_extract/vinted-catalog-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/i9ps9DL06w5f1XYAY/builds/ZDLvsiRE74SZJUpab/openapi.json
