Apollo.io API 允许你自己的代码搜索人员、丰富记录并管理销售工作流。你可以通过 HTTPS 使用 Apollo.io API 密钥调用它。你也可以跳过密钥,让 AI 客户端通过 Apollo.io MCP 服务器访问相同的数据。这两种方式都会消耗你套餐中的额度,并遵循套餐限制。
本指南将介绍 Apollo.io API,从第一次点击到第一次调用。你将了解如何创建密钥以及在哪里找到它。内容涵盖 Apollo.io API 文档、健康检查、人员搜索、数据丰富、速率限制和额度成本。最后还会介绍 Apollo.io 的官方 MCP 服务器,以及检查 API 返回地址的常规流程。所有内容均来自 docs.apollo.io 的官方开发者文档,阅读时间为 2026 年 10 月。Apollo.io 将多个页面标记为最近更新,因此请在开始构建的当天确认详细信息。
我们与 Apollo.io 没有任何关联。BillionVerify 是一项邮箱验证服务。如需更全面地了解该平台,请阅读我们的 Apollo.io 指南。
关键事实(2026 年 10 月核查):
- 每个套餐(包括免费套餐)都提供一定程度的 API 访问权限。免费账户对某些端点需要使用工作邮箱。
- Apollo.io API 会在
x-api-key请求头中发送密钥,基础 URL 为https://api.apollo.io/api/v1。 - 受限范围的 Apollo.io API 密钥只能访问你勾选的端点。主密钥可以访问所有端点。
- 付费套餐中的大多数端点每分钟接受 200 次调用,而免费套餐为 50 次。
- Apollo.io MCP 服务器位于
https://mcp.apollo.io/mcp,并使用 OAuth 登录。
Apollo.io API 的作用
Apollo.io 将其 API 描述为一种以编程方式搜索、丰富、创建和管理数据的方法。其背后拥有超过 2.4 亿个联系人和 3,000 万家公司组成的数据库。文档将这些工作分为三类:
- 构建集成。 将你的产品连接到 Apollo.io 数据,创建账户并推动序列。
- 丰富数据。 一次填写一条或批量填写人员和公司记录。
- 查找人员。 根据职位名称、地点、资历以及许多其他筛选条件进行搜索。
你的套餐决定了你可以使用哪些端点、调用速度,以及每次调用的成本。Apollo.io 还表示,其工具无法执行你在应用中无法完成的操作。如果你的账户缺少某项功能,API 也不会解锁该功能。
哪些套餐包含 API?
开发者 FAQ 表示,每个层级都提供基本访问权限。更高级的功能仅适用于某些层级。我们的 Apollo.io 定价指南 列出了各个层级及其积分池。
免费账户有一项限制。部分人员搜索、数据丰富和记录端点要求账户使用工作邮箱地址注册。每个受影响的端点页面都会说明这一点。付费账户不受影响。
Apollo.io API 适合哪些人?
主要有三类用户:
- 销售和 RevOps 团队,希望将丰富后的数据推送到 CRM 或数据仓库。
- 软件公司的开发者,将 Apollo.io 数据嵌入自己的产品。
- 合作伙伴,构建市场集成。他们使用 OAuth 2.0 登录,而不是使用密钥。
Apollo.io 还补充了一项许可说明。若要向非 Apollo.io 用户共享、暴露或转售其数据,需要签订定制合同。
Apollo.io API 文档:所有内容的位置
Apollo.io API 文档位于 docs.apollo.io。顶部栏将其分为 Get Started、API、MCP、CLI、OpenAPI 和 Changelog。API 部分为每个端点提供一个页面。

