提供域名或 URL 和起始日期，对比历史上每月自然搜索与付费搜索流量的估算。可按日、周或月组织日期，一次请求的范围最多覆盖 60 个分组。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Ahrefs
提供域名或 URL 和起始日期，对比历史上每月自然搜索与付费搜索流量的估算。可按日、周或月组织日期，一次请求的范围最多覆盖 60 个分组。
获得按日期记录、分别展示自然搜索与付费搜索流量估算的历史数据。Agent 可整理已有日期、绘制图表或进行对比，呈现所选时段内估算值的变化。
按月查看[https://example.com]从[2026年7月1日]到[2026年9月30日]来自不含广告的搜索结果和搜索广告的访问量估算，并分开列出。缺少月份保持未知；这些是估算，不是实际访问量。日期范围超过60个月时，先请我缩短范围。
按日或周分组，不代表返回实测日访问量或周访问量；指标仍是每月搜索流量估算，不是会话数或全渠道访问统计。历史覆盖、日期缺失和数据源计算设置会影响比较，数值变化本身不能说明原因。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
queryParamsqueryParams | object | 必填 |
|
目标范围queryParams.mode | string | 选填 | exact：该 URL；prefix：以目标开头的 URL；domain：域名，不含子域名；subdomains：域名及其子域名。默认 subdomains。
|
目标域名或 URLqueryParams.target | string | 必填 | 必填的非空域名或 URL，例如 example.com 或 https://example.com/page。
|
国家queryParams.country | string | 选填 | 可选的两位 ISO 3166-1 alpha-2 国家代码，例如 us，用于选择搜索市场。省略时的行为未明确。
|
结束日期queryParams.date_to | string | 选填 | 可选的结束日期，格式为 YYYY-MM-DD，默认今天；不保证最新日期的数据已经可用。
|
目标协议queryParams.protocol | string | 选填 | 目标 URL 的协议，可选 both、http 或 https，默认 both。自然搜索和付费搜索是分别统计的流量，不是协议选项。
|
起始日期queryParams.date_from | string | 必填 | 必填的历史时段起点，格式为 YYYY-MM-DD。
|
日期分组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": "目标域名或 URL。"
},
"target": {
"type": "string",
"minLength": 1,
"description": "开始日期。"
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "结束日期。"
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "时间粒度。"
},
"protocol": {
"enum": [
"both",
"http",
"https"
],
"type": "string",
"default": "both",
"description": "地区。"
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "设备类型。"
},
"history_grouping": {
"enum": [
"daily",
"weekly",
"monthly"
],
"type": "string",
"default": "monthly",
"description": "指标。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
每条记录的日期用于定位历史估算，不是获取报告的时间。收到结果后，Agent 可以按日期整理并计算差值。
比较时段时，应保持目标范围、国家、协议和分组一致。不要把日期缺口连接成连续的实测序列，也不要假定改变分组后会保留完全相同的代表值。
Ahrefs 历史指标文档介绍了数据源的流量指标。
按月查看[https://example.com]从[2026年7月1日]到[2026年9月30日]的结果，分别列出来自不含广告的搜索结果和搜索广告的访问量估算，并标出没有数据的月份。
连接指南
查看[https://example.com]在[美国]从[2026年7月1日]到[2026年9月30日]的月度估算。所选国家对应的是搜索数据，不代表真实访客所在地。
按月查看[https://example.com]从[2026年7月1日]到[2026年9月30日]来自不含广告的搜索结果和搜索广告的访问量估算，并分开列出。缺少月份保持未知；这些是估算，不是实际访问量。日期范围超过60个月时，先请我缩短范围。
查看[https://example.com]从[2026年7月1日]到[2026年9月30日]的月度结果。没有数据的月份保留为未知；访问量是估算，变化本身不能说明原因。
不能。即使按日分组，每个日期对应的仍是每月流量估算。相加不能得到实测月访问量或累计访客数。
不代表。可用历史可能有缺口，缺失数据不是零值测量。结束日期选择今天，也不保证今天的估算已经可用。
它只显示数据源估算的变化，不能说明原因。比较时保持范围、国家和分组一致，再结合其他证据判断变化是否与活动有关。