Google Organic Live Regular

POST/v3/serp/google/organic/live/regular

实时获取 Google 有机搜索结果（默认约 10 条），适合排名监控、轻量 SERP 快照。相比 Advanced 版返回字段更少，但延迟与 cost 相近，适合只需 URL/标题/排名的场景。

参考价：约 ¥0.0320 / 次（实际以请求返回为准）

请求体

请求体为 JSON 数组，每项为一次 SERP 任务：

参数	类型	必填	说明
keyword	string	是	搜索关键词
location_code	integer	是	地理位置代码，如 2156（中国）
language_code	string	是	语言代码，如 zh、en
device	string	否	desktop 或 mobile，默认 desktop
depth	integer	否	结果深度，Regular 默认 10，最大 100

与 Advanced 的区别

对比项	Regular	Advanced
默认结果数	10	100
返回字段	基础有机结果	含广告、精选摘要、PAA 等全类型
适用场景	排名监控、批量快照	完整 SERP 分析、竞品研究

请求示例

curl


curl -X POST "https://api.seermartech.cn/v3/serp/google/organic/live/regular" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "keyword": "SEO工具",
    "location_code": 2156,
    "language_code": "zh",
    "device": "desktop"
  }]'

Python


import requests
 
API_KEY = "smt_live_YOUR_KEY"
payload = [{
    "keyword": "SEO工具",
    "location_code": 2156,
    "language_code": "zh",
    "device": "desktop",
}]
 
resp = requests.post(
    "https://api.seermartech.cn/v3/serp/google/organic/live/regular",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json=payload,
    timeout=60,
)
data = resp.json()
print("charge_cny:", resp.headers.get("X-SeerMarTech-Charge-CNY"))
print("rank_1:", data["tasks"][0]["result"][0]["items"][0]["url"])

TypeScript


const API_KEY = "smt_live_YOUR_KEY";
 
const resp = await fetch(
  "https://api.seermartech.cn/v3/serp/google/organic/live/regular",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify([{
      keyword: "SEO工具",
      location_code: 2156,
      language_code: "zh",
      device: "desktop",
    }]),
  }
);
 
const data = await resp.json();
console.log("charge_cny:", resp.headers.get("X-SeerMarTech-Charge-CNY"));

响应

响应结构与上游官方文档一致。tasks[0].cost 为本次美元费用；响应头 X-SeerMarTech-Charge-CNY 为人民币扣费。