截图:Apollo.io 开发者文档中的 People API Search 页面,来自 Apollo.io 关于测试密钥的指南。
每个端点页面都遵循相同的结构。顶部的“端点要点”框列出关键访问路径、OAuth 作用域、可使用者以及所需信用额度。下方是参数。右侧提供语言选择器、凭据字段、cURL 请求和示例响应。
你可以直接在页面上进行实时测试。将密钥粘贴到请求头字段中,填写必需参数,然后点击 Try It。200 表示调用成功。即使没有密钥,你也可以打开每个示例响应来查看架构。
OpenAPI 文件
Apollo.io 将完整的 API 作为一个 OpenAPI 3 文件发布在 https://docs.apollo.io/openapi/apollo-rest-api.json。文档发生变化时,该文件也会重新构建。将其加载到 Postman 或其他 API 客户端中,每个端点及其参数都会自动导入。你还可以将其提供给代码生成器,以使用自己的编程语言构建类型化客户端。
在 Postman 中,将密钥保存在预配置的 API Key 授权中,并设置一个 apiKey 变量。文档提醒,将密钥粘贴为 Bearer 令牌会返回 401。Bearer 令牌适用于 OAuth 合作伙伴。
机器可读的索引
文档还在 docs.apollo.io/llms.txt 发布了纯文本索引。它将每个页面列为 Markdown 链接。AI 编程工具可以读取该索引,从而找到正确的端点页面,而无需抓取整个网站。
如何获取 Apollo.io API 密钥
Apollo.io API 密钥是在应用内创建的,而不是在文档网站上创建的。路径是“设置”,然后选择“集成”,再选择“API 密钥”。只有管理员以及权限配置涵盖密钥的用户才能执行此操作。
以下是获取 Apollo.io API 密钥访问权限的步骤:
- 打开 Apollo.io,点击 设置 > 集成 > API 密钥。developer.apollo.io 上的开发者控制台显示的是同一页面。
- 点击 创建新密钥。
- 输入名称和描述。
- 勾选该密钥可以调用的每个端点,或开启 设为主密钥。
- 点击 创建 API 密钥。
- 点击 复制,并将密钥粘贴到安全的位置。

