如何用自己的 API Key 搭建自定义 Waterfall Email Finder

Florian Poullin
Florian Poullin
6 分钟读完
用自己的 API Key 搭建 Email Waterfall
如何用自己的 API Key 搭建自定义 Waterfall Email Finder
目录
  1. 快速导航
  2. 自定义 Waterfall Email Finder 的工作原理
  3. Lead CSV 示例
  4. 准备服务商 API Key
  5. 在 Datablist 中配置 Custom Waterfall
    1. 第 1 步:导入 Lead List
    2. 第 2 步:打开 Waterfall Email Finder
    3. 第 3 步:启用 Custom Waterfall 并添加服务商
  6. 映射输入列与输出列
    1. 第 4 步:映射输入列
    2. 第 5 步:创建输出列
  7. 运行预览并检查结果
    1. 第 6 步:处理完整名单前先运行预览
    2. 第 7 步:对所有记录运行 Custom Waterfall
  8. 检查结果并清理失败记录
  9. 导出名单或继续补充数据
  10. 何时选择 Custom Waterfall 而非默认 Waterfall
  11. 常见使用方式
    1. 只有完整姓名的 Lead 文件
    2. 域名优先的名单
    3. 只有公司名称的名单
    4. 以 LinkedIn 为主的名单
    5. Agency 工作流
  12. FAQ

自定义 Waterfall Email Finder 可让你按照自己设定的顺序调用多个 Email Finder 服务商,并使用你自己的服务商 API Key。我通常会在标准托管式 waterfall 无法满足核心需求时采用这种配置。这里真正重要的是控制权:哪个服务商优先运行、外部服务商的 credits 如何消耗,以及有多少工作可以在同一个 Lead List 工作区内完成。

在 Datablist 中,整个流程非常直接:导入 Lead List,打开 Waterfall Email Finder,将搜索方式保持为 By Name and Company,启用 Custom Waterfall,添加服务商及 API Key,映射输入列并创建输出列,然后先运行预览,再处理整份名单。自定义任务运行期间,Datablist 还会处理可重试的服务商限流响应,因此临时限流不会立即导致该行处理失败。

这里需要特别区分费用:使用有效的自定义 API Key 运行任务时,Datablist 不会扣除 Datablist credits。但你仍需根据各服务商的套餐和 API 规则,通过自己的账户向外部服务商付费。因此,服务商的排列顺序非常重要。

快速导航

自定义 Waterfall Email Finder 的工作原理

Waterfall 会依次查询多个数据服务商。对于每条 Lead,系统先查询第一个服务商。如果对方返回可用的邮箱,该行的查询就会停止;如果没有找到邮箱,系统则继续调用下一个服务商。这个过程会持续到找到邮箱,或所有服务商都已查询完毕。

这正是 waterfall enrichment 的核心思路:当其他数据源可能更完整地覆盖同一联系人时,不要只依赖单一数据源。

自定义 waterfall 在此基础上提供了更多控制权。你不再使用平台托管的服务商顺序,而是自行选择服务商,并通过自己的 API Key 完成身份验证。Datablist 负责逐行执行、输入映射、输出列和任务状态;服务商顺序则由你决定。

在 Datablist 中,将 Waterfall Email Finder 的搜索方式设为 By Name and Company,即可使用自定义服务商序列。目前支持的服务商包括 Icypeas、Enrow、Prospeo、Wiza、Findymail、LeadMagic、TryKitt、Enrich.so 和 FullEnrich。

Datablist 默认 waterfall 更简单:服务商顺序由 Datablist 管理,每找到一个工作邮箱收取 25 个 Datablist credits。如果你不想管理多个服务商账户,这通常是更合适的选择。

如果你已经订阅了某些服务商、还有尚未使用的外部 credits,或有充分理由测试自己的调用顺序,那么 Custom Waterfall 更合适。如果你仍在比较托管式与自定义工作流,可以阅读这份更全面的批量查找邮箱指南。

🔑 关键选择

