SeerMarTech 文档控制台

Yahoo Organic Live Regular

POST/v3/serp/yahoo/organic/live/regular

实时获取 Yahoo 有机搜索结果。Yahoo 在部分市场仍有一定份额，适合多引擎 SEO 监控与北美流量分析。

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

请求体

参数类型必填说明
keywordstring是搜索关键词
location_codeinteger是地理位置代码，如 2840（美国）
language_codestring是语言代码
devicestring否desktop 或 mobile
depthinteger否结果深度，默认 10

Live 请求示例

curl

curl -X POST "https://api.seermartech.cn/v3/serp/yahoo/organic/live/regular" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "keyword": "best coffee maker",
    "location_code": 2840,
    "language_code": "en",
    "device": "desktop"
  }]'

Python

import requests
 
resp = requests.post(
    "https://api.seermartech.cn/v3/serp/yahoo/organic/live/regular",
    headers={"Authorization": "Bearer smt_live_YOUR_KEY"},
    json=[{
        "keyword": "best coffee maker",
        "location_code": 2840,
        "language_code": "en",
        "device": "desktop",
    }],
    timeout=60,
)
items = resp.json()["tasks"][0]["result"][0]["items"]
print([i.get("url") for i in items[:5]])

TypeScript

const resp = await fetch(
  "https://api.seermartech.cn/v3/serp/yahoo/organic/live/regular",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([{
      keyword: "best coffee maker",
      location_code: 2840,
      language_code: "en",
      device: "desktop",
    }]),
  }
);
const data = await resp.json();
console.log(data.tasks[0].result[0].items.slice(0, 5).map((i: { url?: string }) => i.url));

异步模式（Standard Queue）

批量抓取时使用 task_post → task_get 轮询，成本约为 Live 的 1/3。

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

Step 1：提交任务

POST/v3/serp/yahoo/organic/task_post
curl -X POST "https://api.seermartech.cn/v3/serp/yahoo/organic/task_post" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "best coffee maker", "location_code": 2840, "language_code": "en", "priority": 1}]'

Step 2：获取结果

GET/v3/serp/yahoo/organic/task_get/regular/{task_id}

业务场景

相关文档