如何使用域名搜索 API

本文介绍了 Snovio 的域名搜索 API、使用它的一般流程、可用的请求及其参数和响应。

域名搜索（请求公司信息）

域名搜索（获取公司信息）

按域名搜索潜在客户

从域名获取潜在客户

搜索潜在客户的邮箱地址

获取潜在客户的邮箱地址

按域名搜索邮箱

获取域名邮箱

让我们回顾一下域名搜索 API 中可用的端点、它们在整个工作流程中的用途，查看它们的主要参数。

域名搜索（请求公司信息）

请求类型：POST

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

这是一个基本端点，用于向 Snov.io API 发送请求，以使用提供的域名搜索公司信息。

输入参数：

在该请求的“domain”字段中， 输入您要搜索的域名（公司网站）。

响应包含两个关键内容：

•  唯一的“task_hash”，用于标识您的请求。您将在下一个请求中使用它来获取搜索结果。
•  用于检索搜索结果（获取公司信息）的直接 URL（在“result”字段中）。

域名搜索（获取公司信息）

请求类型：GET

请求的 URL： https://api.snov.io/v2/domain-search/result/{task_hash}

使用此请求来检索上一个请求生成的搜索结果。

输入参数：此请求不需要任何参数。将“task_hash”添加到 URL 或使用上一个响应中提供的直接链接。

该请求的响应包含：

• 公司详细信息（位置、网站、名称、总部电话号码、行业、规模等）。
• 按类型（潜在客户、域名邮箱、通用联系人）划分的联系人数。

按域名搜索潜在客户

请求类型：POST

请求的 URL： https://api.snov.io/v2/domain-search/prospects/start? domain=

使用此端点向 Snov.io API 发送请求，以在提供的域名上搜索潜在客户资料。

输入参数：

在该请求的“domain”字段中， 输入您要搜索的域名（公司网站）。

使用“page”参数来指定您想要在哪一页的结果中搜索潜在客户。

API 结果分页：默认情况下，任何没有“page”参数的请求都会自动搜索第一页结果。要搜索其他页面，请在请求的参数中指定其编号。

响应包含两个关键内容：

• 一个唯一的“task_hash”，用于标识您的请求。您将在下一个请求中使用它来获取搜索结果。
• 用于下次请求的直接 URL（在“result”字段中）以检索搜索结果。

从域名获取潜在客户

请求类型：GET

请求网址：https://api.snov.io/v2/domain-search/prospects/result/{task_hash}

使用此请求可检索上一个请求生成的潜在客户搜索结果。

输入参数：此请求不需要任何参数。将“task_hash”添加到URL或使用上一个响应中提供的直接链接。

该请求的响应包含：

响应提供了有关在域上找到的潜在客户的详细信息。每个潜在客户包含以下字段：

• “first_name”
• “last_name”
• “position”
• “source_page”
• “search_emails_start”

API 结果分页：每次请求返回一页结果。如果您在上一次请求中未指定“page”参数，则默认返回第一页。

“total_count”字段显示该域名的潜在客户总数。如果还有更多页面可用，您将看到“next”字段，其中包含用于检索下一页结果的 URL。

搜索潜在客户的邮箱地址

请求类型：POST

请求的 URL： https://api.snov.io/v2/domain-search/prospects/search-emails/start/ {prospect_hash}

使用此请求查找潜在客户的邮箱地址（在上一个请求从域名获取潜在客户的结果中返回）。

输入参数：

此请求不需要任何附加参数。使用 上一个响应中“search_emails_start”字段的值，将自动将唯一的“prospect_hash”（潜在客户ID）添加到 URL 。

答复包含两个关键内容：

• 一个唯一的“task_hash” ，用于标识您的请求。您将在下一个请求中使用它来获取搜索结果。
• 下一个请求的直接 URL（在“result”字段中）用于检查搜索状态并检索潜在客户的邮箱地址。

获取潜在客户的电子邮箱地址

请求类型：GET

请求的 URL：https://api.snov.io/v2/domain-search/prospects/search-emails/result/{task_hash}