如果服务商顺序和外部成本控制比全托管流程更重要,请使用 Custom Waterfall。

Lead CSV 示例

本教程将使用一份 Lead 导出样本。人物姓名和返回的邮箱仅用于示范工作流程,并不代表这些人物确实就职于表中所列公司。

文件包含以下列:

名字姓氏公司域名公司名称LinkedIn 个人资料 URL职位Lead 来源市场
JaneMartincalendly.comCalendly销售副总裁Webinar 名单北美
MarkLewisalgolia.comAlgolia增长负责人目录调研欧洲
AnaSantosQonto运营负责人活动名单欧洲
TomWeberqonto.comQonto创始人合作伙伴名单欧洲

Email Finder 的必填输入包括 First Name 和 Last Name,也可以使用一个 Full Name 字段;此外,还需要一个公司信息字段,其中可填写域名或公司名称。如果有域名,我通常会优先使用,因为域名可以消除公司名称歧义。

当映射值为公司名称时,Datablist 会先在内部尝试解析并验证域名,然后再调用自定义服务商。该查询属于 Email Finder 流程的一部分,无需单独运行 Company Name to Domain。若数据中包含标准 LinkedIn 个人资料 URL,LinkedIn Profile URL 也能提供帮助;不过,本教程中的自定义序列基于 By Name and Company 方法。

其他列不会映射到 Email Finder,但我仍会保留它们。Job Title、Lead Source 和 Market 有助于 enrichment 后审核名单,并在后续导出时进行细分。

💡 实用建议

保留原始来源列。当公司名称、域名、来源和市场仍显示在 enrichment 结果旁边时,排查失败记录会容易得多。

准备服务商 API Key

打开 enrichment 前,请先准备好以下三项:

  • 一个包含 Lead 数据的 Datablist collection。
  • 你计划使用的 Email Finder 服务商有效账户。
  • 从这些服务商账户中复制的 API Key。

我通常不会默认按照“最便宜的服务商优先”排序。我会先选择在目标市场中成本、覆盖率和输出质量最均衡的服务商。覆盖率较弱的低价服务商未必适合排在首位,尤其是当它为目标账户返回大量低置信度结果,或很少能找到邮箱时。

可以先从以下顺序开始:

位置服务商角色这样排序的原因
1低成本或已付费的服务商先使用已有 credits,再调用付费 fallback
2在目标市场表现较强的服务商第一次查询未命中后,提高整体覆盖率
3成本较高的 fallback 服务商仅对较难匹配的记录使用高成本查询

完整配置包括服务商顺序、输入映射和输出映射。

⚠️ 成本提醒

使用有效的自定义 API Key 运行任务时不会扣除 Datablist credits,但每个外部服务商仍可能通过自己的账户、API 定价或 credits 系统收费。

在 Datablist 中配置 Custom Waterfall

第 1 步:导入 Lead List

新建一个 Datablist collection,或打开现有 collection,然后导入 CSV 或 Excel 文件。导入完成后,请在运行 enrichment 前检查系统解析出的各列。

我通常会检查三点:

  • 姓名已拆分为 First Name 和 Last Name,或者文件中有一个干净的完整姓名列。
  • 公司信息以域名、网站或公司名称的形式存在。
  • 职位、来源和市场等附加字段仍保留在 collection 中。

导入看似只是一个普通步骤,却会直接影响后续流程的数据质量。如果 Lead 来源中混有格式不一的公司名称、缺失域名,或 LinkedIn URL 被粘贴到了错误的列,请先修复这些明显问题。

已导入 Datablist、可以开始 enrichment 的 Lead List
已导入 Datablist、可以开始 enrichment 的 Lead List

Datablist 会将文件保存在类似电子表格的 collection 中,因此你可以直接筛选、enrich、清理和导出数据,无需在不同工具之间反复迁移。

第 2 步:打开 Waterfall Email Finder

打开 enrichment 面板并选择 Waterfall Email Finder。

在 Datablist enrichment 库中选择 Waterfall Email Finder
在 Datablist enrichment 库中选择 Waterfall Email Finder

