n8n 本地线索轮询工作流

用 HTTP Request 节点调用现有客户 API，创建搜索、等待完成并下载完整 CSV，使用当前轮询流程。

OwnerClue · 更新于

下载并配置

下载n8n JSON 模板，导入自己的 n8n。它是现有 API 的轮询配方，没有原生 OwnerClue 插件。JSON 已做本地检查，尚未在真实 n8n 账户对付费生产任务运行。

  1. 创建具有 leads:read 和 leads:write 的密钥。
  2. n8n 中创建 Header Auth 凭据，头为 Authorization，值为 Bearer 加密钥；在 Create search、Read status、Download CSV 三个节点选择它。
  3. Configure 中设置 apiBase、keyword 和位置接口返回的真实 locationCode，模板的 0 是占位值。
  4. 只使用初始 20 额度且没有其他扣额时，depth 保持 20 或更低。
  5. 手动运行；完成后 Download CSV 输出二进制文件。

凭据与响应格式参见n8n 官方 HTTP Request 文档。

轮询与重试

Create search 发送每次执行的幂等键并保存 data.id。Wait 每次等待五秒，Read status 使用原 ID。Completed 下载 CSV；failed、paused、cancelled、stopped 停止供检查；其他状态继续等待。执行最多等待 30 分钟。HTTP 错误会停止运行，先排查响应再重试。

如果创建已经返回 202 却丢失响应，用相同幂等键重试原请求。找回已有任务时不要仅为了读取结果就启动生成新键的执行，应保存任务 ID 并继续轮询。

需要 JSON 时怎样分页

下载分支使用现有 full CSV 流式导出全部记录。改为 JSON 时，先 GET /searches/{id}/results?limit=100，保存 data.items，再原样传 data.nextCursor 直到 null。Limit 保持不变，任务完成后读取，第一页不能当作完整名单。

Campaign 和域名任务可使用相同轮询结构，替换路径与创建请求。域名每任务仍最多 100 行。模板没有新增 CRM 同步、邮箱验证或完成回调。