如何通过 Snov.io API 丰富您的数据

本指南介绍如何通过 Snov.io API 发送数据以进行丰富并获得有价值的 B2B 数据。

数据丰富的工作原理：

通过 API 请求将您的数据发送给 Snovio。我们会将您的信息与我们的数据库进行匹配或帮您查找。您将会收到丰富的数据回复。

此流程会自动使用最新的销售数据丰富您现有的信息。无论您需要丰富 10 条记录还是 10,000 条记录，API 都能实现可扩展性。

Snov.io 中有哪些数据丰富类型？

• 根据公司名称查找域名
• 根据姓名和域名查找邮箱地址
• 验证邮箱地址状态
• 从领英个人资料链接获取完整的潜在客户数据

根据公司名称查找域名

使用域名丰富功能，通过提供公司的确切官方名称来查找公司的域名（网站）。

运作方式：

1）将公司名称发送到API。

2）回复相应的公司域名。

第 1 步：发送您的数据（提供公司名称）

---

请求的 URL：https://api.snov.io/v2/company-domain-by-name/start

请求类型： POST

---

在“names[]”参数中， 输入您想要接收域名的公司名称

每个请求最多可以扩充 10 家公司。请将每家公司的名称添加到单独的参数中。

要自动接收结果，请在目标 URL 中添加“webhook_url”参数，Snov.io 将向该 URL 发送丰富的数据。

使用 webhook 是可选的。如果您跳过此步骤，则可以使用单独的 API 请求来检索结果。

响应将提供一个“task_hash”：您的请求的唯一标识符。您将需要此 ID 才能通过后续 API 请求获取结果。

第 2 步：获取结果（接收公司域名）

有两种方法可以接收丰富的数据：

1. Webhook：如果您已向上一个请求添加了 webhook，我们会在准备就绪后将结果发送到那里。
2. 单独的 API 请求：使用以下请求。

---

请求类型：GET

网址：https://api.snov.io/v2/company-domain-by-name/result? task_hash={hash_from_1}

---

在“task_hash”参数中，添加您之前发送数据的请求中的唯一ID。

对于您请求的每家公司，Snov.io API 将返回以下数据字段：

• “name”：您提供的原公司名称
• “domain”：公司的域名地址

有关更多详细信息，请参阅我们的 API 文档中的请求和响应示例。

根据姓名和域名查找邮箱地址

使用邮箱查找工具 API，您可以通过提供潜在客户的姓名及其公司的域名来查找经过验证的企业邮箱地址。

运作方式：

1. 将潜在客户的名字、姓氏和公司域名发送到 API。
2. 接收邮箱地址和验证状态。

第 1 步：发送您的数据（提供名称和域名）

---

请求类型： POST

网址： https://api.snov.io/v2/emails-by-domain-by-name/start

---

在“rows”参数中，提供有关潜在客户的信息：名字、姓氏和域名。

对于请求中的每个潜在客户，请包含具有以下字段的数据数组：

在“first_name”和“last_name”字段中，提供潜在客户的名字和姓氏。

在“domain”字段中，提供潜在客户所在公司的域名。

响应将提供一个“task_hash”：您的请求的唯一标识符。在发出后续 API 请求时，您将需要此 ID 来获取结果。

第 2 步：获取结果（接收已验证的邮箱地址）

有两种方法可以获得结果：

1. Webhook：如果您已向上一个请求添加了 webhook，我们将在搜索完成时将结果发送到那里。
2. 单独的 API 请求：

---

请求类型：GET

网址：https://api.snov.io/v2/emails-by-domain-by-name/start /result ?task_hash={hash_from_1}

---

在此请求的“task_hash”参数中，添加您从上一个发送数据的请求中收到的唯一 ID，用于发送数据。

对于您添加到请求中的每个潜在客户，Snov.io 将返回以下数据：

• 邮箱地址
• 验证状态（有效、无效或未知）
• 附加检查的结果可以确认有效性或解释状态未知的原因

有关更多详细信息， 请参阅我们的 API 文档。

验证邮箱状态

使用邮箱地址验证工具 API，您可以检查您的邮箱地址是否有效。我们的验证确认您的邮箱列表不存在送达风险，并且可以用于营销活动。

如何使用：

1. 向 API 提供您想要验证的邮箱地址。
2. 接收他们的邮箱地址验证状态。

第 1 步：发送您的数据（提供邮箱地址以供验证）

---

请求类型： POST

网址： https ://api.snov.io/v2/email-verification/start

---

在“emails[]”参数中，输入您想要检查状态的邮箱地址。

每个请求最多可以检查 10 个邮箱地址。请在单独的参数中添加每个邮箱地址。

