简介
借助 Ahrefs API，您可以使用 Ahrefs 工作区中的数据来创建自定义集成和自动化流程。 目前，API v3 允许你从 Site Explorer、Keywords Explorer、SERP 概览、Rank Tracker、Site Audit、Brand Radar 和社交媒体管理等端点拉取数据，并管理你的 Rank Tracker 项目和 Keywords Explorer 列表：
- Site Explorer：概览统计数据和历史图表、反向链接、自然流量和付费流量报告
- Keywords Explorer：单个关键词或关键词列表的指标、搜索量历史和按国家/地区划分的搜索量、关键词创意报告
- Site Audit：项目健康评分、完整的问题报告以及抓取页面的内容
- SERP 概览：SERP 前 100 名结果
- Rank Tracker：项目概览、竞争对手报告以及 Rank Tracker SERP
- Batch Analysis：每次请求最多可获取 100 个目标的指标
- Brand Radar：品牌概览统计数据、历史表现图表，以及跨多个 AI agent 的带引用真实提示词
- Social Media Management：已连接的社交媒体账号的渠道、帖子、活动历史和指标
- Management：用于管理 Rank Tracker 项目和 Keywords Explorer 列表的端点
- Subscription information：您的 API 限制和使用情况
- Public endpoints：我们的爬虫 IP 地址及范围
适用资格
Ahrefs API 适用于符合条件的付费套餐。 在其他所有套餐中，您仍可使用一组数量有限的免费测试查询。
套餐限额
除免费测试查询以及 Rank Tracker、Management、Public 和其他一些端点外，所有请求都会消耗 API 单位。 费用取决于响应中的行数以及所请求的字段。 任何请求的最低费用为 50 单位。 如果某个端点免费，您会在其文档页面看到相关说明；否则将消耗单位。
相关指南：限额消耗
info
请注意，API 单位一经消耗，概不退款。 我们强烈建议在所有开发与测试场景中使用我们的免费测试查询，以降低意外消耗 API 单位的风险。
我们也建议为你的 API 密钥设置限制，尤其是在测试和开发阶段。
符合条件的付费套餐包含每月的 API 单元额度。 在支持按量付费的方案中，一旦超出包含的额度，额外单元将自动计费。
如果你使用的是年度订阅，可以通过以折扣价预付更多 API 单元来节省成本。 你可以在账户设置 / 限额与用量中跟踪 API 单元消耗情况，并购买预付费加购包。
另请参阅：定价页面
API密钥
要向 Ahrefs API 发送请求，你需要一个 API 密钥。 只有工作区所有者和管理员可以创建和管理 API 密钥。 你可以在账户设置 / API 密钥中完成该操作。
相关指南：API 密钥创建与管理
基础用法
通过Ahrefs 报告中的这些 API 按钮快速上手。 点击它们即可将请求显示为 cURL 命令。
由于 cURL 命令会随着你在报告中应用的任何筛选条件动态更新，因此这些按钮也可用作查询构建器。
请注意，cURL 包含当前报告中显示的所有字段和指标。 你可以移除不需要的字段，以降低一次请求的成本。
如需了解完整用法详情，请查看本文档中的 API 参考。 该参考包含与 OpenAPI 兼容的规范，涵盖每个端点的请求与响应格式。
速率限制
Ahrefs API 默认限制为每分钟 60 次请求。 如果超过该限制，API 将返回 HTTP 429 状态码（Too Many Requests）。
此外，为了保持最佳性能和系统稳定性，API 请求也可能因节流而偶尔被拒绝，并返回同样的 HTTP 429 状态码。 节流会根据实时系统负载、资源可用性以及你的请求所需的计算量动态触发。