Docs
搜索文档...⌘K

更新日志

2025年12月3日

SA Projects 端点 已进行更新，带来了多项重大改进：

  • 支持历史抓取数据。
  • 可查询指定项目。
  • 支持 Always-on Audit（AOA）。
  • 新增更多指标，包括已抓取 URL 数量、错误数、警告数和通知数。

2025年12月1日

已发布更多 Brand Radar API 端点：

2025年11月7日

首个 Brand Radar 统计端点已发布：

  • 展示次数概览：返回 AI 客户端中的品牌展示次数，并支持与 UI 相同的筛选条件。

2025年10月9日

新的 RT 竞争对手统计端点 已发布。 该端点返回来自 Rank Tracker 项目的 SoV、流量、排名数量及其他竞争对手指标。

2025年10月2日

新的 SA Page Explorer 端点 已发布。 该端点提供对 Page Explorer 指标的程序化访问，并支持历史对比和基于问题的 URL 筛选。

2025年9月29日

所有与反向链接相关的 API 端点均已新增 is_spam 字段。 该字段与 Site Explorer UI 中的垃圾信息过滤器保持一致。

2025 年 9 月 8 日

首个 Brand Radar API 端点已发布：

  • AI responses：返回 AI 生成的回复，列和筛选条件与 UI 中一致。

2025 年 7 月 22 日

全新 SA Issues 端点 已发布。 该端点返回某个 Site Audit 项目的问题列表，并支持历史对比，包含新增受影响 URL 和已修复 URL 等指标。

2025 年 7 月 3 日

全新 SA Page content 端点 已发布。 它支持从 Site Audit 抓取中获取原始 HTML、渲染后的 HTML 或提取的文本内容，并为已验证的项目提供历史快照。

2025 年 7 月 2 日

APIv3 已进行多项更新：

2025 年 6 月 9 日

用于管理 Keywords Explorer 关键词列表的新 API 端点已发布：

2025 年 5 月 22 日

用于管理 Rank Tracker 项目的第二批端点已发布。 这些端点支持以编程方式修改 RT 项目：

2025年5月2日

KE Overview endpoint 中新增了 volume_monthly_history 字段。 它会根据 volume_monthly_date_from 和 volume_monthly_date_to 参数设置的时间范围，返回所请求关键词的历史月度搜索量。

2025年4月21日

RT 竞争页面 endpoint 已发布。

2025年3月3日

用于管理 RT 项目的第一批 API endpoint 已发布：

  • GET projects：列出工作区中的所有项目。 默认返回所有项目，但也可按访问类型、所有者、特定项目 ID 等进行筛选。
  • GET project-keywords：列出指定项目的所有 RT 关键词。
  • GET project-competitors：列出指定项目的所有 RT 竞争对手。
  • GET locations：一个辅助 endpoint，提供所有支持的国家/地区、地点和语言的字典。 这将对下一批 endpoint 非常有用，这些 endpoint 将支持向 RT 项目添加关键词并为其分配地区。

2024年12月9日

一批 APIv3 更新：

  • APIv3 中的总 SV 历史数据：total-search-volume-history 端点 会返回目标在前 10 或前 100 名位置上排名的关键词的总 SV。
  • OK 端点中的移动端 / 桌面端分布：organic-keywords 端点 现已新增两个字段：volume_mobile_pct 和 volume_desktop_pct，用于返回来自移动设备和桌面设备的搜索量占比。
  • OK 端点中的搜索意图：继 KE 端点新增意图字段后，organic-keywords 端点 现在也会返回这些信息。 为此新增了 is_commercial、is_informational 等几个新的布尔字段。

2024年12月3日

SE Organic competitors endpoint 已发布。 与报告本身一样，该端点会返回一份列表，列出在你关键词 Top 10 中排名的主要竞争对手。

2024 年 11 月 29 日

Rank Tracker API 的 competitors-overview 端点已发布。 它会提供你的竞争对手从你跟踪的关键词中获得的排名和预估流量，就像 Rank Tracker 中的“Competitors Overview”报告一样。

2024 年 11 月 28 日

intents 字段已添加到 KE Overview 端点和 Keyword ideas 端点中。

2024 年 11 月 8 日

在 KE Overview 端点和 Keyword ideas 端点中新增了多项功能：

  • 目标过滤器：现在你可以在 API 中按目标的排名位置筛选关键词。 为此新增了 target、target_mode 和 target_position 查询参数。
  • 空 keywords 参数：当指定上述 target 参数时，该端点也支持传入空的 keywords 参数。 这两项功能结合起来，你可以发起查询，获取目标有排名的所有关键词的 KE 指标。
  • 移动端 / 桌面端分布：新增了两个字段 volume_desktop_pct 和 volume_mobile_pct，用于返回某个关键词在桌面设备和移动设备上的搜索占比。
  • 月度搜索量：除了平均搜索量之外，新增字段 volume_monthly 还会提供该关键词在最近一个月的搜索次数。

2024 年 8 月 5 日

2024 年 5 月 31 日

offset 参数已弃用，并已从所有 API 端点中移除。

2024 年 5 月 8 日

Metrics history 端点现已支持 select 参数。

2024 年 4 月 26 日

已新增一个用于 Rank Tracker Overview 报告的端点。

2024 年 3 月 21 日

  • 新增了一个可返回出站链接数量的端点。
  • 此外，Keywords history 端点现已支持 select 参数，并新增了排名分组：top11_20、top21_50 和 top51_plus。

2024年3月11日

新增了一个可返回包含 Site Audit 健康评分的工作区项目列表的端点。

2024 年 30 月 1 日

新增了一个用于“出站锚”报告的端点。

2024 年 17 月 1 日

新增了一个用于“锚”报告的端点。

2023年12月5日

新增了一个可返回 AhrefsBot 使用的 IP 段的端点。

2023年11月23日

新增了一个用于 DR 历史图表的端点。

2023年11月16日

新增了一个 Limits and usage 端点，用于提供有关您的订阅和 API 使用情况的信息。

2023年9月18日

API 端点现在会在所有输出格式中以美分返回美元（USD）数值。

2023年6月16日

Keywords Explorer 中相关术语和搜索建议报告新增了端点。

2023年6月9日

Keywords Explorer 中“词匹配”报告新增了一个端点。

2023年5月26日

新增了通过运行一组不消耗单位的有限免费测试查询来测试 Ahrefs APIv3 的功能。

2023年3月7日

新增了一个用于 SERP 概览的端点。

2023年3月6日

新增了按反链数量排序和失效反向链接报告的端点。

2023年2月27日

已新增用于「已关联域名」报告的接口。

2022 年 11 月 25 日

已发布三个新的 Keywords Explorer 接口：关键词指标（适用于单个关键词或关键词列表）、搜索量历史（适用于单个关键词）以及按国家/地区划分的搜索量（适用于单个关键词）。

2022 年 11 月 10 日

已新增用于 UR 历史图表的接口。

2022 年 10 月 11 日

已新增用于「按最高排名划分的关键词」图表的接口。

2022 年 9 月 8 日

APIv3 已发布，现已提供 Site Explorer 的以下报告接口：概览、反向链接、引用域名、自然搜索关键词、热门页面以及付费页面。