在本工作流中,将 Email Search Method 保持为 By Name and Company (default)。Custom Waterfall 就是在该方法下配置的,它需要人物姓名和公司信息。

Datablist 还提供 By LinkedIn URL 方法,适合以标准 LinkedIn 个人资料 URL 为核心的名单。这适用于另一类工作流;除非你的输入符合该方法,否则不建议将其用于本教程的自定义服务商序列。此 enrichment 不支持 Sales Navigator 个人资料 URL,因此不能把它们直接当作标准 LinkedIn 个人资料 URL 使用。

如果你仍在比较不同的查询方式,可以参考这份查找某人邮箱的方法指南,了解 waterfall、单一服务商查询和人工查找分别适用于哪些情况。

第 3 步:启用 Custom Waterfall 并添加服务商

在 enrichment 设置中,将搜索方式保持为 By Name and Company (default)。

然后选择姓名格式:

  • 如果文件包含 First Name 和 Last Name,请保持 Use Full Name 关闭。
  • 如果文件只有一个姓名列,请启用 Use Full Name,稍后再映射该列。

接下来启用 Custom Waterfall。Datablist 将显示 Waterfall Sequence 区域。每个服务商添加一行,然后在各行中选择服务商,并粘贴对应账户的 API Key。

系统会逐行执行该序列。如果服务商 1 找到邮箱,这一行就会停止查询;如果服务商 1 没有找到,Datablist 会继续尝试服务商 2。如果所有服务商都没有返回邮箱,该行会得到 not_found 结果。

在自定义模式下,服务商配置问题会明确显示,便于你及时修正。API Key 错误、服务商配额问题和账户权限问题都应该得到解决,而不是隐藏在托管式 fallback 后面。

我建议先采用类似这样的顺序:

顺序服务商选择原因
1已包含在现有套餐中的服务商优先使用已有的外部 credits
2在目标市场覆盖率较好的服务商在第一个服务商未命中时提高匹配率
3用于较难联系人查询的 fallback 服务商将成本较高的查询放到流程后段

这里刻意使用了通用描述,因为最佳顺序取决于你的服务商账户、目标市场和邮箱质量要求。

在 Datablist 中启用 Custom Waterfall 并配置服务商序列
在 Datablist 中启用 Custom Waterfall 并配置服务商序列

📘 序列示例

先使用较短的序列并运行预览,只有当额外覆盖率值得相应的外部成本时,再增加更多服务商。

映射输入列与输出列

第 4 步:映射输入列

现在,将来源列映射到 enrichment 输入字段。

对于示例 Lead 文件,我会这样映射:

Datablist 输入字段来源列
First NameFirst Name
Last NameLast Name
Company Name or DomainCompany Domain、Company Name,或一个合并后的公司输入列
LinkedIn Profile如有,则使用 LinkedIn Profile URL

如果启用了 Use Full Name,请将单一姓名列映射到 Full Name,无需分别映射名字和姓氏。

一个输入字段只能映射一个来源列。如果文件将域名和公司名称分别保存在不同列中,请映射覆盖率更高的那一列,或提前创建一个统一的公司输入列:有域名时填域名,否则填公司名称。映射公司名称时,Datablist 会在调用服务商序列前尝试在内部解析域名。不过,含义模糊的名称仍可能与子公司、旧名称或同名公司混淆。

不要在运行前删除缺少数据的行。我更倾向于保留它们,先运行 enrichment,再根据结果状态定位问题。缺少姓名或公司数据的行可能返回 missing_source_data;输入格式错误的行则可能返回 invalid_data。

这些状态非常实用:它们能直接生成一份待清理队列,无需你猜测哪些行处理失败。

为 Waterfall Email Finder enrichment 映射输入列
为 Waterfall Email Finder enrichment 映射输入列

第 5 步:创建输出列

在 collection 中添加输出列。如果已经存在相似列,也可以直接映射到现有列。

可用输出如下:

