Vinotify Logovinotify
Anmelden

Vinted-Alarme mit Webhooks automatisieren

Die meisten Vinted-Alarmdienste schicken dir eine Push-Benachrichtigung oder eine E-Mail. Das reicht völlig, wenn du ab und zu ein Paar Sneaker für dich selbst kaufst. Wenn du aber Wiederverkauf betreibst – oder auch nur ein Dutzend Suchen über mehrere Märkte verfolgst –, willst du wahrscheinlich etwas, das direkt in das System fließt, das du ohnehin nutzt.

Genau das machen Webhooks. Statt dass du nach Alarmen schaust, kommt der Alarm zu deinem Code.

Was ist eigentlich ein Webhook?

Ein Webhook ist eine HTTP-Anfrage, die ein Server jedes Mal an deine URL schickt, wenn etwas passiert. Bei Vinotify ist dieses „Etwas“: Neue Artikel passen zu einem deiner Suchalarme.

Findet das Überwachungssystem neue Vinted-Angebote, die zu den Filtern deiner Suche passen, schickt es eine POST-Anfrage an die URL, die du eingerichtet hast. Der Body ist JSON und enthält den Namen der Suche sowie Titel, Marken, Preise, Zustände, Größen, Vinted-Links und Foto-URLs der Artikel – alles, was du in der E-Mail oder Push-Benachrichtigung sehen würdest, aber in einem Format, das eine Maschine lesen kann.

Hier ein vereinfachtes Beispiel, wie der Payload aussieht:

{
  "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://..."
    }
  ]
}

Mit den Daten kannst du anfangen, was du willst, sobald sie ankommen: protokollieren, weiterleiten, filtern, darauf reagieren.

So funktioniert es in Vinotify

Webhooks gehören zum Pro-Plan. Wenn du mit Pro einen Suchalarm erstellst, erzeugt Vinotify für diese Suche ein eigenes Webhook-Secret. Dann kannst du:

  1. Den neuesten Payload abfragen — Ein eigener GET-Endpunkt liefert die aktuellsten Webhook-Daten für deine Suche, per Secret authentifiziert. Ein JWT ist nicht nötig, deshalb lässt er sich leicht aus einem Cronjob oder einem Google Apps Script aufrufen.
  2. Eine externe URL festlegen — Richte Vinotify auf deinen eigenen HTTPS-Endpunkt (einen Zapier-Webhook, die URL einer AWS-Lambda-Funktion, ein Make.com-Szenario, einen selbst gehosteten Server – alles geht). Vinotify schickt dort per POST die passenden Artikel hin, sobald neue erscheinen.

Beide Optionen sind über die API verfügbar. Dein Webhook-Secret findest du in den Sucheinstellungen, dort richtest du auch die externe URL ein.

Praxis-Setups, die wirklich funktionieren

Zu wissen, dass es Webhooks gibt, ist eine Sache. Zu wissen, was man damit anfängt, eine andere. Hier sind ein paar Setups, die Vinotify-Pro-Nutzer gebaut haben:

1. Bestandsliste in Google Sheets

Veröffentliche ein kostenloses Google Apps Script, das POST-Anfragen annimmt und jeden Artikel an eine Tabelle anhängt. Spalten für Titel, Marke, Preis, Zustand und URL. So bekommst du ein fortlaufendes Protokoll aller Artikel, die deine Alarme finden – sortierbar und durchsuchbar, ganz ohne kostenpflichtige Tools.

Das ist wahrscheinlich der einfachste Einstieg. Du schreibst etwa 20 Zeilen JavaScript in Apps Script, veröffentlichst es als Web-App und fügst die URL in Vinotify ein.

2. Telegram- oder Discord-Bot

Wenn du Alarme lieber in einem Gruppenchat bekommst – statt oder zusätzlich zu Push und E-Mail –, richte ein kleines Relay ein. Es empfängt den Webhook, macht daraus eine Nachricht mit dem Artikelfoto und einem „Jetzt kaufen“-Link und postet sie in einen Telegram-Kanal über die Bot-API oder in einen Discord-Kanal über dessen Webhook-URL. Eine einzige Serverless-Funktion übernimmt das.

3. Filter für Preissenkungen

Angenommen, du verfolgst eine breite Suche – „North Face Nuptse“ in allen Größen. Das kann 15 neue Angebote am Tag bringen, aber dich interessiert es erst, wenn eines unter €80 landet. Dein Webhook-Empfänger prüft das Preisfeld und leitet nur Artikel unter deiner Schwelle weiter. Der Rest wird still protokolliert.

4. Dashboard für mehrere Märkte

Pro unterstützt Suchen über mehrere Märkte (FR, DE, IT, UK usw. mit einem einzigen Alarm). Die Webhook-Payloads enthalten den Namen der Suche und die Artikel-URLs, in denen die Domain des Marktes steckt. Ein schlankes Dashboard, das die Webhook-Zustellungen mehrerer Suchen sammelt, gibt dir eine gemeinsame Sicht auf alle Märkte und Kategorien – praktisch, wenn du Ware in großem Stil einkaufst.

Webhooks als „sicherer Autocop“ nutzen

