主题
API + MCPGET/v3/content-helper/topics
此端点每次请求会消耗基础的 1000 个单位；如果你请求对某个 URL 进行评分，则额外消耗 500 个单位。
分析会按需对当前在该关键词下排名的页面运行，因此某个关键词的首次请求需要几秒钟。结果会被缓存，重复请求将从缓存中提供且不收取费用。
仅使用 Ahrefs 已经采集的 SERP，不会采集新的 SERP。如果我们在过去 90 天内已采集过该关键词和国家/地区对应的 SERP，此端点会返回
400错误，且不会消耗任何单位。
查询参数
keywordstring必填
要分析其 SERP 的关键词。
countrystring必填
由两个字母组成的国家/地区代码（ISO 3166-1 alpha-2）。
允许的值:adaeafagaialamaoarasatauawazba…
top_competitorsinteger
要分析的排名靠前页面数量。页面越少，分析越快，但覆盖面会变窄。
默认:10
target_urlstring (url)
（500 个单位）用于与相同主题对比评分的你自己的一页内容，例如你正在撰写的草稿或想要改进的页面。该页面会实时抓取。每次都会额外消耗 API 单位（其评分不会被缓存）。
outputstring
输出格式。
允许的值:jsonphp
响应
topicsarray<object>
avg_scorenumber (float)
该主题在可分析页面中的平均覆盖评分，范围为 0 到 100。数值越高，表示已排名的页面对该主题覆盖越充分。若没有任何页面可分析，则为 null。
descriptionstring
从竞争页面中识别出的核心主题内容概述。
pagesarray<object>
该主题的逐页覆盖情况：包含字段 url、position（页面在 SERP 中的位置）、score（0-100）以及 extracts（覆盖该主题的页面摘录）的记录。对于无法获取内容的页面，score 为 null 且 extracts 为空；这与评分为零的页面不同。
urlstring (url)
positioninteger
scoreinteger
extractsarray<string>
pages_coveringinteger
分析的页面中，有多少页面覆盖了该主题（得分非零）。
serp_datestring (date)
分析所用 SERP 的采集时间。
targetobject or null
target_url 指定的页面对该主题的覆盖情况。若未提供 target_url，则为 null。
urlstring (url)
scoreinteger
extractsarray<string>
topicstring
排名靠前页面所覆盖的核心主题名称。
errorstring
errorstring
errorstring
errorstring
errorstring