Google SERP API 概览

POST /v3/serp/google/organic/live/advanced

本接口用于根据指定的、搜索引擎类型、地点、语言、设备类型和操作系统获取 Google 搜索结果。请求通过容路径 /v3/... 提交，接口会根据所选搜索引擎类型和数据获取方式确定。

支持的 Google 搜索引擎类型

排名方式

Google SERP API 支持以下两种排名方式：

排名序号

接口通过以下字段返回搜索结果位置：

rank_group：结果在所属结果组中的位置。
rank_absolute：结果在整个 SERP 页面所有中的绝对位置。

该排名方式适用于所有 Google 搜索引擎类型。

像素排名

像素排名表示结果摘要距离 SERP 页面顶部的像素距离，可用于更精细地衡量搜索结果的视觉位置。

在 Google Organic SERP Advanced 请求中，将 calculate_rectangles 设置为 true，即可获取用于计算像素排名的数据。接口路径为：

/v3/serp/google/organic/live/advanced/

结果匹范围

返回结果由以下请求参数决定：

搜索引擎类型
语言
地点
设备类型
操作系统

本平台会尽可能准确地模拟指定的搜索地点和搜索引擎环境，使返回结果与任务提交时对应参数下的搜索结果保持一致。

每个任务返回的 check_url 可用于检查对应的搜索结果。建议在无痕模式下访问该地址，以确认返回与任务参数匹。

以下个性化因素不会反映在返回结果中：

用户偏好
搜索历史
基于用户身份的个性化搜索因素

设备和操作系统

创建任务时，可以指定以下设备和操作系统组合：

设备类型	可用操作系统
`mobile`	iOS、Android
`desktop`	Windows、macOS

注意： Google News 和 Google Images 当前支持 desktop 设备。可选操作系统为 Windows 和 macOS。

Google SERP 数据获取函数

Google SERP API 提供以下三种数据获取函数：

Regular

Regular 函数支持 Google Organic SERP，用于返回指定、搜索引擎和地点下的前 10 条自然搜索结果及付费搜索结果。

该函数不会完整返回精选摘要及 SERP 扩展。如果需要获取完整的 SERP 页面结构，或获取 Google Maps、Google News、Google Images 数据，请使用 Advanced 函数。

Advanced

Advanced 函数支持所有 Google SERP 搜索引擎类型，可返回完整的搜索结果页面信息各类 SERP素及详细数据。

HTML

HTML 函数返回指定、搜索引擎和地点对应的原始 SERP HTML 页面。

该函数支持所有 Google SERP 搜索引擎类型，但以下类型除外：

Google Maps
Google Events
Search by Image

数据获取方式

Google SERP API 支持 Standard 和 Live 两种主要数据获取方式。

Live

Live 方法适用于需要即时获取结果的场景。提交请求后，接口会直接返回实时结果，不需要再分别调用任务提交接口和任务查询接口。

Standard

Standard 方法适用于不要求实时返回结果的场景。该方式需要提交任务，再通过后续接口获取结果，但通常成本更低。

如果使用 Standard 方法，可以在创建任务时指定以下回调参数：

pingback_url：任务完成后通知指定地址。
postback_url：任务完成后将结果发送到指定地址。

使用 postback_url 时，还需要指定结果获取函数：

regular
advanced
html

如果使用 Standard 方法且未指定 pingback_url 或 postback_url，可以通过 Tasks Ready 接口获取已完成但尚未领取的任务 ID，再通过 Task GET 接口获取任务结果。

请求频率与批量限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准POST 和 GET API 请求，合计计算。

每次 POST 请求最多 100 个任务。
如需提高限制，请联系平台技术支持。

优级与计费

Live 方法实时返回结果，因此通常最高的请求成本。

Standard 方法提供两种任务优级，用于表示任务执行速度：

Normal priority
High priority

Google SERP 请求的扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

可能增加费用的参数

以下参数或可能增加单个任务的费用：

calculate_rectangles
load_async_ai_overview
people_also_ask_click_depth
keyword 中使用搜索运算符
depth过默认值

支持的搜索运算符：

allinanchor:
allintext:
allintitle:
allinurl:
define:
filetype:
id:
inanchor:
info:
intext:
intitle:
inurl:
link:
related:
site:

费用计算方式

如果请求同时使用多个计费参数，最终费用将所选数据获取方式、任务优级及各附加参数计算。

计算如下：

text

cost = B × C × K × (D / 默认值)

：

B：所选方法和优级的基础价格。
C：当 "calculate_rectangles": true 或 "load_async_ai_overview": true 时为 2，否则为 1。
K：当 keyword含额外搜索运算符时为 5，否则为 1。
D：depth 参数值向上取整。
默认值：depth 的默认值。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

认证

请求时使用 Bearer Token 认证：

http

Authorization: Bearer smt_live_YOUR_KEY

示例：

bash

curl -X POST "https://api.seermartech.cn/v3/serp/google/organic/live/advanced" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "keyword": "seo tools",
      "location_code": 2840,
      "language_code": "en",
      "device": "desktop",
      "os": "windows"
    }
  ]'

费用与测试说明

Google SERP API 的最终费用取决于：

数据获取方式：Standard 或 Live
任务优级：Normal 或 High
使用的 SERP 函数：Regular、Advanced 或 HTML
是否启用附加计费参数
depth 参数值
请求中的任务数量

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。可使用沙箱环境测试 Google SERP API 的请求格式和返回结构，路径为：

/v3/appendix/sandbox/

实用场景

监控目标的 Google 自然排名：结合 rank_group 和 rank_absolute 定期采集不同地点、语言和设备下的排名变化，评估 SEO 优化效果。
分析 SERP 页面竞争格局：使用 Advanced 函数获取精选摘要、知识面板、图片等扩展，识别竞争对手占据的搜索结果位置。
评估移动端与桌面端差异：分别提交 mobile 和 desktop 任务，比较不同设备下的排名和 SERP 展示差异，指导移动 SEO 优化。
测量搜索结果的视觉位置：启用 calculate_rectangles 获取页面位置数据，结合像素排名评估结果的可见度。
构建定制化 SERP 监控系统：通过 Standard 方法合 pingback_url 或 postback_url 接收任务结果，降低轮询开销并批量处理监测数据。

Google SERP API 概览 ​

支持的 Google 搜索引擎类型 ​

排名方式 ​

排名序号 ​

像素排名 ​

结果匹范围 ​

设备和操作系统 ​

Google SERP 数据获取函数 ​

Regular ​

Advanced ​

HTML ​

数据获取方式 ​

Live ​

Standard ​

请求频率与批量限制 ​

优级与计费 ​

可能增加费用的参数 ​

费用计算方式 ​

认证 ​

费用与测试说明 ​

实用场景 ​