Heeft Vinted een API? Een advertentiefeed voor Discord-servers en reseller-apps

Als je een Discord-sourcingserver, een reseller-app of een kleine SaaS voor Vinted-verkopers draait, heb je onderliggend steeds hetzelfde nodig: een constante stroom nieuwe Vinted-advertenties die passen bij wat je leden of klanten zoeken. De eerste vraag die de meeste mensen stellen, is of Vinted daarvoor een API heeft.

Een open API publiceert Vinted niet. Er is geen openbare API om nieuwe advertenties te lezen, dus de meeste teams schrijven uiteindelijk een scraper. Dat werkt een tijdje. Daarna volgt het onderhoud: proxy's, geblokkeerde verzoeken, een paginawijziging die op zondag je parser kapotmaakt en een aparte opzet voor elk land dat je toevoegt.

Vinotify is een onafhankelijke dienst die dat deel voor je doet. Jij slaat zoekopdrachten op, Vinotify houdt ze voor je in de gaten en levert je de nieuwe matches via een REST-feed, webhooks of MCP. Je server of app bepaalt wat ermee gebeurt.

Eigen scraper of een feed?

Heb je al een scraper die werkt en vind je het fijn hem draaiende te houden, hou hem dan. De tabel hieronder is voor teams die die tijd liever aan hun leden of hun product besteden.

Eén ding moet duidelijk zijn: dit is geen volledige kopie van Vinted. Je krijgt nieuwe advertenties die passen bij je opgeslagen zoekopdrachten, niet elk item op de site. Voor een sourcingserver of een meldingsproduct is dat meestal ook precies wat je wilt.

Wat je in de feed krijgt

Elke opgeslagen zoekopdracht heeft een eigen eventstroom. Een event bevat een of meer nieuwe advertenties, en elke advertentie kan het item-id, de titel, het merk, de maat, de staat, de prijs, de valuta, de Vinted-URL en een foto bevatten. Het event vertelt je ook welke zoekopdracht, welke marktplaats en wanneer Vinotify het vond.

• Betaalde zoekopdrachten krijgen directe meldingen, zodat een match je kort na het plaatsen bereikt.
• Zoekopdrachten kunnen filteren op trefwoorden, categorie, merk, maat, staat, prijs, uitgesloten woorden en geblokkeerde verkopers.
• Je code kan zoekopdrachten maken, bijwerken, pauzeren, hervatten en verwijderen met een token met schrijfrechten, zodat leden of klanten hun eigen zoekopdrachten kunnen beheren vanuit je bot of app.
• De feed bevat geen verkopersnamen of profielen. Je krijgt de advertentie, niet de persoon erachter.

Veldnamen, limieten en foutcodes staan in de ontwikkelaarsdocumentatie.

Koppelen aan een Discord-server

De payload van Vinotify heeft niet het webhookformaat van Discord, dus je hebt een kleine brug ertussen nodig. De simpelste versie leest de eventfeed van één zoekopdracht en post elke nieuwe advertentie naar een Discord-kanaalwebhook:

import os, requests

API = "https://vinotify.me/api/v1/integrations"
HEADERS = {"Authorization": f"Bearer {os.environ['VINOTIFY_TOKEN']}"}
DISCORD = os.environ["DISCORD_WEBHOOK_URL"]
SEARCH_ID = 42

cursor, seen = "0-0", set()
while True:
    r = requests.get(f"{API}/events", headers=HEADERS, timeout=40,
                     params={"search_id": SEARCH_ID, "cursor": cursor, "wait": 30})
    if r.status_code == 410:          # cursor older than 48 hours
        cursor = "0-0"
        continue
    r.raise_for_status()
    body = r.json()
    for event in body["events"]:
        if event["event_id"] in seen:
            continue
        seen.add(event["event_id"])
        for item in event["items"]:
            embed = {"title": item["title"], "url": item["url"],
                     "description": f"{item['price']} {item['currency']}"}
            if item.get("photo"):
                embed["image"] = {"url": item["photo"]}
            requests.post(DISCORD, json={"embeds": [embed]}, timeout=10)
    cursor = body["next_cursor"]

Dit is een schets, geen afgewerkte bot. Een echte bot slaat de cursor op schijf op, zodat een herstart geen oude items opnieuw afspeelt, wacht op Retry-After bij een 429 en behandelt één kanaal per zoekopdracht. Een token staat 12 long polls tegelijk en 240 verzoeken per minuut toe; heb je meer zoekopdrachten, vraag ze dan om de beurt op zonder wait.

Wil je liever dat Vinotify jou aanroept, stel dan bij elke zoekopdracht een webhookbestemming in. Push is sneller maar wordt niet opnieuw geprobeerd, dus de meeste servers laten de feed erbij draaien. De webhookgids behandelt beide.

Wat het kost

De feed, webhooks en MCP zitten in het Pro-abonnement: €22.99 per maand in de EU, £19.99 in het VK en $19.99 in de VS, voor 100 zoekopdrachten met directe meldingen. Dat komt neer op ongeveer 23 cent per zoekopdracht. Een zoekopdracht die meer dan één marktplaats volgt, telt voor elke marktplaats één keer.

Heb je meer dan 100 zoekopdrachten nodig, mail dan naar support@vinotify.me. Grotere limieten worden per account ingesteld. Alle details over de abonnementen staan op de prijspagina.

Houd de grens duidelijk

Vinotify is niet gelieerd aan Vinted. Het houdt openbare advertenties voor je opgeslagen zoekopdrachten in de gaten. Het vraagt nooit om een Vinted-login, logt niet in op andermans account en koopt, stuurt geen berichten en zet niets als favoriet namens iemand anders.

De advertenties zijn van de mensen die ze hebben geplaatst. Link elk bericht terug naar de originele advertentie, bewaar alleen wat je dienst nodig heeft en controleer of je eigen gebruik past binnen de voorwaarden van Vinted en de wet in het land waar je actief bent. Dat deel is aan jou.

Om te beginnen maak je een Pro-account, voeg je een paar zoekopdrachten toe en maak je op de pagina Integraties een token met alleen leesrechten aan. Het automatiseringsoverzicht loopt de eerste aanroepen met je door.