# Vinted Product Scraper (`sovanza.inc/vinted-product-scraper`) Actor Extract Vinted product listings, prices, and seller data from search or catalog pages and export it for analysis and automation. - **URL**: https://apify.com/sovanza.inc/vinted-product-scraper.md - **Developed by:** [Sovanza](https://apify.com/sovanza.inc) (community) - **Categories:** E-commerce - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $15.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Vinted Marketplace Scraper – Extract Listings, Prices & Data Extract Vinted product listings, prices, seller usernames, and listing details with this scraper. Ideal for resellers, dropshipping research, and market analysis. Export data in JSON, CSV, or Excel format from your Apify dataset. ### What is a Vinted Product Scraper? Vinted Product Scraper is a Vinted marketplace data extraction tool built on Apify that collects listing data from **catalog, search, and category pages** (pagination supported). It is designed for: - Resellers and flippers - Dropshippers - eCommerce sellers - Market researchers - Data analysts It helps you compare prices, spot trends, and build listing datasets without manually browsing every page. ### Why This Vinted Scraper is Powerful - Pull **many listings per run** via page-based pagination (`max_pages`; roughly **60 items per catalog page**). - Combine **multiple start URLs** and/or **keyword searches** in one run. - Get **structured prices** (base and “incl. fees” when shown on cards), **images**, **size**, **seller username**, and **favorites** when present. - Choose **country** and **language** to match the Vinted market you care about. - Export via Apify as **JSON, CSV, or Excel**; automate with the **API**, schedules, and webhooks. **What this actor focuses on:** data visible on **search/catalog listing cards**. It does **not** open every product detail page for long descriptions, full seller profiles, or guaranteed category/brand/condition fields—use the listing URL for deeper manual checks or extend the actor if you need detail-page scraping. ### What Data Does Vinted Product Scraper Extract? Each dataset item reflects fields parsed from listing cards (availability depends on Vinted’s HTML for your market): #### Product information - **Title** - **Listing URL** (`url`) #### Pricing data - **Price** (display text) - **`price_amount` / `price_currency`** — numeric base price when parsed - **`price_incl` / `price_incl_amount` / `price_incl_currency`** — total including buyer protection / fees when a second price appears on the card #### Seller and engagement - **Seller** — username when shown on the card - **Favorites** — count when available on the card #### Listing details - **Size** — when shown (e.g. clothing sizes) - **Images** — `image_url` (main) and `images` (array when collected) - **`timestamp`** — scrape time (ISO 8601) ➡️ All structured fields are exportable in **JSON, CSV, or Excel** via the Apify dataset. ### Advanced Features - **Catalog / search URLs:** Pass full Vinted `catalog` URLs (search, filters, categories) as `startUrls`. - **Keywords:** If `startUrls` is empty, provide `search_keywords` — the actor builds catalog URLs per keyword. - **Pagination:** `max_pages` controls how many pages to follow per URL (`0` = all pages, subject to site behavior and run limits). - **Markets:** `country` selects the Vinted domain (e.g. `com`, `de`, `co.uk`); `language` sets `locale` where supported. - **Automation:** Apify API, schedules, webhooks; integrate with Sheets, Zapier, Make, or your own stack. ### How to Use Vinted Product Scraper on Apify 1. Open **Vinted Marketplace Scraper** (this actor) on Apify. 2. Set **Input** — at least one of `startUrls` **or** `search_keywords` (see below). 3. Click **Start**. 4. Open the **Dataset** tab; export **JSON**, **CSV**, or **Excel**, or use the Apify API. #### Local run ```bash cd vinted-product-scraper pip install -r requirements.txt playwright install chromium ## Optional: create INPUT.json, then: python main.py ```` ### Input configuration `startUrls` accepts a **list of strings** (full URLs) or objects `{ "url": "..." }` (both supported in code). Example using **search keywords** (equivalent spirit to `search: "nike shoes"` — use `search_keywords` and control volume with `max_pages`): ```json { "search_keywords": ["nike shoes"], "max_pages": 4, "country": "com", "language": "en", "proxyCountry": "AUTO_SELECT_PROXY_COUNTRY" } ``` Rough scale: about **60 items per page** per catalog URL—e.g. `max_pages: 4` can yield on the order of **240** items from that query, subject to what Vinted returns and deduplication. Example using a **direct catalog URL**: ```json { "startUrls": ["https://www.vinted.com/catalog?search_text=tshirt"], "max_pages": 2, "country": "com", "language": "en" } ``` | Field | Type | Description | |--------|------|-------------| | `startUrls` | array | Vinted catalog/search/category URLs (strings or `{ "url" }`). Leave empty if using `search_keywords`. | | `search_keywords` | array | Keywords; builds catalog URLs if `startUrls` is empty. | | `max_pages` | integer | Max pages **per URL** (`0` = all). Default **1**. ~60 items per page. | | `country` | string | Market: `com`, `fr`, `de`, `co.uk`, etc. (see Console enum). Default `com`. | | `language` | string | `en`, `fr`, `es`, `nl`. Default `en`. | | `proxyCountry` | string | `AUTO_SELECT_PROXY_COUNTRY`, `US`, `GB`, `DE`, `FR`, `JP`, `CA`, `IT` — use with **Apify Proxy** in production; configure proxy in your Apify run/environment as needed. | **Required:** at least one **start URL** or **search keyword**. ### Output | Field | Description | |--------|-------------| | `url` | Product listing URL | | `title` | Listing title | | `price` | Price as shown on the card | | `price_amount` | Numeric base price | | `price_currency` | Currency for base price | | `price_incl` | Price including fees (text), if present | | `price_incl_amount` | Numeric price including fees | | `price_incl_currency` | Currency for incl. price | | `image_url` | Main image URL | | `images` | All image URLs collected | | `size` | Size if present on card | | `seller` | Seller username if present | | `favorites` | Favorite count if present | | `timestamp` | Scrape time | Example (illustrative): ```json { "url": "https://www.vinted.com/items/12345678-example", "title": "Nike sneakers — size 42", "price": "$45.00", "price_amount": 45.0, "price_currency": "USD", "price_incl": "$51.20 incl.", "price_incl_amount": 51.2, "image_url": "https://images.vinted.net/...", "images": ["https://images.vinted.net/..."], "size": "42", "seller": "example_seller", "favorites": 12, "timestamp": "2026-03-30T12:00:00.000Z" } ``` Schema reference: `.actor/dataset_schema.json`. ### How it works 1. Loads input from Apify or local `INPUT.json`. 2. Normalizes `startUrls` and/or builds URLs from `search_keywords` and `country` / `language`. 3. Uses **Playwright (Chromium)** to load each catalog URL, paginates up to `max_pages`, and parses listing cards with **BeautifulSoup** (multiple selectors for layout changes). 4. Pushes one dataset item per parsed listing. ### Integrations and API - **Apify API** — start runs, read datasets, webhooks. - **Python / Node.js** — official Apify clients. - **Zapier / Make / Google Sheets** — via Apify integrations or HTTP. ### FAQ **How can this scraper help with reselling or arbitrage?**\ It collects many listings with prices and links quickly so you can compare asking prices and spot outliers. Always verify on the live listing before buying. **Can I use it for arbitrage?**\ Yes for **data gathering**—export prices and URLs, then validate on Vinted or other marketplaces yourself. **How accurate is pricing?**\ Prices come from the **catalog cards** at scrape time. Listings change fast—re-check before acting. **Can I track trending products?**\ You can run repeated scrapes on the same searches and compare volumes, favorites, and price distributions in your own analysis. **Does it include full seller profiles or listing descriptions?**\ Not by default—typically **seller username** from the card only. Long descriptions, profile URLs, upload dates, and categories are **not** guaranteed in the current output; those would require detail-page scraping or API extensions. **Can I automate runs?**\ Yes—Apify **schedules** and **API** support recurring monitoring. **How much data per run?**\ Depends on `max_pages`, number of URLs/keywords, and your Apify plan limits. Roughly **60 items per page** per URL. **Can I integrate with my workflow?**\ Yes—export CSV/Excel, or use the API and connect to Sheets, CRMs, or custom tools. **Is scraping Vinted allowed?**\ Only use publicly visible data in line with **Vinted’s terms of service** and applicable laws (including privacy and marketing rules). ### SEO keywords (high-intent) vinted scraper, vinted product scraper, vinted data scraper, vinted listings scraper, vinted scraping api, vinted marketplace scraper, vinted arbitrage tool, vinted reselling tool, scrape vinted products, best vinted scraper ### Limitations - Vinted’s HTML changes; selectors in `main.py` may need updates over time. - Catalog view may omit fields that exist only on **item detail** pages. - Heavy use may trigger rate limits—use **Apify Proxy** and reasonable `max_pages` / scheduling. - Some content may be region- or login-gated. ### License MIT. # Actor input Schema ## `startUrls` (type: `array`): Enter one or more Vinted catalog, search, or category page URLs to scrape (one per line). Leave empty to use Search Keywords instead. ## `search_keywords` (type: `array`): Keywords to search (builds catalog URLs if Start URLs not provided). One per line. ## `max_pages` (type: `integer`): Max pages to scrape for each URL (60 items per page). 0 = all pages. ## `country` (type: `string`): Vinted country/market (com = US, co.uk = UK, etc.). ## `language` (type: `string`): Interface language for Vinted. ## `proxyCountry` (type: `string`): Country for proxy (AUTO\_SELECT\_PROXY\_COUNTRY to auto-select based on domain) ## Actor input object example ```json { "startUrls": [ "https://www.vinted.com/catalog?search_text=tshirt" ], "max_pages": 1, "country": "com", "language": "en", "proxyCountry": "AUTO_SELECT_PROXY_COUNTRY" } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.vinted.com/catalog?search_text=tshirt" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sovanza.inc/vinted-product-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.vinted.com/catalog?search_text=tshirt"] } # Run the Actor and wait for it to finish run = client.actor("sovanza.inc/vinted-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.vinted.com/catalog?search_text=tshirt" ] }' | apify call sovanza.inc/vinted-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sovanza.inc/vinted-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Vinted Product Scraper", "description": "Extract Vinted product listings, prices, and seller data from search or catalog pages and export it for analysis and automation.", "version": "0.0", "x-build-id": "pgRddSsllazJPLr2X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sovanza.inc~vinted-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sovanza.inc-vinted-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sovanza.inc~vinted-product-scraper/runs": { "post": { "operationId": "runs-sync-sovanza.inc-vinted-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sovanza.inc~vinted-product-scraper/run-sync": { "post": { "operationId": "run-sync-sovanza.inc-vinted-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Single/Multiple Catalog URL's", "type": "array", "description": "Enter one or more Vinted catalog, search, or category page URLs to scrape (one per line). Leave empty to use Search Keywords instead.", "items": { "type": "string" } }, "search_keywords": { "title": "Search Keywords", "type": "array", "description": "Keywords to search (builds catalog URLs if Start URLs not provided). One per line.", "items": { "type": "string" } }, "max_pages": { "title": "Page limit", "minimum": 0, "type": "integer", "description": "Max pages to scrape for each URL (60 items per page). 0 = all pages.", "default": 1 }, "country": { "title": "Country", "enum": [ "com", "fr", "at", "be", "cz", "de", "dk", "es", "fi", "gr", "hr", "hu", "ie", "it", "lt", "lu", "nl", "pl", "pt", "ro", "se", "sk", "co.uk" ], "type": "string", "description": "Vinted country/market (com = US, co.uk = UK, etc.).", "default": "com" }, "language": { "title": "Language", "enum": [ "en", "fr", "es", "nl" ], "type": "string", "description": "Interface language for Vinted.", "default": "en" }, "proxyCountry": { "title": "Proxy Country", "enum": [ "AUTO_SELECT_PROXY_COUNTRY", "US", "GB", "DE", "FR", "JP", "CA", "IT" ], "type": "string", "description": "Country for proxy (AUTO_SELECT_PROXY_COUNTRY to auto-select based on domain)", "default": "AUTO_SELECT_PROXY_COUNTRY" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```