SeerMarTech 文档控制台

域名排名词 Live

POST/v3/dataforseo_labs/google/ranked_keywords/live

获取指定域名当前在 Google 有机搜索中排名的关键词列表，含排名位置、搜索量、URL。竞品词库挖掘的核心端点。

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

请求体

参数类型必填说明
targetstring是目标域名
location_codeinteger是目标市场代码
language_codestring是语言代码
limitinteger否返回词数
filtersarray否过滤条件，如 search_volume 范围

请求示例

curl

curl -X POST "https://api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"target": "competitor.com", "location_code": 2156, "language_code": "zh", "limit": 100}]'

Python

import requests
 
resp = requests.post(
    "https://api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live",
    headers={"Authorization": "Bearer smt_live_YOUR_KEY"},
    json=[{"target": "competitor.com", "location_code": 2156, "language_code": "zh", "limit": 100}],
    timeout=120,
)
for item in resp.json()["tasks"][0]["result"][0]["items"][:10]:
    kd = item.get("keyword_data", {})
    print(kd.get("keyword"), item.get("ranked_serp_element", {}).get("serp_item", {}).get("rank_absolute"))

TypeScript

const resp = await fetch(
  "https://api.seermartech.cn/v3/dataforseo_labs/google/ranked_keywords/live",
  {
    method: "POST",
    headers: { Authorization: "Bearer smt_live_YOUR_KEY", "Content-Type": "application/json" },
    body: JSON.stringify([{ target: "competitor.com", location_code: 2156, language_code: "zh", limit: 100 }]),
  }
);
console.log((await resp.json()).tasks[0].result[0].items.slice(0, 10));

业务场景