如何使用域名搜索 API

Iris Zhang

2 周前

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

这是 Snov.io 应用程序中域名搜索工具的 API 版本。它通过 API 请求提供相同的搜索选项。使用 API，您可以根据提供的域名请求，获取有关公司及其联系人（电子邮箱和潜在客户资料）的信息。

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

在向 Snov.io 发出任何请求之前，请使用身份验证端点获取access_token。将其用作下一个请求的bearer类型令牌。access_token有效期为 1 小时（3600 秒）。

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

请求类型：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 或使用上一个响应中提供的直接链接。

该请求的响应包含：

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

在响应的 “links” 字段中，您将找到用于按类型搜索和筛选联系人的直接 URL：“prospects”、“domain_emails”、“generic_contacts”。请将这些 URL 用于您的后续请求。

按域名搜索潜在客户

请求类型：POST

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

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

输入参数：

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

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

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

在“positions”参数中，以数组形式列出要作为筛选依据的职位名称（最多 10 个）。将它们放在方括号内，用逗号分隔。例如：positions[]： [Developer， Product Manager， Software Engineer]

响应包含两个关键内容：

一个唯一的“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。

重要：

邮箱地址不包含在此请求的响应中。要查找潜在客户的电子邮箱地址，请使用该潜在客户的“search_emails_start”字段中提供的 URL。该链接包括每个潜在客户的唯一“prospect_hash”。每个潜在客户都使用单独的请求进行查询。

搜索潜在客户的邮箱地址

请求类型：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。

如果搜索仍在运行，响应将显示“in_progress”。搜索“完成”并找到邮箱地址后，它将包含在响应中。

该请求的响应包含：

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

按域名搜索电子邮箱

请求类型：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”或使用上一个响应中提供的直接链接。

如果搜索仍在进行，响应将显示“in_progress”。搜索“完成”后，邮箱地址将包含在响应中。

该请求的响应包含：

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

API 结果分页：一次请求最多提供 50 个邮箱（一页结果），默认返回第一页。

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

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

注意：此响应中不包含邮箱验证状态。要验证域名邮箱，请使用邮箱地址验证 API。

按域名搜索通用联系人

请求类型：POST

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

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

通用联系人是公司域名的未经验证的邮箱地址，通常是技术或服务邮箱，例如 info@domain.com。

输入参数：

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

响应包含两个关键内容：

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

从域名获取通用联系人

请求类型：GET

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

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

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

如果搜索仍在运行，响应将显示“in_progress”。搜索“完成”后，结果将包含在响应中。

该请求的响应包含：

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

API 结果分页：一次请求最多提供 50 个联系人（一页结果）。默认返回第一页。

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

注意：此响应中不包含邮箱验证状态。要验证域名邮箱，请使用邮箱地址验证 API。

域名搜索 API 信用点数成本

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

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

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

请求 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 文档中的完整技术信息。