截图:Apollo.io 开发者门户中的“创建新 API 密钥”对话框,来源于 Apollo.io 的文档。
Apollo.io 会在最后显示完整密钥。请在此时复制它。如果丢失,可以从控制台重新生成。
在哪里查找现有的 Apollo.io API 密钥
如果你需要查找之前创建的 Apollo.io API 密钥,请返回开发者控制台并打开 API 密钥页面。你创建的每个密钥都会显示在列表中。门户侧边栏还包含“快速开始”、“使用情况”和“订阅”页面。同一侧边栏还为合作伙伴提供 OAuth 注册页面。
Apollo.io 允许你对现有密钥执行两项操作。重新生成会创建一个新的密钥并复制它。删除会永久移除该密钥。请将这两项操作都视为单向操作,因为所有使用旧密钥的脚本都会失效。
主密钥还是范围限定密钥?
创建 Apollo.io API 密钥时,这个选择比其他任何选择都重要。
| 类型 | 可访问范围 | 用途 |
|---|---|---|
| 范围限定密钥(默认) | 仅限你勾选的端点 | 大多数集成 |
| 主密钥 | 所有端点 | 要求使用主密钥的端点,以及通过密钥使用 MCP 服务器 |
如果范围限定密钥调用了你未勾选的端点,就会收到 403。某些端点(例如工作区用户列表)只能使用主密钥。Apollo.io 建议你像保护密码一样保护主密钥。它可以执行你的账户被允许执行的任何 API 操作。
密钥代表哪个用户执行操作?
Apollo.io API 密钥标识的是你的工作区,而不是某个人。Apollo.io 无法判断具体是哪位队友使用了它。每个请求都会以工作区中任职时间最长的活跃管理员身份执行,并且该用户拥有调用所创建的任何内容。要查看该用户是谁,可以调用“获取当前用户资料”端点,该操作不消耗额度。
对于使用权限受限的登录账号创建密钥的团队来说,这一点可能令人意外。密钥不会限制代码可以访问的范围。
Apollo.io API 健康检查
测试新密钥最快的方法是执行一次健康检查调用。这是对 auth/health 发起的单个 GET 请求,不会消耗任何额度。
curl --request GET \ --url 'https://api.apollo.io/api/v1/auth/health' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
如果所有设置都正确,Apollo.io API 健康检查会返回两个值:
{ "healthy": true, "is_logged_in": true }
当两者都是 true 时,密钥即可正常使用。如果任一值为 false,请检查密钥后是否有多余空格或换行,然后重新发送请求。在 Postman 中,将 Authorization 类型设置为 No Auth,并改为将密钥添加到请求标头中。
Apollo.io API 是否宕机?
搜索这一术语的人有时想知道的是另一件事:他们想了解服务本身是否宕机。auth/health 调用测试的是你的密钥和登录状态,而不是整个平台。发生服务中断时,Apollo.io 会在 status.apollo.io 提供状态页面。
返回 429 响应并显示代码 USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT,意味着平台由于整体负载过高而拒绝流量。这与您的套餐无关。文档建议等待 60 秒后重试。
Apollo.io API 中的主要端点组
参考文档列出了几十个端点,可分为六组。
| 组别 | 覆盖范围 | 示例 |
|---|---|---|
| 搜索与丰富 | 查找人员和公司,补充记录 | People API 搜索、人员信息丰富、组织搜索 |
| 管理记录 | 账户、联系人、交易、列表、备注 | 创建联系人、批量更新账户、将记录添加到列表 |
| 与潜在客户互动 | 序列、邮件、通话、任务、对话 | 将联系人添加到序列、立即发送邮件 |
| AI 助手 | 将任务交给内置助手 | 运行助手任务、轮询助手任务 |
| 工作区 | 用户、邮箱、自定义字段 | 获取用户列表、创建自定义字段 |
| 分析与使用情况 | 报告、使用统计、Webhook 结果 | 查询分析报告、查看使用统计 |
记录管理、序列以及大多数工作区调用使用 0 个积分。费用主要产生于搜索和信息丰富功能,我们将在下文介绍。
搜索不等于信息丰富
这种划分经常让新用户感到困惑。在 Apollo.io 的人员数据库中进行搜索会返回个人资料,但结果不包含邮箱或电话号码。你需要再次调用信息丰富端点才能获取这些信息。搜索你自己保存的联系人则使用另一组端点,其限制也有所不同。
Apollo.io API 人员搜索文档
Apollo.io API 人员搜索文档涵盖一个 POST 端点:/mixed_people/api_search。Apollo.io 将人员定义为尚未保存为联系人的全新潜在客户。
curl --request POST \ --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
参数放在查询字符串中。你可以按以下条件缩小搜索范围:
- 职位名称:
person_titles[],以及用于排除特定职位的person_not_titles[]。 - 资历:
person_seniorities[]。 - 位置:
person_locations[]用于人员居住地,organization_locations[]用于公司总部所在地。 - 公司规模和收入:
organization_num_employees_ranges[]和revenue_range[min]。 - 技术: 筛选公司使用的超过 1,500 种技术。
- 招聘信号:
q_organization_job_titles[]和职位发布数量。 - 邮箱状态:
contact_email_status[],其值包括已验证、未验证、可能互动和不可用。 - 分页:
page和per_page。
人员搜索端点使用 0 个积分。每页最多返回 100 条记录。此外,它还有 50,000 条记录的显示上限,即 500 页。请添加筛选条件以保持在该上限以内。
Apollo.io API 人员搜索返回的内容
人员搜索响应包含一个 total_entries 数量和一个 people 列表。其中不包含邮箱和电话号码。要获取联系详情,请将每条结果传递给丰富化端点。
搜索有其自身的限制,详见下方的速率限制部分。
如果你通过 contact_email_status[] 进行搜索,请记住该值的来源。它描述的是 Apollo.io 自己记录的地址状态,而不是实时邮箱测试结果。
如何更快阅读 Apollo.io API 人员搜索文档
先查看 Endpoint essentials 框。检查积分使用情况和免费账户访问权限这两行。然后浏览参数列表,查找所需的筛选条件。最后,先使用 per_page=10 运行一个小规模请求,再分页浏览数千条结果。
使用 Apollo.io API 丰富人员信息
信息丰富会刷新你已经持有的记录。Apollo.io 为人员提供两个端点:
- 人员信息丰富:
POST /people/match,每次调用处理一人。 - 批量人员信息丰富: 单个请求最多处理 10 人。
Apollo.io 需要足够的详细信息,才能匹配正确的人员。仅提供邮箱地址即可。姓名加公司域名也可以。该端点还接受 LinkedIn URL、组织名称或 Apollo.io 人员 ID。如果只发送姓名,你可能会收到一个没有丰富任何信息的 200 响应。
检查每个响应中的 match_confidence。它的值可以是 high、medium、low 或 none。
curl --request POST \ --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
响应会包含该人员的职位、工作经历、公司数据以及 email_status,例如 verified。该状态是 Apollo.io 自有的标签。本指南后续的检查会测试邮箱地址本身。
电话号码、个人地址和瀑布式查询
三个可选开关会改变返回的信息:
reveal_personal_emails=true会添加个人邮箱地址。对于 GDPR 地区的人员,Apollo.io 不会公开这些地址。reveal_phone_number=true会添加所有电话号码,包括手机号码。该选项需要webhook_url。Apollo.io 会异步检查这些号码,并将结果发布到你的 webhook,可能需要几分钟。run_waterfall_email和run_waterfall_phone会先搜索 Apollo.io,然后搜索你配置的外部数据提供商。最终结果也会通过 webhook 返回。
避免重复付费
如果之后再次丰富同一人员的信息,你可能会再次为相同数据消耗积分。Apollo.io 建议将已丰富信息的人员转换为联系人。联系人属于你的组织,因此其数据会一直可访问。
Apollo.io API 速率限制
速率限制按团队计算,而不是按密钥或用户计算。它们也按端点分别计算,并同时运行在三个时间窗口中:分钟、小时和天。你必须遵守所有适用窗口的限制。
| 限制 | 免费版 | 基础版 | 专业版 | 组织版 |
|---|---|---|---|---|
| 每分钟请求数 | 50 | 200 | 200 | 200 |
| 每小时请求数 | 200 | 400 | 400 | 600 |
| 每天请求数 | 600 | 2,000 | 2,000 | 6,000 |
上表是默认限制。付费套餐的搜索和数据丰富端点拥有更高限制:
- 数据丰富端点: 付费套餐每分钟 1,000 个请求,不设每小时或每日上限。免费账户每分钟 50 个请求,批量端点每分钟 20 个请求。
- 搜索端点: 付费套餐每分钟 200 个请求、每小时 6,000 个请求、每天 50,000 个请求。
- 更低限制: 查询分析报告每小时允许 5 个请求。
Apollo.io 的文档指出,较高的数据丰富限制并不意味着可以发送无限调用。你的信用额度余额仍然决定了你可以丰富多少数据。

