站点图标 Snov.io 知识库

如何使用 Snov.io API

大纲:

什么是 API,它是如何工作的
使用 Snov.io API 的好处
如何测试 Snov.io API
步骤 1. 使用 Postman 注册
步骤 2. 通用 API 调用设置
步骤 3. 获取 API 访问令牌
步骤 4. 进行测试 API 调用

Snov.io API 调用
Snov.io API 限制

在您的 Snov.io 工作流程中自动执行任务,将 Snov.io 直接集成到您的平台中,并从我们的数据库中检索邮箱地址。 Snov.io REST API 让这一切成为可能!

什么是 API,它是如何工作的

让我们快速了解基础知识并熟悉 API 是什么以及它是如何工作的。

API 代表应用程序编程接口,用于软件到软件的通信。 这是应用程序相互交谈和交互并根据请求提供数据或功能的一种方式。

您可以将其视为“聊天室”,其中一个应用程序或软件向另一个应用程序请求某些内容并获得实时响应。 在这个“聊天室”中进行通信的唯一方式是发送预定义的“问题”或“命令”(API 调用),同时服务器发回一个答案。

因此,API 调用是客户端(您)向服务器的 API (Snov.io) 发送请求并获得响应的过程。

四种最常见的 API 请求方法是:

如果客户端(您)使用正确的参数提出正确的问题,服务器 (Snov.io) 将返回请求的数据或确认请求操作已完成的响应。

使用 Snov.io API 的好处

Snov.io API 为您提供了扩展应用程序/网站功能的绝佳机会。

使用 Snov.io API,您可以:

如何测试 Snov.io API

了解 Snov.io API 工作原理的最简单方法是使用 API 测试工具。 我们将使用 Postman,因为它众所周知,相对容易使用,并且有免费版本。

让我们从 Postman 对 Snov.io 进行第一次 API 调用!

步骤 1. 使用 Postman 注册

在官方网站上使用 Postman 应用程序注册并创建您的帐户。

Home (1) 选项卡中,单击 Send a request (2) 按钮以进入 API 测试环境。

步骤 2. 通用 API 调用设置

对 Snov.io API 的每个请求都包括:

提示:对于 GET 请求,在 Params 选项卡中输入输入参数。 对于 POST 请求,在 Body 选项卡→ form-data 选项卡中输入输入参数。

步骤 3. 获取 API 访问令牌

在发出请求之前,您需要生成访问令牌以验证您未来对 Snov.io 的 API 调用,并在 Snov.io API“聊天室”中将自己标识为 Snov.io 客户端。

访问令牌是您每次对 Snov.io 进行 API 调用时都需要出示的个人“通行证”。

在对 Snov.io API 的每个请求中,都需要在 Authorization 字段中指定此访问令牌(稍后我们将解释如何在 Postman 中执行此操作)。

访问令牌 API 调用设置如下:

(1) 类型:POST
(2) 请求网址:https://api.snov.io/v1/oauth/access_token

Key Value
grant_type (1) client_credentials
client_id (2) 账户设置里获得User ID
client_secret (3) 账户设置里获得API Secret

输入所有参数后,单击发送 (1) 按钮并在输出/响应部分获取您的访问令牌 (2)。 保存或复制它以在将来的 API 调用中使用。

注意 #1:出于安全目的,访问令牌的生命周期等于 3600 秒(1 小时)。 您需要每 1 小时生成一个新的访问令牌。

注意#2:令牌类型是 Bearer。 您需要在授权下一个请求时指定令牌类型。

现在让我们了解一些您可以定向到 Snov.io API 的 API 调用。

步骤 4. 进行测试 API 调用

域名搜索 V.2

您可以要求 Snov.io API 每次调用最多共享 100个域名。 作为回复,每 10 个邮箱地址/潜在客户需要 1 个点数。

要在 Postman 中验证您的 API 调用:

转到 Postman 中的授权选项卡 (1),选择承载令牌 (2) 类型,然后粘贴您的访问令牌 (3)。

返回到 Params 选项卡以输入域名搜索 API 调用设置:

(1) 类型:GET
(2) 请求网址:https://api.snov.io/v2/domain-emails-with-info
(3) 输入参数:

Key Value
domain 你想要搜索邮箱的关联域名
type 所有邮箱,个人邮箱,通用邮箱
limit 你想要从一个域名下获得邮箱的数量(最多100个)
lastId 默认值为 0. 如果要从一个域名内获得多于100个邮箱, 在您的下一次请求中, 指定上一个请求中的 last_id 返还值
position or positions 输入一个特定的职位,以过滤从一个域名中获得的潜在客户信息

注意 #1:如果您要求提供通用邮箱地址,您将获得基于角色的电子邮件地址,例如 contact@snov.io。 个人邮箱邮件地址是在公司工作的实际人员的邮箱地址。 如果您将 all 指定为一种类型,您将同时收到个人邮箱和通用邮箱地址。
注意 #2:要从域名中获取超过 100 个邮箱地址,请在您的下一个请求中,指明上一个请求的 last_id 响应值。

输入所有设置后,单击发送按钮以查看 Snov.io 必须共享的邮箱地址。

使用 Snov.io API,您可以检查提供的电子邮件地址是否有效。 此 API 调用是免费的。

首先,确保使用授权选项卡中的访问令牌对您的 API 调用进行身份验证。

接下来,在 Postman 中打开 Body 选项卡→表单数据选项卡,然后进入 Email Verifier API 调用设置:

(1) 类型:POST
(2) 请求网址:https://api.snov.io/v1/get-emails-verification-status
(3) 输入参数:

Key:邮箱地址[]; 值 – 您要检查的邮箱地址地址数组(列表)。

输入所有参数后,单击发送按钮以在输出/响应部分查看邮箱地址状态:“有效”、“not_valid”、“灰名单”或“未知”。

如果您在“输出/响应”字段中收到“not_verified”标识符,则表示我们之前未验证此电子邮件地址。 您应该使用添加邮箱地址进行验证 API 调用来验证此邮箱地址(每个邮箱地址 1 点数),然后重复邮箱验证工具 API 调用(免费)以查看验证结果。

Snov.io API 调用

所有 Snov.io API 调用都以类似的方式工作 – 您输入 URL、输入参数和访问令牌以获取响应:

或触发某个动作,例如以下之一:

Snov.io API 限制

Snov.io API 对每小时和每分钟可以调用的 API 数量有一定的限制。

每分钟限制为 60 个 API 调用。

每小时限制取决于您的套餐:

邮箱地址查找工具 API 调用限制:

邮箱地址验证工具 API 调用限制:

您可以在我们的 API 文档中查看可用 API 调用、其参数、信用成本和限制的完整列表。

没有您自己的应用程序来连接 Snov.io API,但想集成您喜欢的应用程序? 了解如何使用 Zapier 集成。

需要访问 Snov.io API? 请随时与我们的代表联系以安排测试会议。

退出移动版