输出列数据类型含义
Found Work EmailEmail返回的工作邮箱;未找到结果时留空
Email StatusTextverified、unverified、not_found、missing_source_data 或 invalid_data
MX ProviderText该邮箱域名背后的邮箱服务商
Finder ProviderText返回结果的自定义服务商

自定义任务完成后,我会最先检查 Finder Provider 列。它会告诉你具体由哪个服务商找到了结果。没有这一列,你虽然能看到邮箱,却无法评估服务商序列的实际表现。

MX Provider 的含义不同。它显示的是该邮箱背后的邮件服务商,例如 Google、Microsoft、Mimecast、Proofpoint 或其他服务商。

为 Waterfall Email Finder 结果选择输出属性
为 Waterfall Email Finder 结果选择输出属性

运行预览并检查结果

第 6 步:处理完整名单前先运行预览

在处理整个 collection 前,先对一小批数据运行 enrichment。即使我确信 API Key 没有问题,也仍会这样做。预览可以在错误映射和服务商配置问题影响完整名单前发现它们。

检查预览时重点关注以下五项:

  • API Key 已被接受。
  • 找到邮箱时,Finder Provider 中会显示服务商。
  • Email Status 的结果符合预期。
  • 缺少字段时返回 missing_source_data,而不是令人困惑的空白。
  • 第一个服务商没有返回过多低质量的 unverified 结果。

到这一步,服务商顺序的效果会变得很直观。如果服务商 1 返回大量未经验证的邮箱,而服务商 2 虽然数量较少,却能返回更干净的 verified 邮箱,就可以考虑调整两者顺序,或扩大测试样本。

Waterfall Email Finder 正在处理 Datablist 中选中的记录
Waterfall Email Finder 正在处理 Datablist 中选中的记录

🔍 快速检查方法

按 Email Status 和 Finder Provider 筛选预览结果。这是判断第一个服务商是否值得排在首位的最快方法。

第 7 步:对所有记录运行 Custom Waterfall

确认预览结果无误后,选择需要处理的记录,并对完整名单运行 enrichment。

Datablist 会针对每一行按照你配置的序列执行查询。成功的记录会获得邮箱和状态;所有服务商都未命中的记录会得到 not_found;缺少姓名或公司输入时会得到数据缺失状态;输入格式不正确时则可能被标记为无效。

Datablist 还会在自定义任务中处理可重试的服务商限流。如果服务商暂时降低处理速度或返回限流响应,Datablist 可以重试,而不是立即将该行标记为服务商调用失败。使用自己的 API Key 处理大型名单时,这一点非常重要,因为外部服务商通常会先限制请求速率,而不是直接彻底拒绝请求。

这并不会取消服务商本身的限制。你仍然需要有效的 API Key、处于正常状态的服务商账户,以及足够的外部 credits 或配额。优势在于,Datablist 能在同一个 collection 中统一处理任务编排、可重试的限流响应、结果输出和审核状态。

检查结果并清理失败记录

任务完成后,collection 中应同时包含原始 Lead 字段和 Email Finder 输出。

以下是一张示例结果表:

名字姓氏公司域名找到的工作邮箱邮箱状态Finder 服务商
JaneMartincalendly.comjane.martin@calendly.comverifiedEnrow
MarkLewisalgolia.commark.lewis@algolia.comunverifiedFindymail
AnaSantosmissing_source_data
TomWeberqonto.comnot_found

表中的姓名和邮箱地址仅供示范。请通过这些示例了解输出格式,不要将它们视为真实联系信息。

我通常会将结果分为四组检查:

  • verified:可以保留用于 Outbound,但仍需执行常规的 Campaign 检查。
  • unverified:发送前进行审核,尤其是在意退信风险时。
  • missing_source_data 或 invalid_data:修复来源字段,然后重新处理这些行。
  • not_found:决定是否改用其他服务商序列、进行人工调研,或保持邮箱为空。

Finder Provider 列也有助于分析成本。可以将其与各服务商账户中的用量进行比较。如果大多数邮箱都由服务商 3 找到,服务商 1 可能没有提供足够价值。如果服务商 1 为大多数记录找到了高质量邮箱,那么 fallback 服务商可能正好发挥了预期作用:只处理更难匹配的数据。

