Automatiseer je Vinted-inkoop met de API, MCP en webhooks van Vinotify

Als je Vinted-items inkoopt om door te verkopen, is de nuttige automatisering meestal eenvoudig: bewaar je opgeslagen zoekopdrachten in Vinotify, lees nieuwe matches in je eigen workflow in en bepaal zelf wat je bekijkt of koopt. Vinotify levert de beheerde zoekfeed; je bot of coding-agent kan de rest van de overdracht afhandelen.

De integraties zijn beschikbaar voor Pro-accounts. Ze omvatten accountgebonden bearer-tokens, een REST-eventfeed, een direct MCP-endpoint voor compatibele agents, uitgaande webhooks en een duurzame eventfeed. Begin met de volledige ontwikkelaarsdocumentatie zodra je klaar bent om een client te koppelen.

Welke heb je nodig?

Er zijn drie ingangen, en ze passen bij verschillende klussen. Kies de rij die past bij wat je bouwt; elke rij verwijst naar de gids die het onderwerp goed behandelt.

Een resellerworkflow die overzichtelijk blijft

1. Maak opgeslagen zoekopdrachten voor de items, merken, maten, prijzen en trefwoorden die je echt inkoopt.
2. Maak onder Integraties een alleen-lezen integratietoken aan en bewaar het in je lokale omgeving of secret store.
3. Ontdek de actieve zoekopdrachten en lees dan elke eventstream vanaf een opgeslagen cursor.
4. Ontdubbel op event_id, maak van een match je eigen voorraad- of controlerecord en open de Vinted-URL wanneer je het item wilt bekijken.

Events worden minstens één keer geleverd. Dat is handig voor een robuuste bot, maar het betekent dat je consumer next_cursor moet opslaan en een herhaalde event_id die al is verwerkt moet negeren.

REST voor een kleine poller of bot

Een coding-agent kan een kleine worker bouwen rond twee aanroepen: actieve zoekopdrachten verversen met /api/v1/integrations/discovery/v2 en daarna een long poll doen op /api/v1/integrations/events?search_id=…&cursor=…&wait=30. Het antwoord bevat de events en de volgende cursor voor die zoekopdracht.

Authorization: Bearer $VINOTIFY_TOKEN

GET https://vinotify.me/api/v1/integrations/discovery/v2
GET https://vinotify.me/api/v1/integrations/events?search_id=42&cursor=0-0&wait=30

Houd per zoekopdracht een cursor bij. Meldt de feed dat de cursor is verlopen, zet hem dan terug naar de geretourneerde reset_cursor-waarde. Geeft de API 429 terug, wacht dan de tijd uit Retry-After af; bij 503 wacht je langer, zonder de opgeslagen cursor weg te gooien.

MCP voor een coding-agent, in het kort

MCP past goed als je wilt dat een agent je meldingen in gewone taal bekijkt. Richt een compatibele client op https://vinotify.me/api/v1/mcp en voeg het bearer-token toe in de lokale configuratie van die client. De leestools zijn list_searches, get_new_items en whats_new.

Schrijftools zijn apart en beperkt. Een token kan met schrijftoegang worden aangemaakt, en de schrijffunctie moet ook op de server zijn ingeschakeld, voordat een agent een zoekopdracht kan maken, bijwerken, pauzeren, hervatten of verwijderen. Laat het token alleen-lezen, tenzij je een duidelijke reden hebt om wijzigingen aan zoekopdrachten te delegeren.

{
  "mcpServers": {
    "vinotify": {
      "url": "https://vinotify.me/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Clientconfiguratie, de volledige toollijst en het tokenmodel worden behandeld in de MCP-server van Vinotify koppelen aan AI-tools.

Push of pull, in het kort

Push is de snelste route. Stel met PUT /api/v1/searches/<search_id>/webhook/external-url een bestemming in voor een Pro-zoekopdracht en Vinotify stuurt een POST met een new_items-body zodra een zoekopdracht iets vindt. De bestemming moet een openbaar HTTPS-endpoint zijn, en Vinotify controleert het zowel wanneer je het opslaat als opnieuw vóór elke levering.

Push werkt echter op basis van best effort. Er is geen wachtrij voor nieuwe pogingen, dus als je ontvanger niet beschikbaar is, is de levering verloren. De payload blijft 24 uur beschikbaar op /api/v1/searches/<search_id>/webhook/latest, en de met bearer geauthenticeerde eventfeed onder /api/v1/integrations bewaart 48 uur geschiedenis achter een cursor. Laat de feed naast push draaien als je geen item wilt missen, en ontdubbel op event_id.

De opbouw van de payload, het gedrag bij nieuwe pogingen en uitgewerkte opstellingen worden behandeld in de gids voor automatisering met webhooks.

Houd de grens duidelijk

Vinotify levert bewijs over de advertentie, zoals het moment van vastleggen, de vraagprijs en valuta, de titel, de URL, het item-id en de beschikbare itemdetails. Het koopt geen items, vraagt niet om Vinted-inloggegevens en maakt van een melding geen bevestigde verkoop. Je eigen workflow kan kandidaten scoren of in de wachtrij zetten, maar houd die beslissingen gescheiden van wat het event daadwerkelijk bewijst.

Bewaar het token buiten versiebeheer, ververs de discovery als je zoekopdrachten veranderen en trek het token in via Integraties wanneer je het niet meer nodig hebt. Voor exacte parameters, limieten, responsvelden en fouten gebruik je de ontwikkelaarsdocumentatie van Vinotify.