Vinted Smart Scraper — Examples & Quick Start

Production-ready code samples for Vinted Smart Scraper — the only Vinted scraper on Apify Store that ships cross-country price comparison and arbitrage detection across 26 EU markets out of the box.

---

⚡ Quick Start (5 steps or fewer)

1. Get an Apify token — sign in at console.apify.com → Account → Integrations → copy your API token.

2. Pick a sample — Node, Python, curl, or n8n. See examples/.

3. Replace the placeholders — <APIFY_TOKEN> and your search query.

4. Run — the actor takes ~6 seconds median per market and returns a structured JSON dataset with prices normalized to EUR via ECB rates.

5. Read the data — each item has country, priceEur, priceLocal, seller, permalink, plus an arbitrageSpread field when cross-country mode is enabled.

# Smallest possible call (curl + jq)
curl -X POST "https://api.apify.com/v2/acts/kazkn~vinted-smart-scraper/run-sync-get-dataset-items?token=<APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "searchText": "nike air max 90",
    "countries": ["fr", "es", "it"],
    "maxResults": 50
  }' | jq '.[0]'

That's it — you'll see the first item shape inside 6 seconds.

---

🛒 What it does

Vinted has 26 EU country marketplaces, each with its own pricing. The same Nike Air Max 90 might list at €28 in Spain and €50 in Italy — that's a 78% arbitrage spread that resellers chase manually by opening five tabs.

This actor scrapes any number of country marketplaces in parallel, normalizes prices to EUR via the European Central Bank rate of the day, and returns a single ranked dataset with the cheapest country per item highlighted.

Use cases:

• Reseller intelligence (find best-buy / best-sell country per item)
• Brand pricing audits across 26 EU markets
• Trend research (which categories sell fastest in which market)
• Inventory sourcing for second-hand fashion businesses
• Feeding RAG / LLM agents with live marketplace data

---

💰 Pricing

• Pay-per-event on Apify: $0.018 per actor start + $0.0005 per result
• Free tier: $5/month Apify credit covers ~9,000 results — enough to validate on real queries
• No subscription, no minimums

Run the smallest possible workload to test, scale only when you find spreads worth chasing.

---

🛠 Examples (5)

Language / Tool	File	What it shows
Node.js (apify-client)	examples/node-apify-client.js	Full Apify SDK call with typed options + dataset iteration
Python (apify-client)	examples/python-apify-client.py	Same as Node, idiomatic Python with retries
curl + jq (no SDK)	examples/curl-sync.sh	One-shot synchronous call for shell scripts and CI
n8n (no-code)	examples/n8n-workflow.json	Importable workflow that polls a search hourly + sends a Telegram alert on new arbitrage spreads
Python async batch	examples/python-batch.py	Run 26 country scrapes in parallel + dedupe + rank by spread

---

📚 Documentation

• Apify Store actor page → apify.com/kazkn/vinted-smart-scraper — full input schema, output shape, pricing details
• Apify platform docs → docs.apify.com — actor lifecycle, datasets, scheduling, integrations
• Apify SDK reference (JS) → docs.apify.com/sdk/js
• Apify SDK reference (Python) → docs.apify.com/sdk/python
• MCP companion server → github.com/DataKazKN/vinted-mcp-server — wire the actor as an MCP tool to Claude Desktop / Cursor and query Vinted in plain English

---

🧠 Why this exists vs rolling your own

Vinted is protected by Datadome (Cloudflare-class anti-bot). Building your own scraper means:

• Residential proxies (~$10–15/GB)
• TLS fingerprint matching (curl-cffi, tls-client)
• Cookie persistence + session rotation
• Geo-aware routing (FR IP → vinted.fr)
• Jittered backoff
• Per-country session pool isolation

Realistic maintenance burden: 2–4 hours/month when nothing is wrong, plus emergency 4-hour fire drills every 3–6 months when Vinted tightens detection. If your hourly rate is above €30, the build-vs-buy math gets uncomfortable fast on this one specific target.

This actor handles all of the above so you don't have to. 18 months in production, 250+ active users, 98,000+ runs across 26 EU markets — see the actor reviews.

---

🤝 Contributing

Found a bug or want to suggest a new example? See CONTRIBUTING.md.

---

📄 License

MIT — see LICENSE.

The examples in this repository are MIT-licensed for free use. The Vinted Smart Scraper actor itself is hosted commercially on Apify Store under their standard pay-per-event terms.

---

Built and maintained by KazKN — indie developer, Switzerland. Questions? Open an issue here, or reach out via GitHub.