不要只根据找到的邮箱数量评估序列,还要检查状态质量、退信风险和外部成本。某个服务商即使返回大量 unverified 邮箱,在电子表格中看起来表现不错,后续却仍可能给 Outbound 带来问题。

导出名单或继续补充数据

确认结果干净后,将 enriched 名单导出为 CSV 或 Excel。

导出前,你也可以继续在 Datablist 中处理数据:

  • 筛选 verified Lead。
  • 对联系人去重。
  • 为公司补充更多 firmographic 字段。
  • 按 Market、Lead Source 或 Job Title 细分。
  • 准备 CRM 导入文件。

这正是我喜欢将整个工作流保留在 collection 中的原因。查找邮箱通常只是 Lead 数据准备流程中的一个环节。在将名单发送至 CRM 或 Outbound 工具前,你可能还需要清理域名、删除重复项、统一职位名称或补充公司数据。

如需了解相关工作流,请参阅这些批量数据 enrichment 方法。

何时选择 Custom Waterfall 而非默认 Waterfall

如果你更看重控制权,请使用 Custom Waterfall。

它尤其适合以下情况:

  • 你已经在为一个或多个 Email Finder 工具付费。
  • 你还有未使用的外部服务商 credits。
  • 你希望按市场或 Lead 来源测试服务商顺序。
  • 特定服务商更适合你的 ICP。
  • 相比托管式配置,你更关注每个有效邮箱的成本。
  • 你希望 Datablist 负责服务商排序和可重试的限流响应,同时自己掌控 API Key。

如果你希望减少配置工作,请使用 Datablist 默认 waterfall。如果不想管理服务商账户、API Key、外部配额和服务商账单,托管模式会更简单。Datablist 会管理服务商顺序,并对每个找到的工作邮箱收取 25 个 Datablist credits。

两种方式并不存在绝对的优劣。如果追求快速上线,我会选择默认模式;如果需要进行成本测试、利用现有服务商订阅,或希望更精细地控制调用顺序,我会选择自定义模式。

常见使用方式

只有完整姓名的 Lead 文件

有些导出文件只有一个 Full Name 列,没有分别保存名字和姓氏。此时,请在 Email Finder 设置中启用 Use Full Name,并映射完整姓名列。

条件允许时,我仍然更喜欢拆分后的姓名字段,但不会仅仅因为文件只有一个姓名列就中断整个流程。

域名优先的名单

如果名单中有域名,请直接使用。将 Company Domain 映射到 Company Name or Domain,同时保留 Company Name 作为上下文信息。

对于大多数 B2B Lead List,这是最干净的配置,因为域名能减少歧义。

只有公司名称的名单

如果名单中有人名和公司名称,但没有域名,请将 Company Name 映射到 Company Name or Domain。Datablist 会查询其公司数据集、验证候选网站,并将通过验证的域名传递给自定义 waterfall。如果解析器无法安全地确定域名,兼容的服务商仍可收到原始公司名称。

除非你还希望将解析后的域名作为输出列,否则无需提前运行 Company Name to Domain。

以 LinkedIn 为主的名单

如果文件包含标准 LinkedIn 个人资料 URL,可以在本工作流中将其映射为可选上下文。

如果 LinkedIn 个人资料 URL 是你唯一可靠的输入,请考虑使用 Email Finder 中单独的 By LinkedIn URL 方法。本文介绍的自定义服务商序列需要通过 By Name and Company 方法配置。

Agency 工作流

处理 Agency 项目时,我会按 collection 或来源字段分别管理各客户的名单。在大范围应用前,先针对每个市场测试服务商序列。

适合美国 SaaS 创始人的序列,面对法国零售企业或德国工业客户时,未必会有同样表现。

常见问题排查

missing_source_data