Manche Wiederverkäufer wollen die Geschwindigkeit von Autocop-Tools, aber ohne das Risiko, Zugangsdaten herauszugeben oder gesperrt zu werden. Mit Webhooks geht das:

  1. Richte an deiner Pro-Suche einen Webhook ein, der auf ein kleines Skript oder eine Serverless-Funktion zeigt.
  2. Passen neue Artikel, bekommt dein Skript die Daten sofort – einschließlich der direkten Vinted-URL jedes Artikels.
  3. Deine Automatisierung schickt dir eine sofortige Benachrichtigung (Telegram, SMS, Desktop-Popup) mit dem Artikel-Link, bereit zum Öffnen.
  4. Du tippst auf den Link und kaufst von Hand – mit einem normalen Konto, in normaler menschlicher Geschwindigkeit.

So erfährst du fast sofort von neuen Angeboten, ohne dass ein Bot dein Vinted-Konto anfasst. Keine Zugangsdaten weitergegeben, kein Sperrrisiko und viel günstiger als spezielle Autocop-Abos.

Mehr dazu: Vinted-Autocop-Tools vs. Webhooks: Warum Alarme Auto-Käufer schlagen →

Abfragen oder Push: Was passt besser?

Vinotify bietet beides. Verträgt dein Anwendungsfall eine kleine Verzögerung (Stapelverarbeitung, Tabellen, Auswertungen), ist es einfacher, den GET-Endpunkt nach Zeitplan abzufragen – du brauchst keinen Server und kannst es über eine Browser-Erweiterung, eine GitHub Action oder eine Crontab erledigen.

Willst du die Lieferung in Echtzeit, sobald Artikel passen, lege eine externe URL fest und lass Vinotify zu dir pushen. Das ist besser für Bots, Live-Dashboards und alles, wo 30 Sekunden Vorsprung zählen.

Ein paar Dinge, die du beachten solltest

  • Behandle dein Webhook-Secret wie ein Passwort. Wer es hat, kann deine Suchergebnisse lesen. Lade es nicht in ein öffentliches Repository hoch.
  • Externe URLs müssen HTTPS verwenden (oder HTTP für die lokale Entwicklung). Vinotify liefert nicht an Nicht-HTTP-Schemata aus.
  • Payloads sind auf 50 Artikel begrenzt pro Zustellung. Findet eine einzelne Prüfung mehr Treffer, enthält der Payload die ersten 50. So bleiben die Anfragen für nachgelagerte Dienste in einer vernünftigen Größe.
  • Die Zustellung erfolgt nach bestem Bemühen. Ist dein Endpunkt nicht erreichbar oder antwortet mit einem Fehler, bleibt der Payload trotzdem 24 Stunden lang zwischengespeichert und über den Abfrage-Endpunkt abrufbar. Eine automatische Warteschlange für Wiederholungen gibt es nicht – halte deinen Empfänger zuverlässig oder nutze den Abfrage-Endpunkt als Fallback.

Los geht’s

Bist du schon im Pro-Plan, hat jede Suche, die du erstellst, ein Webhook-Secret. Öffne die Sucheinstellungen, hol dir das Secret und frage entweder den Endpunkt für den neuesten Payload ab oder lege eine externe URL fest.

Bist du bei Free, Plus oder Premium, sind Webhooks nicht enthalten – aber Push-Benachrichtigungen und E-Mail decken die meisten privaten Anwendungsfälle gut ab. Webhooks lohnen sich, wenn du mit den Daten etwas Programmatisches machen willst, statt sie nur anzusehen.

Alarm erstellen →

Häufige Fragen

Wie lege ich in Vinotify eine Webhook-URL fest?
Jede Pro-Suche hat ihr eigenes Webhook-Secret. Das Ziel, das die Zustellungen empfängt, legst du mit PUT /api/v1/searches/{search_id}/webhook/external-url fest und schickst die URL im Body mit. Sende einen leeren String, um die Zustellung zu stoppen. Das Ziel muss ein öffentlicher HTTPS-Endpunkt sein.
Wie sieht der Webhook-Payload aus?
Vinotify schickt per POST einen JSON-Body, in dem event auf new_items steht, dazu search_id, search_name, item_count und ein items-Array mit den passenden Angeboten.
Werden fehlgeschlagene Webhook-Zustellungen wiederholt?
Nein. Die Push-Zustellung erfolgt nach bestem Bemühen, und es gibt keine Warteschlange für Wiederholungen. Antworte also schnell und lege die Arbeit auf deiner Seite in eine Warteschlange. War dein Endpunkt nicht erreichbar, bleibt der letzte Payload 24 Stunden lang unter /api/v1/searches/{search_id}/webhook/latest abrufbar, und der Ereignis-Feed hält 48 Stunden Verlauf hinter einem Cursor bereit.
Kann ich den Webhook direkt auf einen Discord-Kanal richten?
Nicht direkt. Der Vinotify-Payload hat nicht das Format der eingehenden Webhooks von Discord, deshalb muss ein kleiner Bot oder eine Brücke ihn umwandeln, bevor er gepostet wird.
Welcher Plan enthält Webhooks?
Webhooks sind eine Funktion des Pro-Plans.