Om Vinted-advertenties van vinted.nl in code op te halen, gebruik je de Vinted API van Scavio. POST /api/v1/vinted/search met "country": "nl" en een zoekterm geeft 96 advertenties per aanroep, elk met prijs, Vinted-vergoeding, het totaal dat de koper betaalt zonder verzending, maat, staat, foto's en de ID van de verkoper. Zet merken, categorieën en staten eerst om in ID's met /brands, /categories en /filters, lees één advertentie volledig (beschrijving, alle foto's, verkocht of gereserveerd) met /product, en controleer de verkoper met /seller en /seller-feedback. Elke aanroep kost 1 credit.
De eigen API van Vinted, Vinted Pro Integrations, is alleen open voor toegelaten Vinted Pro-bedrijven en beheert hun eigen artikelen en bestellingen; zoeken in de marktplaats kan er niet mee. De stappen hieronder halen de marktplaatskant op als JSON met één Scavio-key. Elk antwoord is vastgelegd op vinted.nl op 9 november 2026, en het voorbeeld is een winterjas van Scotch & Soda in maat M.
Stap 1: zet namen om in ID's
Zoekfilters werken met ID's, niet met namen. Begin bij wat kopers typen:
curl -s https://api.scavio.dev/api/v1/vinted/suggestions \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl", "query": "winterj"}'Vastgelegde data (6 van de 10 suggesties ingekort):
{
"country": "nl",
"query": "winterj",
"count": 10,
"suggestions": [
{ "text": "winterjas dames", "type": "popular_search" },
{ "text": "winterjas heren", "type": "popular_search" },
{ "text": "winterjas meisjes", "type": "popular_search" },
{ "text": "winterjas jongen 74", "type": "popular_search" }
]
}Daarna het merk:
curl -s https://api.scavio.dev/api/v1/vinted/brands \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl", "query": "scotch"}'Vastgelegde data (8 van de 10 merken ingekort):
{
"country": "nl",
"query": "scotch",
"count": 10,
"brands": [
{ "id": 13743, "title": "Scotch & Soda", "slug": "scotch-soda", "url": "https://www.vinted.nl/brand/13743-scotch-soda", "item_count": 1049181, "is_luxury": false, "requires_authenticity_check": false },
{ "id": 278, "title": "Maison Scotch", "slug": "maison-scotch", "url": "https://www.vinted.nl/brand/278-maison-scotch", "item_count": 214211, "is_luxury": false, "requires_authenticity_check": false }
]
}De matching is ruim: hetzelfde antwoord bevat Scotch Shrunk en Scotchlite, en zelfs Nintendo en Skechers. Kies de exacte title. item_count is het aantal advertenties van het merk op die site, 1.049.181 voor Scotch & Soda, dus /brands is ook een snelle manier om een merk op Vinted te meten. De categorie komt uit /categories: {"country": "nl", "parent_id": 1907} gaf Jassen met het pad Dames > Kleding > Buitenkleding > Jassen en 7 subcategorieën, van Duffeljassen tot Trenchcoats, met Parka jassen als 1087.
Stap 2: haal ID's voor staat en maat op, met aantallen
curl -s https://api.scavio.dev/api/v1/vinted/filters \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl", "filter": "status", "query": "winterjas dames"}'Vastgelegde data (omschrijvingen ingekort), in 1,0 seconde:
{
"country": "nl",
"filter": "status",
"search_param": "status_ids",
"query": "winterjas dames",
"category_id": null,
"count": 5,
"options": [
{ "id": 6, "title": "Nieuw met prijskaartje", "item_count": 5691 },
{ "id": 1, "title": "Nieuw zonder prijskaartje", "item_count": 25405 },
{ "id": 2, "title": "Heel goed", "item_count": 107826 },
{ "id": 3, "title": "Goed", "item_count": 41510 },
{ "id": 4, "title": "Veelgebruikt", "item_count": 4544 }
]
}search_param zegt in welke zoekparameter de ID's horen. De aantallen zijn live: 184.976 advertenties passen bij "winterjas dames" op vinted.nl, en 107.826 daarvan zijn in staat "heel goed". Met "filter": "size" en "category_id": 1907 kreeg je 199 maatopties; "M / 38 / 10" is ID 4, met 52.819 winterjassen. De titels komen in de taal van de site, de ID's zijn op elke site gelijk.
Stap 3: zoek met de filters
curl -s https://api.scavio.dev/api/v1/vinted/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl", "query": "winterjas", "brand_ids": [13743], "category_id": 1907, "size_ids": [4], "status_ids": [2], "sort": "newest_first"}'Vastgelegde data in 3,3 seconden (78 van de 80 artikelen ingekort, en de ID's van particuliere verkopers verwijderd):
{
"country": "nl",
"currency": "EUR",
"query": "winterjas",
"page": 1,
"per_page": 96,
"count": 80,
"listed_results": 80,
"total_is_capped": false,
"total_pages": 1,
"has_more": false,
"filters": {
"query": "winterjas",
"category_ids": [1907],
"brand_ids": [13743],
"status_ids": [2],
"size_ids": [4],
"color_ids": [],
"material_ids": [],
"price_from": null,
"price_to": null,
"currency": null,
"sort": "newest_first"
},
"items": [
{
"id": 10720542006,
"title": "Winterjas Scotch & Soda",
"url": "https://www.vinted.nl/items/10720542006-winterjas-scotch-soda",
"price": 25,
"currency": "EUR",
"price_with_discount": null,
"service_fee": 1.95,
"total_price": 26.95,
"brand": "Scotch & Soda",
"size": "M",
"condition": "Heel goed",
"favourite_count": 36,
"is_promoted": false,
"image": "https://images1.vinted.net/t/06_009ea_LjT2h4P2ZXwRgrcsUqawicyw/f800/08ca89eb.webp?s=fc90622ddd100ab7ff9bebd0746660067b2269dc",
"thumbnail": "https://images1.vinted.net/t/06_009ea_LjT2h4P2ZXwRgrcsUqawicyw/310x430/08ca89eb.webp?s=242bcfef618ef9f1db120e38fc29c8edda9db307",
"photos": ["https://images1.vinted.net/t/06_009ea_LjT2h4P2ZXwRgrcsUqawicyw/f800/08ca89eb.webp?s=fc90622ddd100ab7ff9bebd0746660067b2269dc"],
"seller": { "is_business": false }
},
{
"id": 10694081095,
"title": "Winterjas Scotch & Soda",
"url": "https://www.vinted.nl/items/10694081095-winterjas-scotch-soda",
"price": 30,
"currency": "EUR",
"price_with_discount": null,
"service_fee": 2.2,
"total_price": 32.2,
"brand": "Scotch & Soda",
"size": "M",
"condition": "Heel goed",
"favourite_count": 1,
"is_promoted": false,
"image": "https://images1.vinted.net/t/02_00e3b_tPzn28p24CZPopRQgP9TwvhV/f800/971dc666.webp?s=f12831b54b92aa41208b1fd4f14e41533d0fe028",
"thumbnail": "https://images1.vinted.net/t/02_00e3b_tPzn28p24CZPopRQgP9TwvhV/310x430/971dc666.webp?s=378c2c4b3f93201b072effeb579759dd89566dc1",
"photos": ["https://images1.vinted.net/t/02_00e3b_tPzn28p24CZPopRQgP9TwvhV/f800/971dc666.webp?s=f12831b54b92aa41208b1fd4f14e41533d0fe028"],
"seller": { "is_business": false }
}
]
}Lees een rij zo: de verkoper vraagt € 25, de Vinted-vergoeding (service_fee) is € 1,95, dus de koper betaalt € 26,95 zonder verzending. In de 480 advertenties van de prijsgrafiek in de beste Vinted API's was de vergoeding op vinted.nl steeds € 0,70 plus 5% van de prijs; verzendkosten komen niet terug. Het filters-blok is wat Vinted heeft toegepast: elke ID die we stuurden staat erin, dus de 80 rijen zijn echt Scotch & Soda, maat M en heel goed. En total_is_capped: false met listed_results: 80 betekent dat dit het hele aanbod is. Bij een brede zoekopdracht staat daar 960 met total_is_capped: true: Vinted toont maximaal 10 pagina's van 96, dus maak de zoekopdracht dan smaller.
Stap 4: lees één advertentie, en kijk of die nog te koop is
curl -s https://api.scavio.dev/api/v1/vinted/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl", "item_id": 10720542006}'Vastgelegde data (2 van de 3 foto's ingekort; login, ID en profiel-URL van de verkoper verwijderd):
{
"country": "nl",
"id": 10720542006,
"url": "https://www.vinted.nl/items/10720542006-winterjas-scotch-soda",
"title": "Winterjas Scotch & Soda",
"description": "Zeer nette jas van Scotch & Soda maat M.",
"description_translated": false,
"price": 25,
"currency": "EUR",
"brand": { "id": 13743, "name": "Scotch & Soda" },
"size": null,
"condition": "Heel goed",
"color": "Mosterdgeel",
"material": null,
"uploaded_relative": "19 uur geleden",
"category": {
"id": 1087,
"name": "Parka jassen",
"path": [
{ "id": 1904, "title": "Dames", "url": "https://www.vinted.nl/catalog/1904-women" },
{ "id": 4, "title": "Kleding", "url": "https://www.vinted.nl/catalog/4-clothing" },
{ "id": 1037, "title": "Buitenkleding", "url": "https://www.vinted.nl/catalog/1037-outerwear" },
{ "id": 1907, "title": "Jassen", "url": "https://www.vinted.nl/catalog/1907-coats" },
{ "id": 1087, "title": "Parka jassen", "url": "https://www.vinted.nl/catalog/1087-parkas" }
]
},
"photos": ["https://images1.vinted.net/t/06_009ea_LjT2h4P2ZXwRgrcsUqawicyw/f800/08ca89eb.webp?s=fc90622ddd100ab7ff9bebd0746660067b2269dc"],
"favourite_count": 36,
"is_reserved": false,
"is_sold": false,
"status_label": null,
"can_buy": true,
"instant_buy": true,
"is_hidden": false,
"seller": { "is_business": false, "feedback_count": 66, "feedback_reputation": 0.98, "badges": ["ACTIVE_LISTER"] }
}Let op: uploaded_relative is de eigen formulering van Vinted ("19 uur geleden"), geen tijdstempel. feedback_reputation is een score van 0 tot 1. De product-response heeft geen vergoeding; die haal je uit service_fee in de zoekrij. De productprijs is die van de verkoper: voor een Nederlandse verkoper dezelfde euro's, maar bij een verkoper buiten de eurozone staat hier diens eigen valuta.
Voor een melder is dit de stopconditie: controleer de advertentie opnieuw, en zodra is_sold of is_reserved op true springt, haal je hem uit je lijst. Een verkochte advertentie antwoordt nog steeds, met "is_sold": true, "status_label" en de laatste prijs. Zoeken geeft nooit verkochte advertenties terug, dus dit gaat per artikel, niet als verkoophistorie.
Stap 5: controleer de verkoper
seller.id uit een zoekrij of product voedt drie endpoints. Het voorbeeld is de zakelijke verkoper muchadoaboutvintage (3137190744):
curl -s https://api.scavio.dev/api/v1/vinted/seller \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl", "user_id": 3137190744}'Vastgelegde data:
{
"country": "nl",
"id": 3137190744,
"login": "muchadoaboutvintage",
"profile_url": "https://www.vinted.nl/member/3137190744-muchadoaboutvintage",
"is_business": true,
"feedback_count": 186,
"feedback_reputation": 1,
"positive_feedback_count": 186,
"neutral_feedback_count": 0,
"negative_feedback_count": 0,
"item_count": 299,
"country_code": "NL",
"country_name": "Nederland",
"city": null,
"verification": { "email": true, "facebook": false, "google": true },
"avg_response_time": null,
"is_on_holiday": false,
"last_seen_date": "2026-11-09"
}Dan de beoordelingen, tot 50 per pagina:
curl -s https://api.scavio.dev/api/v1/vinted/seller-feedback \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "nl", "user_id": 3137190744, "limit": 50}'Vastgelegde data (48 van de 50 rijen ingekort):
{
"country": "nl",
"user_id": 3137190744,
"page": 1,
"per_page": 50,
"total_results": 186,
"total_pages": 4,
"count": 50,
"has_more": true,
"feedback": [
{ "id": 4707220285, "rating": 5, "text": "Automatische review: Verkoop succesvol afgerond", "created_at": "2026-11-08T13:00:54.000Z", "is_automatic": true, "seller_reply": null },
{ "id": 4670223595, "rating": 5, "text": "Zeer blij met mijn oorringen.", "created_at": "2026-11-02T16:27:05.000Z", "is_automatic": false, "seller_reply": null }
]
}28 van de 50 rijen waren automatische beoordelingen van Vinted, dus filter op is_automatic voordat je samenvat wat kopers schreven. De andere 22, van 23 september tot 5 november, waren allemaal 5 sterren, en meer dan de helft was in het Frans: ook kopers komen over de grens. Rijen hebben geen schrijver en geen artikel, bewust. /seller-products met dezelfde user_id en "limit": 96 gaf de eerste 96 van de 299 artikelen in één aanroep, van € 2,50 tot € 80, elk met vergoeding, totaal en de vlaggen is_sold en is_reserved.
Stap 6: maak van de zoekopdracht een melding bij nieuwe advertenties
import time
import requests
KEY = "sk_live_your_key" # uit het Scavio-dashboard
BODY = {"country": "nl", "query": "winterjas", "brand_ids": [13743], "category_id": 1907,
"size_ids": [4], "status_ids": [2], "sort": "newest_first"}
seen = set()
while True:
r = requests.post("https://api.scavio.dev/api/v1/vinted/search", json=BODY,
headers={"Authorization": f"Bearer {KEY}"}, timeout=60)
for item in r.json()["data"]["items"]:
if item["id"] not in seen:
seen.add(item["id"])
print(item["total_price"], item["currency"], item["title"], item["url"])
time.sleep(300) # elke 5 minuten: 288 credits per dagDe eerste run vult seen met het huidige aanbod; daarna verschijnen alleen nieuwe advertenties. Stuur ze naar Discord, Telegram of Slack in plaats van ze te printen. De API levert alleen gegevens: hij koopt niets, doet geen biedingen en stuurt verkopers geen berichten.
Alle 9 endpoints
| Endpoint | Wat het teruggeeft | Credits |
|---|---|---|
/api/v1/vinted/search | 96 advertenties per pagina, pagina 1-10, met prijs, Vinted-vergoeding, totaal, maat, staat, foto's en verkopers-ID, plus de toegepaste filters | 1 |
/api/v1/vinted/product | Eén advertentie op ID of URL: beschrijving, alle foto's, categoriepad, verkocht- en gereserveerd-status, score van de verkoper | 1 |
/api/v1/vinted/seller | Openbaar profiel: score, aantallen positief, neutraal en negatief, aantal artikelen, verificaties | 1 |
/api/v1/vinted/seller-products | Artikelen van een verkoper, tot 96 per pagina, met vergoeding, totaal en verkocht- en gereserveerd-vlaggen | 1 |
/api/v1/vinted/seller-feedback | Beoordelingen, tot 50 per pagina, nieuwste eerst, met automatisch-vlag en reactie van de verkoper | 1 |
/api/v1/vinted/brands | Merk-ID's met aantal advertenties en de vlaggen voor luxe en echtheidscontrole | 1 |
/api/v1/vinted/suggestions | Tot 10 zoeksuggesties in de taal van de site | 1 |
/api/v1/vinted/filters | ID's voor maat, staat, kleur of materiaal met live aantallen | 1 |
/api/v1/vinted/categories | De categorieboom in de taal van de site, of één deelboom | 1 |
Fouten worden niet in rekening gebracht: een onbekend artikel, lid of categorie is een 404, een tijdelijke storing een 502. Elk endpoint neemt country: nl voor vinted.nl, fr (de standaard) en de andere EU-sites, uk, us of au. Er is geen zoeken in verkochte advertenties, geen verzendprijs en geen endpoint voor vergelijkbare artikelen. Per endpoint staan alle parameters in de Nederlandse documentatie: zoeken, product, verkoper, artikelen van een verkoper, beoordelingen, merken, suggesties, filters en categorieën. Alle Vinted-opties naast elkaar staan in de 6 beste Vinted API's.
Aan de slag
- Meld je aan op dashboard.scavio.dev/sign-up: 50 gratis credits, zonder creditcard, genoeg voor 50 Vinted-aanroepen.
- Kopieer je API-key van het dashboard en zet hem in
SCAVIO_API_KEY. - Draai stap 1 tot 3 met je eigen zoekterm en
"country": "nl", of probeer ze eerst in de playground. - Lees de Vinted API-pagina voor Nederland voor alle endpoints en voorbeelden in Python en JavaScript.
Frequently asked questions
Hoe vind ik het merk-ID of categorie-ID op Vinted?
Roep /api/v1/vinted/brands aan met een naam: "scotch" gaf Scotch & Soda als merk-ID 13743, met 1.049.181 advertenties op vinted.nl op 9 november 2026. /api/v1/vinted/categories geeft de categorieboom met ID's (Dames > Kleding > Buitenkleding > Jassen is 1907), en /api/v1/vinted/filters geeft ID's voor staat, maat, kleur en materiaal met live aantallen. De ID's zijn op alle 27 sites gelijk.
Hoeveel resultaten geeft één Vinted-zoekopdracht?
96 per pagina en maximaal 10 pagina's, dus 960. Staat total_is_capped op true, dan zijn er meer treffers; maak de zoekopdracht smaller met categorie, merk, maat, staat of prijs. Een smalle zoekopdracht naar Scotch & Soda-winterjassen in maat M en staat heel goed gaf 80 resultaten met total_is_capped false: dat is het volledige aanbod.
Kan ik zien of een Vinted-advertentie verkocht is?
Ja, per advertentie. /api/v1/vinted/product geeft is_sold, is_reserved, status_label en can_buy terug. Een verkochte advertentie blijft antwoorden met is_sold true en de laatste prijs. De zoekfunctie toont alleen advertenties die nog te koop staan, dus er is geen lijst met verkochte artikelen om door te bladeren.
Werkt de Vinted API met Python?
Ja. Elke aanroep is een HTTPS POST met JSON en een API-key in de Authorization-header, dus requests volstaat. De Python-SDK van Scavio (pip install scavio) heeft client.vinted.search(country="nl", query="winterjas") en dezelfde methoden voor product, seller, filters en de rest.
Wat kost de Vinted API van Scavio?
Elk Vinted-endpoint kost 1 credit per aanroep, 1 dollar per 1.000 aanroepen op het Growth-tarief van 1 dollar per 1.000 credits. Een zoekopdracht geeft voor die ene credit 96 advertenties. Fouten zoals een onbekende advertentie (404) worden niet in rekening gebracht, en nieuwe accounts krijgen 50 gratis credits zonder creditcard.