n8n-Polling-Workflow für lokale Leads

Verwenden Sie HTTP-Request-Knoten mit der bestehenden Kunden-API, um eine Suche zu erstellen, auf den Abschluss zu warten und die vollständige CSV herunterzuladen. Es ist kein natives n8n-Plugin und kein Webhook erforderlich.

OwnerClue · Aktualisiert

Workflow herunterladen und konfigurieren

Laden Sie die n8n-JSON-Vorlage herunter und importieren Sie sie in Ihre n8n-Instanz. Es handelt sich um ein Polling-Rezept für die aktuelle API, nicht um eine native OwnerClue-Integration. Die JSON-Datei wurde lokal geprüft; sie wurde nicht gegen eine kostenpflichtige Produktionsaufgabe in einem n8n-Konto ausgeführt.

  1. Erstellen Sie einen OwnerClue-Schlüssel mit leads:read und leads:write.
  2. Erstellen Sie in n8n eine Header-Auth-Anmeldedaten mit einem Namen Ihrer Wahl, mit dem Header Authorization und dem Wert Bearer plus Ihrem Schlüssel. Wählen Sie sie bei Create search, Read status und Download CSV aus.
  3. Legen Sie in Configure apiBase, keyword und einen echten locationCode aus dem Standort-Endpunkt fest. Die Vorlage verwendet 0 als bewussten Platzhalter.
  4. Belassen Sie depth bei 20 oder niedriger, wenn Sie nur die Testversion mit 20 Credits nutzen und keine andere Arbeit sie verbraucht hat.
  5. Führen Sie den Workflow manuell aus. Die CSV erscheint nach Abschluss als Binärdaten bei Download CSV.

Die offizielle n8n-Dokumentation zu HTTP Request erläutert die Auswahl von Anmeldedaten und Antwortformate.

Polling- und Wiederholungsverhalten

Create search sendet einen Idempotenzschlüssel pro Ausführung und speichert data.id. Wait verzögert jede Abfrage um fünf Sekunden. Read status verwendet diese ursprüngliche ID. Completed führt zum CSV-Download; failed, paused, cancelled oder stopped stoppt zur Prüfung; andere Zustände warten erneut. Der Workflow hat ein Ausführungs-Timeout von 30 Minuten, um das Warten zu begrenzen. HTTP-Fehler stoppen den Lauf; prüfen Sie die Antwort und wiederholen Sie erst nach Behebung der Ursache.

Wenn die Erstellung 202 zurückgegeben hat, Sie aber die Antwort verloren haben, wiederholen Sie das unveränderte POST mit demselben Idempotenzschlüssel. Starten Sie nicht einfach eine neue n8n-Ausführung mit einem neuen Schlüssel, nur um eine bestehende Aufgabe abzurufen: Speichern Sie die ID und fragen Sie diese Aufgabe ab.

Paginierung der Ergebnisse, falls Sie JSON benötigen

Der Download-Zweig fordert die vollständige CSV an und lässt den bestehenden Export-Stream alle Zeilen liefern. Um stattdessen JSON zu verwenden, rufen Sie GET /searches/{id}/results?limit=100 auf, speichern Sie data.items und wiederholen Sie den Aufruf mit data.nextCursor, bis dieser null ist. Halten Sie limit konstant und lesen Sie nach Abschluss. Behandeln Sie nicht nur die erste Seite als vollständige Liste.

Verwenden Sie dieselbe Form für /campaigns/{id} oder /enrichments/{id} und ändern Sie den Create-Body und die Endpunkte entsprechend. Die Anreicherungs-Eingabe bleibt bei höchstens 1,000 Zeilen pro API-Aufgabe. Diese Vorlage fügt keine CRM-Synchronisierung, keine Mailbox-Validierung und keinen Abschluss-Webhook hinzu.