Search Analytics API：维度、筛选与分页
先读结论
先定义一行代表什么，再在分页中保持属性、日期、类型、筛选与聚合一致。分页更多不保证全量。页面与查询对应需联合维度，独立排行不能按行号拼接。
适用条件
适用于自动搜索报表开发。当前 AISEO Site 页面列表只取有限 top rows。
打开报告前，先准备这些
准备准确属性、日期、搜索类型、维度、筛选、dataState 及分页参数。
先带一个具体 URL 或报告来检查；共享记录中不要放账号凭据与私有访客数据。
操作与验证
按问题选择行键
要回答哪些查询给这页带点击，应联合 page 与 query，或筛选页面再按 query 分组。记录维度顺序，返回 keys 按同一顺序对应；网域属性字符串形如 sc-domain:example.com。
先用已结束日期和 dataState final。搜索日期采用太平洋时间，跨系统连接保留此口径。更多维度改变细度和可用行，不能无目的全部请求。
保存可复现请求
教学请求：{"startDate":"2026-09-01","endDate":"2026-09-28","type":"web","dimensions":["page","query"],"aggregationType":"auto","rowLimit":1000,"startRow":0,"dataState":"final"}，并非客户属性实际调用。
按任务增加筛选，保存请求和响应。页面维度或筛选不能采用 byProperty，选择支持方式并核对返回聚合。API CTR 为比例，0.02 是 2%，不是 0.02%。
用固定结果定义分页
每次按 rowLimit 增加 startRow，其他参数不变；结果耗尽停止，登记键、错误和收集范围。当前 rowLimit 上限 25,000，更大清单仍需支持分页和有界工作。
返回的是受内部限制的 top rows，相同点击行没有保证稳定排序，近期数据也可能移动。保留重复检查和限制说明，不能把分页当完整查询库证明。
诚实表达遗漏和错误
越过结果集后成功空行，不是授权失败；按 date 分组时无数据日期可能不返回。比较汇总与查询明细，要注明聚合和隐私边界，不能合成隐藏查询。
需要近期数据时标为初步，并核查可用不完整信息。最后保留请求、实际行、数据截止及限制；AISEO Site 当前有限排行在展示和 AI 分析中都应保留边界。
容易犯的错误： 分页到底就叫全部数据
API 返回 top rows 等边界仍影响可得数据，须写清来源限制。
遇到不同情况，怎么决策
先将实际观察与分支对应，再决定修改。无法对应时先补证据，不强行套用。
| 你看到的情况 | 下一步 | 如何确认 |
|---|---|---|
| 页面表与查询表独立 | 不要按行号关联 | 用组合维度或原生过滤 |
| 分页后无新行 | 判断分页边界和限制 | 不称绝对全量 |
| 新鲜数据不完整 | 标注 dataState 与截止 | 不与完整日硬比 |
分页读取顶部行，不会显示所有查询
教学场景：名称、URL 与数字用于解释方法，不是客户或网站实测结果。
- 看到什么
- 教学示例：第一页 100 行，第二页 20 行；另一请求的网页行与查询行分别独立排序。
- 能说明什么
- 末页说明本次请求分页边界，不说明所有可能查询；独立网页与查询表不能按行号关联。
- 接下来怎么做
- 用支持的组合维度或准确筛选回答问题。按返回页大小推进 startRow，保留请求参数并遵守报告限制。
怎样才算核实了结果
检查跨页重复键及参数是否一致，标明数据范围与完整性限制，不称为所有搜索查询。
必需检查失败时，保留错误并回到对应决策分支。记录留空代表未核实，不代表通过。
读完应留下核实结果，而不是另一句泛泛建议
- 本页应交付什么
- 可复现请求及已收集行键清单，保留覆盖限制。
- 遇到这类情况先停下
- 不按顺序拼独立列表，不把分页耗尽当全量查询覆盖。
在下面检查记录中写明缺失证据。未解决检查本身有价值，留空不代表通过。
本页检查单
填写自己的检查结果，再决定下一步。空白代表尚未核实，不代表正常。内容仅保存在本机当前会话，不会提交给服务器或 AI。
常见问题
维度越多越好吗？
更细维度增加复杂度与数据限制，应按真实分析任务查询。
新鲜数据与最终数据能当作同样完整来比吗？
明确 dataState 与最新可用日期；解释变化前对未完整日期单独处理。
官方资料与使用边界
本页提供操作判断与检查方法，不展示客户成功案例。计算例子与请求样例属于教学材料，不是实际网站指标。Google 的报告、条件与界面可能变化，请以当前官方说明为准。
阅读对应 Google 官方说明用对应工具继续处理
用产品的页面与查询视图检查搜索机会；与自建 API 对账时保留相同筛选范围和分页证据。
查看操作与能力范围 →