截图:Apollo.io 开发者门户的使用情况页面,显示数据丰富端点的每日和每小时限制,来源于 Apollo.io 的文档。
响应标头和 429 错误
Apollo.io 会为经过身份验证的调用添加标头。这些标头会显示每个时间窗口的限制、当前使用量和剩余请求数:
x-rate-limit-minute、x-rate-limit-hourly和x-rate-limit-24-hourx-minute-usage、x-hourly-usage和x-24-hour-usagex-minute-requests-left、x-hourly-requests-left和x-24-hour-requests-leftretry-after会随429一起发送,表示距离窗口重置所剩的秒数
当你超过限制时,会收到 429。读取 retry-after 并等待。窗口从你的第一次请求开始计算,不与时钟时间绑定。错误正文包含一个 error_details 对象。对于你自己的限制,其 code 为 USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED。
如需在代码中读取团队当前的限制,请调用查看 API 使用情况统计的端点。一次调用最多可覆盖 74 条端点路径,并且不会消耗信用额度。
Apollo.io API 积分:哪些操作需要付费
许多调用无需付费。Apollo.io 表示,创建、更新、列出或管理记录的端点消耗 0 个积分。积分用于数据丰富、组织搜索、新闻搜索和 AI 洞察端点,并且只有在返回符合条件的数据时才会消耗积分。
| 端点 | 积分成本 |
|---|---|
| 人员数据丰富 | 每人 1 至 9 个积分:人口统计信息或邮箱各需 1 个积分;如果返回手机号码,则额外需要 8 个积分 |
| 批量人员数据丰富 | 逻辑相同,每次请求最多处理 10 人 |
| 组织数据丰富 | 每个组织 1 个积分 |
| 组织搜索 | 每页 1 个积分,每页最多 100 个结果 |
| 新闻文章搜索 | 每页 1 个积分,每页最多 25 个结果 |
| 组织职位发布 | 每页 1 个积分 |
| 获取完整人员信息 | 每人 1 个积分 |
| 助手任务 | 不固定,由助手执行的操作决定 |
人员搜索免费,因此合理的做法是先进行搜索,只为最匹配的对象进行数据丰富。对消耗积分的端点进行分页访问时,每一页都会消耗积分。Apollo.io 建议先运行小规模测试,并在扩大规模前查看使用情况。
瀑布式数据丰富可能成本更高。邮箱瀑布通常使用 1 至 4 个积分,某些配置可能使用 20 个或更多积分。电话瀑布通常使用 8 至 25 个积分,某些配置可能使用 45 个或更多积分。
要跟踪支出,请在应用中打开“设置 > 账单和积分 > 积分使用情况”。开发者仪表板的“使用情况”选项卡会显示当前计费周期内使用的电话和邮箱积分。旧版套餐可能有所不同,因此请查看工作区的“关于积分”页面。
错误和状态代码
大多数 Apollo.io API 端点共用一组简短的状态代码:
| 代码 | 含义 | 常见原因 |
|---|---|---|
401 | 未授权 | 缺少密钥、密钥无效,或密钥来自非活跃账户 |
403 | 禁止访问 | 计划不支持 API 访问,或作用域密钥无权访问该端点 |
404 | 未找到 | 记录不存在,或对你不可见 |
422 | 无法处理 | 参数无效或缺失 |
429 | 请求过多 | 超出了速率限制 |
500 | 服务器错误 | Apollo.io 方面出现故障,请重试 |
Apollo.io 正在将错误迁移到统一格式。对于已完成迁移的端点,响应会包含一个 error_details 对象,其中包含稳定的 code、message、suggestions 和 context。请根据 error_details.code 编写代码分支,绝不要根据消息文本判断。Apollo.io 计划于 2027 年 2 月 16 日移除旧的根级错误字段,因此请立即基于新对象构建。
Apollo.io MCP 服务器
MCP 是一种让 AI 工具调用外部服务的标准。Apollo.io MCP 服务器可将 Claude、ChatGPT 及类似客户端与您的 Apollo.io 账户连接起来。随后,您可以用自然语言提出请求:查找 SaaS 公司中 VP 级别的营销负责人,或丰富这十位潜在客户的信息。

