Workflow d'interrogation n8n pour les prospects locaux

Utilisez des nœuds HTTP Request avec l'API client existante pour créer une recherche, attendre la fin de l'exécution et télécharger le CSV complet. Aucun plugin n8n natif ni webhook n'est nécessaire.

OwnerClue · Mis à jour

Télécharger et configurer le workflow

Téléchargez le modèle JSON n8n et importez-le dans votre instance n8n. Il s'agit d'une recette d'interrogation pour l'API actuelle, et non d'une intégration native OwnerClue. Le JSON a été vérifié localement ; il n'a pas été exécuté sur une tâche de production payante dans un compte n8n.

  1. Créez une clé OwnerClue avec leads:read et leads:write.
  2. Dans n8n, créez un identifiant Header Auth nommé comme vous le souhaitez, avec l'en-tête Authorization et la valeur Bearer suivie de votre clé. Sélectionnez-le sur Create search, Read status et Download CSV.
  3. Dans Configure, définissez apiBase, keyword et un locationCode réel issu de l'endpoint de localisation. Le modèle utilise 0 comme espace réservé intentionnel.
  4. Gardez depth à 20 ou moins si vous utilisez uniquement l'essai de 20 crédits et qu'aucun autre travail ne l'a consommé.
  5. Exécutez manuellement. Le CSV apparaît sous forme de données binaires sur Download CSV une fois l'exécution terminée.

La documentation officielle n8n HTTP Request explique la sélection des identifiants et les formats de réponse.

Comportement d'interrogation et de nouvelle tentative

Create search envoie une clé d'idempotence par exécution et enregistre data.id. Wait retarde chaque interrogation de cinq secondes. Read status utilise cet ID d'origine. Completed passe au téléchargement CSV ; failed, paused, cancelled ou stopped s'arrête pour inspection ; les autres états attendent à nouveau. Le workflow a un délai d'expiration d'exécution de 30 minutes pour borner l'attente. Les échecs HTTP arrêtent l'exécution ; inspectez la réponse et ne réessayez qu'après avoir corrigé la cause.

Si la création a renvoyé 202 mais que vous avez perdu sa réponse, réessayez le POST inchangé avec la même clé d'idempotence. Ne relancez pas une nouvelle exécution n8n avec une nouvelle clé simplement pour récupérer une tâche existante : enregistrez l'ID et interrogez cette tâche à la place.

Pagination des résultats si vous avez besoin de JSON

La branche de téléchargement demande le CSV complet et laisse l'export existant diffuser toutes les lignes. Pour utiliser JSON à la place, faites GET /searches/{id}/results?limit=100, enregistrez data.items, puis répétez avec data.nextCursor jusqu'à ce qu'il soit null. Gardez limit constant et lisez après la fin. Ne considérez pas la première page seule comme la liste complète.

Utilisez la même structure pour /campaigns/{id} ou /enrichments/{id}, en modifiant le corps de création et les endpoints en conséquence. L'entrée d'enrichissement reste limitée à 1,000 lignes au maximum par tâche API. Ce modèle n'ajoute ni synchronisation CRM, ni validation de boîte mail, ni webhook d'achèvement.