更新日志
2026年7月14日
现已发布新的删除项目端点，你可以通过 project_ids 参数删除项目。
2026年7月13日
- Claude 现已可作为所有 Brand Radar 端点的数据源。
- SERP 概览端点 现已支持
type参数，可按 SERP 特性筛选结果。
2026 年 7 月 8 日
- Brand Radar 的 AI responses、Cited domains 和 Cited pages 端点新增了
brand_filter过滤器，用于匹配被发现但未被引用的品牌。 - SA Page Explorer 端点 现会返回 AI 搜索和训练机器人相关的允许/阻止字段。
2026 年 6 月 26 日
SMM Post metrics 端点 现已包含 TikTok 指标。
2026 年 6 月 25 日
SE 域名评分端点 已移除 protocol 参数。
2026 年 6 月 23 日
Projects 端点 现会返回 folder 字段；Create project 端点 现支持使用 folder_id 将项目放入文件夹。
2026 年 6 月 22 日
已发布新的 SE AI responses count 端点。 该端点会返回提及目标的 AI 响应数量。
2026 年 6 月 11 日
Brand Radar 引用相关端点已发布：
2026 年 6 月 8 日
已发布新的免费 域名评分端点。 该端点无需订阅即可返回某个域名的域名评分。
2026 年 5 月 29 日
用于管理 Rank Tracker 项目关键词标签的 API 端点已发布：
- PUT project-keywords-tags：为项目关键词添加标签。
- PUT project-keywords-tags-delete：从项目关键词中移除标签。
2026 年 5 月 27 日
API 和 MCP 的使用限额已提升。 请访问我们的定价页面，查看各套餐更新后的限额。
2026 年 5 月 25 日
Brand Radar 报告端点现已启用两个额外的数据来源：google_ai_mode_keywords 和 google_ai_overviews_keywords。
它们报告基于 Google 搜索查询（关键词）而非提示词得出的 AI Overviews / AI Mode 可见性。
2026 年 5 月 22 日
已发布新的 RT Competitors Domains 端点。 该端点会按域名维度返回某个 Rank Tracker 项目的竞品指标明细。
2026 年 5 月 18 日
- 已从 KE 的 概览、词匹配、搜索建议 和 按国家/地区划分的搜索量 端点中移除
search_engine参数。 - SA Page content 端点 现会返回
page_text_md字段，其中包含 Markdown 格式的页面文本。
2026 年 5 月 15 日
Brand Radar 报告端点更新：
- AI responses、Cited domains 和 Cited pages 新增了
volume_range过滤器。 - AI responses 端点 现会返回
last_updated字段。
2026 年 5 月 13 日
精简版及以上套餐现已开放直接 API 访问！
管理端点更新：
- Projects 端点 现会返回
verified字段。 - Create report 端点 现支持按名称和 URL 分组定义品牌和竞争对手。
2026 年 5 月 11 日
用于管理社交媒体帖子的端点已发布：
- POST post：创建帖子。
- PATCH post：更新帖子。
- DELETE post：删除帖子。
2026 年 5 月 6 日
Brand Radar 的 POST 端点现已支持在请求正文中使用 tags_filter 筛选器，以按标签筛选结果。 示例：AI 响应。
2026 年 4 月 27 日
GSC Keywords 端点现已支持通过新增的 keyword_lists 和 keyword_list_id 参数按关键词列表筛选，并会返回 keyword_list_labels 字段。
2026 年 4 月 24 日
Grok 现已可作为所有 Brand Radar 端点的数据源。
2026 年 4 月 20 日
Social Media API 已发布，可通过编程方式访问社交媒体管理工具 UI 中提供的相同报告：
2026 年 4 月 17 日
Brand Radar API 端点现已支持品牌变体和品牌网站，可通过现有 GET 端点对应的 POST 版本使用。
2026 年 4 月 13 日
新的 SE 已抓取页面端点 已发布。 该端点会返回 Ahrefs 为某个目标抓取过的页面。
2026 年 4 月 10 日
BR Cited pages 端点现已支持 tracked_urls 参数，可按已跟踪的 URL 筛选结果。
2026 年 3 月 31 日
用于管理 Brand Radar 报告的 API 端点已发布：
- GET brand-radar-reports：列出已保存的报告。
- POST brand-radar-reports：创建报告。
- PATCH brand-radar-reports：更新报告。
2026 年 3 月 30 日
GSC Pages 端点现已包含 traffic_value 字段。
2026 年 3 月 19 日
GSC Insights API 已发布，可通过编程方式访问 Google Search Console 数据：
2026 年 3 月 17 日
两个报告相关端点已扩展：
- SE Pages history 端点现已支持
page_positions参数，可按排名位置（例如top10）筛选页面。 - SA Page Explorer 端点现会返回
size_uncompressed字段，并提供对比值。
2026 年 3 月 12 日
BR AI responses 端点新增了 tags 字段。
2026 年 3 月 11 日
用于管理 Brand Radar 自定义提示词的 API 端点已发布：
- GET brand-radar-prompts：列出自定义提示词。
- POST brand-radar-prompts：添加自定义提示词。
- PUT brand-radar-prompts-delete：移除自定义提示词。
2026 年 3 月 9 日
BR AI responses 端点新增了 search_queries 字段，该字段对应聊天机器人为生成响应而查找信息时使用的搜索查询。
2026 年 2 月 27 日
为便于理解，已对两个 SE 端点重命名（原路径仍可继续使用）：
- 现在，
best-by-external-links已更名为 SE 按反向链接排序的页面。 - 现在，
best-by-internal-links已更名为 SE 按内链排序的页面。
2026 年 2 月 25 日
SA 项目端点 现已支持通过新增的 project_name 和 project_url 参数按名称和 URL 过滤项目。
2026 年 2 月 4 日
Web Analytics API 现已发布，可通过编程方式访问 Web Analytics 界面中提供的相同报告：
每个报告还提供时间序列的 -chart 变体，同时也提供整体的访客图表。
2026 年 1 月 2 日
已发布更多 Brand Radar API 端点：
2025 年 12 月 19 日
SE 自然搜索关键词端点 现已包含 keyword_language 字段，也可用作筛选条件。
2025 年 12 月 17 日
全新的 BR 声量份额历史端点 已发布。 该端点会返回各 AI 客户端中的声量份额指标随时间变化的数据。
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 已进行多项更新：
- 全新 RT SERP 概览端点 已发布，可从 Rank Tracker 项目中获取 SERP 数据。
- SE 自然搜索关键词端点 现已包含
all_positions字段，可返回所有参与排名的 URL 及其排名位置。 - RT Overview 端点 现可返回搜索意图数据，以及移动端/桌面端的搜索量分布。
- Projects 端点 现已包含 Rank Tracker 中被跟踪的关键词数量。
2025 年 6 月 9 日
用于管理 Keywords Explorer 关键词列表的新 API 端点已发布：
- GET keyword-list-keywords：列出某个关键词列表中的所有关键词。
- PUT keyword-list-keyword：向列表添加关键词。
- PUT keyword-list-keywords-delete：从列表移除关键词。
2025 年 5 月 22 日
用于管理 Rank Tracker 项目的第二批端点已发布。 这些端点支持以编程方式修改 RT 项目：
- POST project：创建新项目。
- PUT project-keyword：为项目添加关键词，并设置地区和标签。
- PUT project-keywords-delete：从项目中移除关键词。
- POST project-competitor：为项目添加竞争对手。
- POST project-competitors-delete：从项目中移除竞争对手。
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 日
- Batch Analysis 端点已发布。 它支持批量获取一组 URL 和域名的指定指标。
search_engine参数已弃用，并已从 Keywords Explorer 的 Overview、Volume by country、词匹配 和 搜索建议 端点中移除。
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 的以下报告接口：概览、反向链接、引用域名、自然搜索关键词、热门页面以及付费页面。