截图:开发者文档中的 Apollo.io MCP 页面,2026 年 10 月。
三种连接方式
| 方式 | 工作原理 |
|---|---|
| AI 连接器 | ChatGPT、Claude、Perplexity、Replit 和 Cursor 中的内置集成。无需设置服务器。 |
| 编码插件 | 适用于 Codex 等工具的官方插件。 |
| 独立 MCP 服务器 | 让任何支持远程服务器的 MCP 客户端指向一个 URL。 |
独立服务器的设置很简短:
| 设置 | 值 |
|---|---|
| 端点 | https://mcp.apollo.io/mcp |
| 传输方式 | 可流式传输的 HTTP |
| 登录方式 | OAuth 2.0 |
| 本地安装 | 不需要 |
| API 密钥 | 不需要,除非客户端没有浏览器 |
在 Claude Code 中,只需一条命令即可添加服务器。运行命令,然后输入 /mcp 并完成 OAuth 登录:
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
如果您管理多个工作区,请为每个工作区使用不同的名称添加同一个 URL。分别登录每个连接。
没有浏览器的服务器
OAuth 需要浏览器窗口。定时任务或 CI 流水线没有浏览器。针对这些情况,服务器接受通过 X-Api-Key 发送的 API 密钥。该密钥必须是主密钥。范围受限的密钥会返回代码为 API_INACCESSIBLE 的 403,因为 MCP 服务器并不是您可以勾选的端点之一。
请像存储生产环境密钥一样存储该密钥。它相当于工作区管理员,并会消耗工作区积分。新的 MCP 工具会立即识别主密钥,但您的客户端可能会保留缓存的工具列表。重新连接并调用 tools/list 以刷新列表。
Apollo.io MCP 服务器可以做什么
工具列表涵盖搜索和潜在客户开发、人员和公司信息丰富、联系人、列表、序列、一次性邮件、任务、邮件域检查和分析。信息丰富操作会消耗积分。大多数其他操作不消耗积分。Apollo.io 提醒,人员搜索不会返回邮箱或电话,因此您的助手必须执行信息丰富步骤才能获取这些信息。
文档中的实际限制:
- 连接不会产生额外费用。您的套餐、权限和积分仍适用。
- 不支持删除等破坏性操作,例如批量删除。
- 服务器遵循您的权限。使用 OAuth 时,它会以登录用户的身份运行。
- Apollo.io MCP 使用单独的速率限制,并且不会返回速率限制标头。
- Apollo.io 禁止使用其 MCP 数据训练 AI 模型,因此请先在您的 AI 客户端中关闭训练功能。
Apollo.io 建议将消耗积分的操作设置为“需要批准”,这样健谈的助手就无法自行耗尽积分。
使用 Apollo.io API 的其他方式
- Apollo.io CLI。 一个可访问完整 API 的命令行工具。可通过 Homebrew、预构建二进制文件或从源代码安装。它使用 OAuth,因此无需密钥。
- OAuth 2.0。 合作伙伴使用它为共同客户调用 API,文档还列出了一个用于完整集成的市场应用。
- Chrome 扩展。 如果你更喜欢点击而不是编写代码,请阅读我们的 Apollo Chrome 扩展指南。
在发送前检查 Apollo.io API 中的地址
无论你选择哪种方式,数据都有一个薄弱点:它来自数据库。人们会换工作,公司也会迁移到新的域名。email_status 字段是 Apollo.io 自己的标签,并不是最新测试结果。向失效地址发送冷邮件会产生退信,而退信会损害你的发件人信誉。
因此,请在数据丰富和序列发送之间加入检查环节。BillionVerify 会在不发送邮件的情况下测试每个地址。它会检查语法、域名、MX 记录,并在你要求时通过 SMTP 检查邮箱。它会标记一次性地址和角色地址。它会将 catch-all 作为单独的结果报告,而不是将其计为有效地址。未知结果不收费,且 24 小时内重新检查免费。在接入 API 之前,你可以先在免费的网页检查器中手动检查邮箱地址是否存在。

