如何使用数据库搜索 API

本指南解释了如何通过数据库搜索 API 查找潜在客户和公司。

数据库搜索 API 方法

• 寻找潜在客户
• 找到潜在客户的邮箱地址
• 搜索公司
• 将潜在客户添加到列表中

数据库搜索 API 是 Snov.io 中可用于自动化工作的多个 API 类别之一。

数据库搜索 API允许您访问应用程序中数据库搜索背后的相同潜在客户和公司数据库。

利用 API 请求查找潜在客户和公司。

查看潜在客户数量是免费的，只有找到已验证邮箱和完整个人资料时才会消耗点数。API 返回的数据与应用中显示的数据相同。

数据库搜索 API 方法

以下是按工作流程阶段划分的 API 方法：

寻找潜在客户

这些方法会使用您的筛选条件搜索 Snov.io 的潜在客户数据库。

开始潜在客户搜索

发送筛选条件以开始潜在客户搜索。您将获得一个任务哈希值，用于在下一步中检索结果。

必填项：
至少一个过滤器。filters

将搜索结果筛选至符合您理想客户画像 (ICP) 的潜在客户。您可以在同一请求中结合使用潜在客户级别和公司级别的筛选条件：

• 潜在客户筛选条件：职位名称、管理层级、部门、技能、地点、姓名
• 公司筛选条件：名称、所在地、行业、规模、收入范围、专长、成立年份

职位名称筛选器能够识别常见变体，因此“CEO”也匹配“首席执行官”。位置筛选器会匹配 Snov.io 的已验证位置列表；如果没有匹配项，API 会返回最多 15 个类似选项，而不是返回空结果。

获取潜在客户搜索结果

检索符合筛选条件的潜在客户。

回复中的每位潜在客户都包含其职位、所在地、行业和公司信息。姓氏和领英个人主页链接会先部分隐藏，直到您开始搜索电子邮箱。

必填项：
task_hash — URL 中来自搜索请求的任务哈希值

搜索结果分页显示，每页最多显示 20 个潜在客户。默认显示第 1 页；您可以更改页码以查看后续页码的结果。总数显示符合您筛选条件的潜在客户和页数。

找到潜在客户的电子邮箱地址

这些方法可以获取潜在客户的电子邮箱地址、完整姓氏和完整的领英网址。

开始电子邮箱搜索

请求获取您找到的潜在客户的隐藏联系方式：使用他们的email_and_hidden_info_reveal获取电子邮箱地址、完整姓氏和完整领英网址的 URL。

必填项：
task_hash — 潜在客户的任务哈希值，位于 URL 中

获取电子邮箱搜索结果

获取潜在客户的电子邮箱地址及其完整个人资料。

回复内容包括潜在客户的全名、领英 URL 和电子邮箱地址及其状态（有效或未知）。

必填项：
task_hash — 来自上一个请求的任务哈希值，位于 URL 中

搜索公司

这些方法会搜索 Snov.io 的公司数据库。在搜索目标公司中的人员之前，请先使用公司搜索功能构建目标公司列表。

开始公司搜索

发送筛选条件以开始公司搜索。

您将获得一个任务哈希值，以便在下一步中检索结果。筛选条件包括公司名称、地点、行业、规模、收入、专长和成立年份。

必填项：
至少一个筛选条件。filters

获取公司搜索结果

检索符合您筛选条件的公司。

回复中的每家公司都包括其域名、所在地、行业、规模、收入范围和标志。

必填项：
task_hash — 搜索请求中的任务哈希值，位于 URL 中

每次独立查询收费 1 个点数，且仅当查询结果至少包含一家公司时才收费。

将潜在客户添加到列表中

找到目标邮箱地址后，使用此方法将这些潜在客户添加到 Snov.io 列表中。然后，像使用通过应用添加的潜在客户一样，发起营销活动。

API的下一步

开展营销活动

针对您找到的潜在客户，构建并启动多渠道营销活动。请参阅营销 API。

数据库搜索 API 信用费用

下表将详细说明当您使用数据库搜索 API 请求时， Snov.io 如何从您的帐户余额中扣除点数。