SERP API 在排名跟踪中提供什么？

SERP API 返回某个查询和搜索条件下的结果位置。它本身不会定时运行跟踪任务、维护关键词历史、计算可见度份额，也不会解释排名变化原因。这些工作由应用完成。

采集可重复的搜索快照

每次请求都使用相同查询词和市场条件。Google 网页搜索示例：

curl https://api.serqo.io/v1/search \
  -H "x-api-key: $SERP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"意式咖啡磨豆机","engine":"google","type":"web","gl":"cn","hl":"zh-CN","device":"desktop"}'

将原始查询词、engine、type、gl、hl、device 和采集时间与响应一起保存。查询词或市场条件略有变化，就代表另一组观测，应分开记录。

计算页面排名位置

  1. 读取 data.results，查看各项的 type、url、domain 和 position。
  2. 明确报表衡量单个 URL、规范页面，还是域名下任意页面。
  3. 统一 URL 匹配方式，包括重定向、末尾斜杠和 canonical 路径。
  4. “本次响应中未找到”应和数字排名分开表示；目标可能排在当前结果范围之后。
  5. 保留原始快照，方便后续检查链接或解析规则变化。

谨慎比较不同快照

只比较查询词、引擎、类型、国家、语言和设备都一致的记录。找不到结果时应单独记录，不要记成第 0 名。结果页会变化，版面也可能包含自然搜索链接以外的模块。如果报告关注自然排名，应按应用采用的结果类型筛选，不要把地图、新闻等模块混入同一序列。

在自己的系统中设置频率和历史

由你的定时任务决定采集频率。统一时间戳时区，并将原始请求条件与结果一同保存。日均或中位排名、首次出现位置、可见度份额等都是应用自行定义的指标；应记录计算方式，保证不同报告可比较。

常见问题

Serqo 会自动长期跟踪关键词吗？

不会。Serqo 为每次请求返回一份结果；定时采集和历史快照存储由你的系统负责。

能否比较不同国家的搜索排名？

可以，但应将其作为不同市场的观测分别记录。每条数据都保留 gl 和 hl，不要把不同市场合并成一条排名序列。

结果位置是通用排名吗？

不是，它只表示某次返回快照中的位置。比较前先固定结果类型和市场条件，也不要假设所有人看到的结果页都相同。

查看 Google Search API 参考，或了解 Google SERP 请求方式。