使用此请求检索上一个请求中找到的潜在客户的邮箱地址。

输入参数：

此请求不需要任何附加参数。使用上一次响应中的值，唯一的 “task_hash” 会自动添加到 URL。

该请求的响应包含：

此请求的响应包括潜在客户的邮箱地址及其验证状态，状态可能是有效（绿色）或未知（黄色）。了解有关邮箱状态的更多信息。

按域名搜索电子邮箱

请求类型：POST

请求的 URL： https ://api.snov.io/v2/domain-search/domain-emails/start?domain=

使用此端点向 Snovio API 发送请求，以在提供的域名上搜索域名邮箱。

输入参数：

在该请求的“domain”字段中， 输入您要搜索的域名（公司网站）。

答复包含两个关键内容：

• 一个唯一的“task_hash” ，用于标识您的请求。您将在下一个请求中使用它来获取搜索结果。
• 用于检索搜索结果的直接 URL（在“result”字段中）。

获取域名邮箱

请求类型：GET

请求 URL： https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}

使用此请求检索上一个请求生成的邮箱搜索结果。

输入参数：此请求不需要任何参数。在 URL 末尾添加“task_hash”或使用上一个响应中提供的直接链接。

该请求的响应包含：

响应提供了在域名上找到的邮箱地址列表。

响应中的“total_count”字段显示可用的邮箱总数。如果有更多页面可用，您将在“next”字段中获取用于检索下一页结果的 URL。

响应中的“next”字段提供了您可以用来请求下一页结果的 URL。

按域名搜索通用联系人

请求类型：POST

请求的 URL： https://api.snov.io/v2/domain-search/generic-contacts/start

使用此端点向 Snovio API 发送请求，以在提供的域名上搜索通用联系人。

输入参数：

在该请求的“domain”字段中， 输入您要搜索的域名（公司网站）。

响应包含两个关键内容：

• 一个唯一的“task_hash”，用于标识您的请求。您将在下一个请求中使用它来获取搜索结果。
•  用于检索搜索结果的直接 URL（在“result”字段中）。

从域名获取通用联系人

请求类型：GET

请求的 URL：https://api.snov.io/v2/domain-search/generic-contacts/result/task_hash

使用此请求来检索上一个请求生成的搜索结果。

输入参数：此请求不需要任何参数。在 URL 末尾添加“task_hash”或使用上一个响应中提供的直接链接。

该请求的响应包含：

响应提供了在域名上找到的通用联系人邮箱列表。

响应中的“total_count”字段显示可用的联系人总数。如果还有更多页面可用，您将在“next”字段中获取用于检索下一页结果的 URL。

域名搜索 API 信用点数成本

对域名搜索 API 的每个POST类型请求都会从您的帐户配额中扣除一个信用点数额度。

以下情况请求不会扣除任何积分：

1. 该请求未提供任何结果（例如，响应中没有公司信息、没有潜在客户或没有邮箱）。
2. 搜索请求未找到潜在客户的任何已验证（绿色或黄色）邮箱。

请求 URL	信用点数扣除情况
https://api.snov.io/v2/domain-search	每个类型为“POST”的请求扣除 1 个信用点数。
https://api.snov.io/v2/domain-search/prospects	每个类型为“POST”的请求扣除 1 个信用点数（每个请求最多 20 个潜在客户资料，不含邮箱）。
https://api.snov.io/v2/domain-search/domain-emails	每个类型为“POST”的请求扣除 1 个信用点数（每个请求最多 50 个未经验证的域名邮箱）。
https://api.snov.io/v2/domain-search/generic-contacts	每个类型为“POST”的请求扣除 1 个信用点数（每个请求最多 50 个未经验证的通用联系人）。
https://api.snov.io/v2/domain-search/prospects/search-emails	如果找到有效（绿色）或未知（黄色）电子邮箱，则每个潜在客户扣除 1 个信用点数。如果未找到经过验证的电子邮箱，则不收取任何点数。

请参阅我们的域名搜索 API 文档中的完整技术信息。