提供网站或页面链接及日期范围，查看它在普通搜索结果不同位置出现的搜索词数量变化；可按日、周或月查看。部分日期可能没有记录，汇总数量不会列出具体搜索词或解释变化原因。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Ahrefs
提供网站或页面链接及日期范围，查看它在普通搜索结果不同位置出现的搜索词数量变化；可按日、周或月查看。部分日期可能没有记录，汇总数量不会列出具体搜索词或解释变化原因。
获得带日期的关键词数量，分为第 1–3、4–10、11–20、21–50 与 51+ 名五个区间。Agent 可以按时间整理可用分组，在目标范围和搜索国家一致的条件下比较排名分布变化。
查看[https://example.com]从[2026年7月]到[2026年9月]的[每月]记录。统计有多少种不同的搜索内容让网站出现在不含广告的搜索结果前3位、第4–10位、第11–20位、第21–50位或第51位及之后。缺失月份留空；汇总不会列出具体搜索内容或说明变化原因。
每次最多覆盖 60 个时间组，历史数据可能存在缺口。数量不能确定具体关键词、排名网址或精确位置，变化也不能直接说明原因。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
queryParamsqueryParams | object | 必填 |
|
目标范围queryParams.mode | string | 选填 | 可选 exact、prefix、domain、subdomains，默认 subdomains。exact 仅此网址，prefix 为以目标开头的网址，domain 不含子域名，subdomains 包含子域名。比较时应保持范围一致。
|
目标域名或网址queryParams.target | string | 必填 | 必填非空字符串，如 example.com 或 https://example.com/page。与 mode、protocol 一起选择要查询排名关键词数量的目标。
|
搜索国家queryParams.country | string | 选填 | 可选 ISO 3166-1 alpha-2 两位国家代码，如 us。针对特定国家比较时，应明确填写并保持一致。
|
结束日期queryParams.date_to | string | 选填 | 可选历史结束日期，格式为 YYYY-MM-DD，默认当天。它指定报告时期，不是数据获取时间；明确填写可清楚说明比较窗口。
|
目标协议queryParams.protocol | string | 选填 | 可选 both、http、https，默认 both。选择纳入报告的目标网址协议，比较各时期时应保持一致。
|
起始日期queryParams.date_from | string | 必填 | 必填历史起始日期，格式为 YYYY-MM-DD。与结束日期及分组方式一起选择，使范围最多覆盖 60 个时间组。
|
时间分组queryParams.history_grouping | string | 选填 | 可选 daily（按日）、weekly（按周）、monthly（按月），默认 monthly。决定历史记录间隔，每次最多 60 组；并未约定按何种平均值或快照规则计算。
|
{
"type": "object",
"required": [
"queryParams"
],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"target",
"date_from"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"mode": {
"enum": [
"exact",
"prefix",
"domain",
"subdomains"
],
"type": "string",
"default": "subdomains",
"description": "关键词排名参数 1。"
},
"target": {
"type": "string",
"minLength": 1,
"description": "关键词排名参数 2。"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "关键词排名参数 3。"
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "关键词排名参数 4。"
},
"protocol": {
"enum": [
"both",
"http",
"https"
],
"type": "string",
"default": "both",
"description": "关键词排名参数 5。"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "关键词排名参数 6。"
},
"history_grouping": {
"enum": [
"daily",
"weekly",
"monthly"
],
"type": "string",
"default": "monthly",
"description": "关键词排名参数 7。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
这些记录描述 Ahrefs 历史中各自然搜索排名区间的关键词数量。前三名数量增加不意味着每个关键词都上升；数量也不是搜索量或访问量。51+ 区间应按来源定义保留。
时间表或趋势概括属于 Agent 的额外分析，应保留实际返回的日期与数量，不假定历史完整、不填补缺口，也不推断分布变化原因。本请求读取已有历史，不会安排持续检查。
查看[https://example.com]从[2026年7月]到[2026年9月]的[每月]记录。统计有多少种不同的搜索内容让网站出现在不含广告的搜索结果前3位、第4–10位、第11–20位、第21–50位或第51位及之后。缺失月份留空。
连接指南
只查看[https://example.com/shoes]从[2026年7月]到[2026年9月]的[每月]记录。统计有多少种不同的搜索内容让这个页面出现在不含广告的搜索结果前3位、第4–10位、第11–20位、第21–50位或第51位及之后。缺失月份留空；不猜测哪些搜索内容发生了变化。
查看[https://example.com]从[2026年7月]到[2026年9月]的[每月]记录。统计有多少种不同的搜索内容让网站出现在不含广告的搜索结果前3位、第4–10位、第11–20位、第21–50位或第51位及之后。缺失月份留空；汇总不会列出具体搜索内容或说明变化原因。
查看[https://example.com]在[美国]从[2026年9月1日]到[2026年9月30日]的[每周]记录。统计有多少种不同的搜索内容让网站出现在不含广告的搜索结果前3位、第4–10位、第11–20位、第21–50位或第51位及之后。缺失周次留空；不猜测数量变化的原因。
报告提供各排名区间的数量，不提供具体关键词名单或精确位置。前三名数量增加本身不能确定哪些词提升了排名。
限制按所选 daily、weekly 或 monthly 分组计算，默认 monthly。每次最多 60 个时间组，并不保证每个分组都有记录。
数量说明已有记录中的分布变化，不说明原因。应保持目标范围、协议、国家及分组一致，结合其他证据后再判断某次更新或操作的影响。