SeerMarTech 文档控制台

Google Trends Live

POST/v3/keywords_data/google_trends/explore/live

查询关键词在 Google Trends 中的热度趋势，支持 Google Search、YouTube、Images、Shopping 等平台维度。适合内容日历规划、季节性选题与话题监控。

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

请求体

参数类型必填说明
keywordsarray是关键词列表（通常 1–5 个对比）
location_codeinteger否地区代码
language_codestring否语言代码
date_fromstring否起始日期 YYYY-MM-DD
date_tostring否结束日期 YYYY-MM-DD
typestring否web / youtube / images / news / froogle

请求示例

curl

curl -X POST "https://api.seermartech.cn/v3/keywords_data/google_trends/explore/live" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "keywords": ["AI SEO", "generative engine optimization"],
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2024-01-01",
    "date_to": "2025-12-31",
    "type": "web"
  }]'

Python

import requests
 
resp = requests.post(
    "https://api.seermartech.cn/v3/keywords_data/google_trends/explore/live",
    headers={"Authorization": "Bearer smt_live_YOUR_KEY"},
    json=[{
        "keywords": ["AI SEO", "generative engine optimization"],
        "location_code": 2840,
        "language_code": "en",
        "date_from": "2024-01-01",
        "date_to": "2025-12-31",
        "type": "web",
    }],
    timeout=120,
)
result = resp.json()["tasks"][0]["result"][0]
print(result.get("items", [])[:2])

TypeScript

const resp = await fetch(
  "https://api.seermartech.cn/v3/keywords_data/google_trends/explore/live",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([{
      keywords: ["AI SEO", "generative engine optimization"],
      location_code: 2840,
      language_code: "en",
      date_from: "2024-01-01",
      date_to: "2025-12-31",
      type: "web",
    }]),
  }
);
console.log((await resp.json()).tasks[0].result[0]);

异步模式

大批量或历史区间查询可使用 task_post → task_get：

POST/v3/keywords_data/google_trends/explore/task_post
GET/v3/keywords_data/google_trends/explore/task_get/{task_id}

业务场景

相关文档