De meeste Vinted-meldingsdiensten sturen je een pushmelding of een e-mail. Dat werkt prima als je af en toe een paar sneakers voor jezelf koopt. Maar als je aan doorverkoop doet — of zelfs maar een dozijn zoekopdrachten over meerdere marktplaatsen volgt — wil je waarschijnlijk iets dat rechtstreeks in je bestaande systeem terechtkomt.
Dat is wat webhooks doen. In plaats van dat jij je meldingen controleert, komt de melding naar je code.
Wat is een webhook precies?
Een webhook is een HTTP-verzoek dat een server naar jouw URL stuurt telkens als er iets gebeurt. Bij Vinotify is dat ‘iets’: nieuwe items komen overeen met een van je zoekmeldingen.
Als het bewakingssysteem nieuwe Vinted-advertenties vindt die bij de filters van je zoekopdracht passen, stuurt het een POST-verzoek naar de URL die je hebt ingesteld. De body is JSON en bevat de naam van de zoekopdracht, titels, merken, prijzen, staten, maten, Vinted-links en foto-URL’s — alles wat je in de e-mail of pushmelding zou zien, maar in een formaat dat een machine kan lezen.
Hier is een vereenvoudigd voorbeeld van hoe de payload eruitziet:
{
"event": "new_items",
"search_id": 42,
"search_name": "Nike Dunk Low",
"item_count": 3,
"items": [
{
"title": "Nike Dunk Low Panda 42",
"brand": "Nike",
"size": "42",
"condition": "Very good",
"price": "55.00",
"url": "https://www.vinted.fr/items/...",
"photo": "https://..."
}
]
}Zodra de gegevens binnenkomen, kun je ermee doen wat je wilt: loggen, doorsturen, filteren, erop reageren.
Zo werkt het in Vinotify
Webhooks zijn onderdeel van het Pro-abonnement. Als je met Pro een zoekmelding maakt, genereert Vinotify voor die zoekopdracht een uniek webhook-secret. Daarna kun je:
- De nieuwste payload opvragen — er is een apart GET-endpoint dat de meest recente webhookgegevens voor je zoekopdracht teruggeeft, geauthenticeerd met het secret. Een JWT is niet nodig, dus het is makkelijk aan te roepen vanuit een cronjob of een Google Apps Script.
- Een externe URL instellen — wijs Vinotify naar je eigen HTTPS-endpoint (een Zapier-webhook, de URL van een AWS Lambda-functie, een Make.com-scenario, een zelf gehoste server — alles kan). Vinotify stuurt daar per POST de overeenkomende items naartoe zodra er nieuwe verschijnen.
Beide opties zijn beschikbaar via de API. Je vindt je webhook-secret en stelt de externe URL in via de instellingen van de zoekopdracht.
Praktische opstellingen die echt werken
Weten dat webhooks bestaan is één ding. Weten wat je ermee doet is iets anders. Hier zijn een paar opstellingen die Vinotify Pro-gebruikers hebben gebouwd:
1. Voorraadtracker in Google Sheets
Zet een gratis Google Apps Script online dat POST-verzoeken accepteert en elk item aan een spreadsheet toevoegt. Kolommen voor titel, merk, prijs, staat en URL. Je krijgt een doorlopend logboek van elk item dat je meldingen vangen, sorteerbaar en doorzoekbaar, zonder betaalde tools.
Dit is waarschijnlijk het simpelste beginpunt. Je schrijft zo’n 20 regels JavaScript in Apps Script, publiceert het als webapp en plakt de URL in Vinotify.
2. Telegram- of Discord-bot
Als je meldingen liever in een groepschat krijgt in plaats van (of naast) push en e-mail, zet dan een klein relay op. Het ontvangt de webhook, maakt er een bericht van met de itemfoto en een ‘Nu kopen’-link, en plaatst dat in een Telegram-kanaal via de Bot API of in een Discord-kanaal via de webhook-URL. Eén serverless functie regelt dit.
3. Filter voor prijsdalingen
Stel je volgt een brede zoekopdracht — ‘North Face Nuptse’ in alle maten. Dat kan 15 nieuwe advertenties per dag opleveren, maar je let pas op als er iets onder €80 uitkomt. Je webhook-ontvanger controleert het prijsveld en stuurt alleen items onder je drempel door. De rest wordt stilletjes gelogd.
4. Dashboard voor meerdere marktplaatsen
Pro ondersteunt zoekopdrachten over meerdere marktplaatsen (FR, DE, IT, UK enz. vanuit één melding). De webhook-payloads bevatten de naam van de zoekopdracht en de item-URL’s, die het domein van de marktplaats bevatten. Een lichtgewicht dashboard dat webhook-leveringen van meerdere zoekopdrachten verzamelt, geeft je één overzicht over marktplaatsen en categorieën — handig als je op grote schaal inkoopt.
Webhooks gebruiken als ‘veilige autocop’
Sommige wederverkopers willen de snelheid van autocop-tools zonder het risico dat ze inloggegevens afgeven of worden geblokkeerd. Met webhooks kan dat:
- Stel op je Pro-zoekopdracht een webhook in die naar een klein script of een serverless functie wijst.
- Als nieuwe items overeenkomen, ontvangt je script de gegevens meteen — inclusief de directe Vinted-URL van elk item.
- Je automatisering stuurt je een directe melding (Telegram, sms, desktop-popup) met de itemlink klaar om te openen.
- Jij tikt op de link en koopt handmatig — met een gewoon account, op normale menselijke snelheid.
Zo weet je bijna direct van nieuwe advertenties zonder dat een bot je Vinted-account aanraakt. Geen inloggegevens gedeeld, geen risico op een ban en veel goedkoper dan speciale autocop-abonnementen.
Lees meer: Vinted-autocop-tools versus webhooks: waarom meldingen winnen van automatische kopers →
Opvragen of push: wat kies je?
Vinotify biedt beide. Als jouw toepassing een kleine vertraging verdraagt (batchverwerking, spreadsheets, analyses), is het eenvoudiger om het GET-endpoint volgens een schema op te vragen — je hebt geen server nodig en je kunt het doen vanuit een browserextensie, een GitHub Action of een crontab.
Wil je levering in realtime op het moment dat items overeenkomen, stel dan een externe URL in en laat Vinotify naar je pushen. Dat is beter voor bots, live dashboards en alles waarbij 30 seconden voorsprong telt.
Een paar dingen om in gedachten te houden
- Behandel je webhook-secret als een wachtwoord. Iedereen die het heeft, kan je zoekresultaten lezen. Zet het niet in een openbare repository.
- Externe URL’s moeten HTTPS zijn (of HTTP voor lokale ontwikkeling). Vinotify levert niet af op niet-HTTP-schema’s.
- Payloads zijn beperkt tot 50 items per levering. Vindt een enkele controle meer overeenkomsten, dan bevat de payload de eerste 50. Zo blijven de verzoeken een redelijke grootte houden voor services verderop.
- Levering gebeurt op basis van best effort. Als je endpoint onbereikbaar is of een fout teruggeeft, blijft de payload toch 24 uur in de cache staan en beschikbaar via het opvraag-endpoint. Er is geen automatische wachtrij voor nieuwe pogingen — houd je ontvanger betrouwbaar of gebruik het opvraag-endpoint als terugval.
Aan de slag
Zit je al op het Pro-abonnement, dan heeft elke zoekopdracht die je maakt een webhook-secret. Ga naar de instellingen van je zoekopdracht, pak het secret en vraag het endpoint met de nieuwste payload op of stel een externe URL in.
Zit je op Free, Plus of Premium, dan zijn webhooks niet inbegrepen — maar pushmeldingen en e-mail dekken de meeste persoonlijke toepassingen prima. Webhooks zijn zinvol als je iets programmatisch met de gegevens wilt doen, en ze niet alleen wilt zien.
Veelgestelde vragen
- Hoe stel ik een webhook-URL in bij Vinotify?
- Elke Pro-zoekopdracht heeft een eigen webhook-secret. Stel de bestemming die de leveringen ontvangt in met PUT /api/v1/searches/{search_id}/webhook/external-url en stuur de URL mee in de body. Stuur een lege string om de levering te stoppen. De bestemming moet een openbaar HTTPS-endpoint zijn.
- Hoe ziet de webhook-payload eruit?
- Vinotify stuurt per POST een JSON-body met event ingesteld op new_items, plus search_id, search_name, item_count en een items-array met de overeenkomende advertenties.
- Worden mislukte webhook-leveringen opnieuw geprobeerd?
- Nee. Push-levering gebeurt op basis van best effort en er is geen wachtrij voor nieuwe pogingen, dus reageer snel en zet het werk aan jouw kant in een wachtrij. Was je endpoint onbereikbaar, dan blijft de meest recente payload 24 uur beschikbaar op /api/v1/searches/{search_id}/webhook/latest, en bewaart de gebeurtenissenfeed 48 uur geschiedenis achter een cursor.
- Kan ik de webhook rechtstreeks op een Discord-kanaal richten?
- Niet rechtstreeks. De Vinotify-payload heeft niet het formaat van de inkomende webhooks van Discord, dus een kleine bot of brug moet hem omzetten voordat hij wordt geplaatst.
- Welk abonnement bevat webhooks?
- Webhooks zijn een functie van het Pro-abonnement.