检查该行是否包含可用的姓名和公司输入。使用默认方法时,Datablist 需要名字和姓氏;如果启用了 Use Full Name,则可使用完整姓名。此外,还必须提供公司名称或域名。

invalid_data

检查域名、网站、姓名或 LinkedIn URL 是否格式错误。这种问题常见于混乱的导出文件,例如网站列中混有备注、追踪链接或空值占位符。

not_found

序列中的所有服务商都未能为该行返回邮箱。你可以修正输入、测试其他序列,或让邮箱保持为空。不要假设每个联系人都有可被查找到的工作邮箱。

服务商或 API Key 错误

Datablist 会在自定义任务中重试可重试的限流响应,但持续出现的服务商错误仍需人工处理。请在外部服务商账户中检查 API Key、账户状态、API 权限、每日配额和账单状态。

unverified 结果过多

检查服务商顺序。如果第一个服务商返回大量 unverified 邮箱,可以尝试将它后移,或测试其他首选服务商。相比一份规模更大但送达风险很高的名单,我更愿意获得数量较少但真正可用的邮箱。

总结

如果你希望 Datablist 负责服务商调用顺序、可重试的限流处理和结果审核,同时自己掌控 API Key,自定义 Waterfall Email Finder 会非常实用。

实际流程很简单:导入 Lead List,启用 Custom Waterfall,添加服务商和 API Key,映射输入与输出,运行预览,处理完整名单,审核状态,最后导出或继续 enrichment。

先从小规模开始。使用两到三个服务商测试一小批数据,并对比 Email Status 和 Finder Provider,再决定是否为完整名单消耗外部服务商 credits。

FAQ

什么是自定义 Waterfall Email Finder?

自定义 Waterfall Email Finder 是一种多服务商邮箱查询方式:你可以自行设置服务商顺序,并使用自己的 API Key 对各服务商进行身份验证。系统会按顺序为每条记录查询这些服务商,直到找到邮箱或整个序列执行完毕。

能否在 Datablist 中使用自己的 Email Finder API Key?

可以。在 Datablist 的 Waterfall Email Finder 中使用 By Name and Company 方法,并启用 Custom Waterfall。然后添加服务商行,并粘贴各服务商的 API Key。

使用 Custom Waterfall 会扣除 Datablist credits 吗?

使用有效的自定义 API Key 运行任务时,Datablist 不会扣除 Datablist credits。但外部 Email Finder 服务商仍可能根据其账户、套餐、API 定价或 credits 系统收费。

Custom Waterfall 遇到限流时会重试吗?

会。Datablist 会在自定义 waterfall 任务中处理可重试的限流响应,因此服务商的临时限流不会立即导致该行失败。不过,你仍需要有效的服务商账户、可用的 API Key,以及各外部工具中足够的配额。

Custom Waterfall 支持哪些服务商?

目前支持的自定义服务商包括 Icypeas、Enrow、Prospeo、Wiza、Findymail、LeadMagic、TryKitt、Enrich.so 和 FullEnrich。

需要提供哪些输入数据?

使用 By Name and Company 方法时,需要名字和姓氏;如果启用了 Use Full Name,也可以使用一个完整姓名列。此外,还需要一个公司名称或域名字段。域名是更干净的输入,但如果提供的是公司名称,Datablist 也可以在内部解析最可能的域名。如有标准 LinkedIn 个人资料 URL,也可以进行映射。

可以只使用 LinkedIn 个人资料 URL 吗?

Datablist 针对标准 LinkedIn 个人资料 URL 提供了单独的 By LinkedIn URL 方法。本指南介绍的 Custom Waterfall 序列则需要使用 By Name and Company 方法配置。

Provider 输出代表什么?

Provider 输出显示由哪个自定义服务商返回了邮箱结果。我通常会将这个输出列重命名为 Finder Provider,这样在最终 Lead List 中更容易理解。

应该把最便宜的服务商放在第一位吗?

很多时候可以,但并非绝对。你需要综合比较外部成本、覆盖率、结果质量和服务商的计费规则。只有当低价服务商能够返回可信的邮箱时,它才真正有价值。