要自动接收验证结果，请添加“webhook_url”参数，其中包含 Snov.io 将发送验证结果的目标 URL。Webhook 的使用是可选的。如果您跳过此步骤，则可以通过单独的 API 请求检索结果。

响应将提供一个“task_hash”：您的请求的唯一标识符。在发出后续 API 请求时，您将需要此 ID 来检索结果。

第 2 步：获取结果（接收邮箱状态）

有两种方法可以接收丰富的数据：

1. Webhook：如果您已向上一个请求添加了 webhook，我们会在准备就绪后将结果发送到那里。
2. API 请求：使用以下请求。

---

请求类型： GET

网址： https://api.snov.io/v2/email-verification/result? task_hash={hash_from_1}’

---

在“task_hash”参数中，添加您从上一个发送数据的请求中收到的唯一 ID。

对于您添加的每个邮箱地址，Snov.io 将检查并返回以下三种状态之一：

• valid：该邮箱地址存在，可以接收消息
• not_valid：邮箱不存在或者无法接收消息
• unknown (Unverifiable)：无法 100% 确定地验证邮箱地址，但仍然可能有效。

对于状态为“未知”的邮箱，我们会提供验证过程中确定的详细原因。原因可能包括以下几种：

禁止：高传递风险——无法 100% 确定地验证邮箱地址。

Catchall：发件人信誉风险——邮件服务器使用“catchall 策略”，因此无法确认邮箱是否存在。

连接错误：由于收件人方面的技术问题，退回风险较高。

灰名单：邮件服务器使用灰名单过滤器，使得邮箱地址难以验证。

被所有者隐藏：邮箱所有者或拥有该域名的公司请求将其从 Snov.io 结果中删除。

请参阅 API 文档中丰富字段的完整列表。

从领英个人资料链接获取完整数据

使用领英个人资料丰富功能，通过提供其个人资料的链接来获取有关潜在客户的信息。

运作方式：

1. 向 API 提供领英个人资料 URL。
2. 接收包含职位和其他信息在内的完整的潜在客户详细信息。

第 1 步：发送您的数据（提供领英 URL）

---

请求类型： POST

网址： https://api.snov.io/v2/li-profiles-by-urls/start

---

在“urls[]”参数中，添加您想要接收信息的领英网址。每个请求最多可以添加 10 个网址。每个网址应包含在单独的参数中。

要自动接收结果，请将“webhook_url”参数添加到 Snov.io 将发送丰富数据的目标 URL。Webhook 的使用是可选的。如果您跳过此步骤，则可以通过单独的 API 请求检索结果。

此请求的响应将提供一个“task_hash”：这是您请求的唯一标识符。您在发出后续 API 请求时需要此 ID 来获取结果。

第 2 步：获取结果（接收潜在客户资料信息）

有两种方法可以接收丰富的数据：

1. Webhook：如果您已向上一个请求添加了 webhook，我们会在准备就绪后将结果发送到那里。
2. 单独的 API 请求：使用以下请求。

---

请求类型： GET

网址： https://api.snov.io/v2/li-profiles-by-urls/result ? task_hash={hash_from_1}

---

在“task_hash”参数中，添加您之前“发送数据”请求中的唯一 ID。

对于您为丰富信息而添加的每个领英个人资料链接，Snov.io 将返回其所属潜在客户及其公司的完整数据。

潜在客户数据：

• 全名、名字、姓氏
• 行业
• 国家、所在地城市
• 职称

公司数据：

• 公司名称
• 公司领英网址
• 公司域名
• 行业
• 所在国家及城市

有关更多详细信息，请参阅我们的 API 文档中的请求和响应示例。

数据丰富 API 信用点数计算

在下表中，我们将详细介绍有关在使用丰富请求、邮箱地址查找工具和邮箱地址验证工具 API 时 Snov.io 如何从您的帐户余额中扣除信用点数的详细信息。

丰富	API 请求	信用点数
公司域名	https://api.snov.io/v2/company-domain-by-name/start	每获取一个公司对应的域名地址，Snovio 将收取 1 个点数。
来自 URL 的个人资料信息	https://api.snov.io/v2/li-profiles-by-urls/start	对于 Snovio 提供潜在客户信息的每个 领英个人资料 URL，将收取 1 个点数。
邮箱地址验证	https://api.snov.io/v2/email-verification/start	对于请求中检查的每个邮箱地址，都将收取 1 个点数，无论验证结果如何（无论状态是有效、未知还是无效）。
邮箱地址查找	https://api.snov.io/v2/emails-by-domain-by-name/start	对于请求中每一个我们找到有效（绿色）或未知（黄色）邮箱地址的潜在客户，将收取 1 个点数。 如果邮箱地址为无效（not_valid），则不会扣除点数。