BillionVerify 会为每个地址返回状态、可送达标记和原因。
一个小型流程
一个简单的流程包含四个步骤:
- 通过 API 执行免费的人员搜索。
- 仅丰富最匹配的结果。
- 将每个地址发送到 BillionVerify REST API。
- 仅将可送达地址添加到你的发送序列中。
BillionVerify 调用是一个 POST 请求。将密钥放在 BV-API-KEY 标头中,并将 check_smtp 设置为 true,以执行实时邮箱测试:
curl -X POST https://api.billionverify.com/v1/verify/single \
-H "BV-API-KEY: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"mark@sumware.com","check_smtp":true}'
响应包含 status、is_deliverable、is_catchall、is_role、is_disposable 和 reason。如果一次调用需要检查最多 50 个地址,请使用批量接口。对于完整导出文件,请上传 CSV、TXT 或 XLSX 文件,稍后再下载结果。完整参考请参阅 BillionVerify 文档。
从 AI 客户端进行验证
如果你已经将 Apollo.io 的 MCP 设置连接到 AI 客户端,请在旁边添加 BillionVerify 托管的 MCP 服务器。它位于 https://mcp.billionverify.com/mcp,并使用 OAuth 登录。这样,你的助手就能在一次对话中通过 Apollo.io 丰富潜在客户信息,并检查邮箱地址。告诉它你的策略,例如接受哪些状态,以及如何处理 catch-all。
其他检查
- 我们的 Apollo 邮箱验证页面介绍了导出流程。
- 可疑联系人可以通过我们的免费反向邮箱查询,查看与某个地址公开关联的信息。
- 通过 webhook 返回的电话号码也值得测试。我们的免费电话号码验证器会显示号码在其所属国家或地区是否有效,以及它属于哪种线路类型。
每天使用账户时,BillionVerify 会提供 20 个免费额度,每月最多 600 个。它们永不过期,也不需要信用卡。
构建 Apollo.io API 的技巧
- 每个集成从一个限定范围的密钥开始。 如果某个密钥泄露,你只需撤销这一个。
- 先运行健康检查。 在调试代码前,它可以排除密钥问题。
- 阅读 Endpoint 要点框。 Apollo.io API 的人员搜索文档会提前显示信用额度消耗。
- 先搜索,再进行丰富。 搜索免费,而丰富功能不是免费的。
- 使用
per_page=10进行测试。 小规模运行可以在造成损失前显示信用额度消耗。 - 遵守
retry-after。 反复请求受限 Endpoint 只会延长等待时间。 - 阅读
error_details.code。 消息文本可能会在不另行通知的情况下更改。 - 发送前先验证。 花费信用额度在一个会退信的地址上,相当于浪费两次。
常见问题
Apollo.io 有 API 吗?
有,Apollo.io 提供 REST API。它可以帮助你搜索人员和公司、丰富联系人信息,以及更新账户、交易和序列。每个套餐都包含基础访问权限。你的套餐决定了你可以调用哪些端点、调用速度,以及每次调用的费用。
如何获取 Apollo.io API 密钥?
Apollo.io 密钥来自“设置”中的“集成”区域:打开“API Keys”,选择“Create new key”。为密钥命名,勾选它可以调用的端点并确认,然后立即复制密钥。管理员或拥有适当权限配置文件的用户可以执行此操作。
在哪里可以找到我的 Apollo.io API 密钥?
你的 Apollo.io API 密钥列表位于“API Keys”页面,你可以从应用或开发者控制台进入该页面。创建密钥时会显示完整密钥。密钥丢失后,需要重新生成密钥,系统会签发一个新密钥。
Apollo.io API 免费吗?
创建、列出或更新记录的 Apollo.io API 调用不收费,人员搜索也不收费。当丰富联系人信息和某些搜索端点返回数据时,会扣除积分。免费账户可以在免费套餐的限制内调用 API,但某些端点要求使用工作邮箱。
Apollo.io API 的速率限制是多少?
在付费套餐中,大多数 Apollo.io API 端点每分钟最多处理 200 次调用,同时还有因套餐而异的每小时和每日上限。免费套餐每分钟最多 50 次、每小时 200 次、每天 600 次。限制按团队和端点分别 लागू,收到 429 响应表示你已超出限制。
如何测试 Apollo.io API 的健康检查?
Apollo.io 健康检查是向 auth/health 路径发送的 GET 请求,并设置密钥标头。返回 healthy: true 和 is_logged_in: true 表示密钥有效。此操作不会消耗积分。
Apollo.io API 的人员搜索会返回邮箱吗?
不会,Apollo.io 人员搜索端点只返回个人资料,不包含邮箱或电话号码。对搜索结果运行人员信息丰富或批量人员信息丰富端点,即可获取联系详情,但这会消耗积分。
Apollo.io API 文档在哪里?
Apollo.io API 文档位于 docs.apollo.io。每个端点都有独立页面,其中包含参数、测试面板和示例响应。你还可以下载 OpenAPI 文件并将其导入 Postman。
什么是 Apollo.io MCP 服务器?
Apollo.io MCP 服务器通过 Model Context Protocol 将 AI 客户端连接到你的工作区。其 URL 为 https://mcp.apollo.io/mcp,使用 Streamable HTTP 和 OAuth,并且无需本地安装。你的套餐、权限和积分规则仍然适用。
Apollo.io 最佳的 MCP 服务器是哪一个?
Apollo.io 发布了一个官方 MCP 服务器,这也是其文档介绍的服务器。我们没有测试第三方选项。如果你希望使用与应用相同的权限和积分规则,请选择官方服务器。
应该验证来自 Apollo.io API 的邮箱吗?
应该,在开展营销活动前,检查来自 Apollo.io API 的每个邮箱地址。email_status 字段反映的是 Apollo.io 自身的记录,而人们可能会更换工作。通过 BillionVerify API 快速检查,可以移除失效地址并保护你的发件人信誉。
观看视频:如何验证电话号码:免费电话号码验证器
观看视频:如何在发送前验证 Apollo 邮箱
