SeerMarTech 文档控制台

Yandex Organic Live Regular

POST/v3/serp/yandex/organic/live/regular

实时获取 Yandex 有机搜索结果。Yandex 是俄语区主流搜索引擎，适合俄罗斯、东欧及 CIS 市场的 SEO 监控。

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

请求体

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

Live 请求示例

curl

curl -X POST "https://api.seermartech.cn/v3/serp/yandex/organic/live/regular" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "keyword": "SEO инструменты",
    "location_code": 2643,
    "language_code": "ru",
    "device": "desktop"
  }]'

Python

import requests
 
resp = requests.post(
    "https://api.seermartech.cn/v3/serp/yandex/organic/live/regular",
    headers={"Authorization": "Bearer smt_live_YOUR_KEY"},
    json=[{
        "keyword": "SEO инструменты",
        "location_code": 2643,
        "language_code": "ru",
        "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/yandex/organic/live/regular",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([{
      keyword: "SEO инструменты",
      location_code: 2643,
      language_code: "ru",
      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）

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

Step 1：提交任务

POST/v3/serp/yandex/organic/task_post
curl -X POST "https://api.seermartech.cn/v3/serp/yandex/organic/task_post" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "SEO инструменты", "location_code": 2643, "language_code": "ru", "priority": 1}]'

Step 2：获取结果

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

业务场景

相关文档