趋势 API：概览

趋势 API 用于分析热度趋势，提供在一段时间的热度变化，以及指定地区的热度数据。本平台通过自有算法计算热度，可作为 Google Trends API 的替代方案。

目前，趋势 API 支持以下数据源：

Google 搜索
Google 新闻
Google 购物

后续将逐步扩展更多数据源。

接口列表

趋势 API 当前提供以下接口，均使用实时查询方式：

功能	方法	路径	说明
探索趋势	POST	`/v3/keywords_data/dataforseo_trends/explore/live/`	获取指定时间范围的热度趋势数据，用于构建详细的趋势图
子区域度	POST	`/v3/keywords_data/dataforseo_trends/subregion_interests/live/`	衡量在指定地区中的热度，并比较不同在单个地区或地区中的热度
人口统计	POST	`/v3/keywords_data/dataforseo_trends/demography/live/`	按年龄和性别拆分热度数据
合并数据	POST	`/v3/keywords_data/dataforseo_trends/merged_data/live/`	返回上述接口整合后的综合趋势数据

热度计算方式

本平台会根据与以下的程度计算热度：

网页
新闻文章
购物商品列表
每条自身的受欢迎程度

此外，算法还会结合来自多个来源的匿名用户网页行为数据，以提升趋势分析的参考价值。

当请求中指定两个或以上时，可以在相对尺度上比较它们的热度。单次请求最多支持比较 5 个。

请求方式

趋势 API 支持 Live 实时查询：

无需提交任务，再通过 GET 请求获取结果
调用接口后会直接返回分析结果平台限流以认证说明中的 30/60/120 次/分钟规则为准**
如需提升调用频率限制，请联系本平台技术支持

实时接口使用 POST 请求，请求体采用 JSON 数组格式：

json

[
  {
    "keywords": [" A", " B"],
    "location_code": 2840,
    "date_from": "2024-01-01",
    "date_to": "2024-12-31"
  }
]

> 请求参数及响应字段，请以对应功能接口的参数说明为准。

认证方式

请求时在 HTTP Header 中传 Bearer Token：

http

Authorization: Bearer smt_live_YOUR_KEY

调用示例

cURL

bash

curl -X POST "https://api.seermartech.cn/v3/keywords_data/dataforseo_trends/explore/live/" \
  -H "Authorization: Bearer smt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "keywords": ["人工智能", "机器学习"],
      "location_code": 2840,
      "date_from": "2024-01-01",
      "date_to": "2024-12-31"
    }
  ]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/keywords_data/dataforseo_trends/explore/live/"
headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}
payload = [
    {
        "keywords": ["人工智能", "机器学习"],
        "location_code": 2840,
        "date_from": "2024-01-01",
        "date_to": "2024-12-31",
    }
]

response = requests.post(url, headers=headers, json=payload)
print(response.json())

TypeScript

typescript

const response = await fetch(
  "https://api.seermartech.cn/v3/keywords_data/dataforseo_trends/explore/live/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify([
      {
        keywords: ["人工智能", "机器学习"],
        location_code: 2840,
        date_from: "2024-01-01",
        date_to: "2024-12-31",
      },
    ]),
  }
);

const data = await response.json();
console.log(data);

计费说明

本页未列出接口单价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

趋势数据的费用通常与调用接口的次数及请求，建议在生产环境中根据返回结果记录每次请求的扣费。

实用场景

识别季节性波动，提前安排发布和 SEO 资源，降低淡旺季流量波动影响。
比较多个的相对热度，选择更搜索潜力的主题，优化布局和选题。
分析不同地区的度，制定区域化 SEO、广告投放和本地化策略。
拆分目标人群的年龄与性别热度，用户画像分析和、商品定向。
整合时间、地区和人口统计趋势数据，评估市场需求变化，为产品规划和营销决策提供依据。

趋势 API：概览 ​

接口列表 ​

热度计算方式 ​

请求方式 ​

认证方式 ​

调用示例 ​

cURL ​

Python ​

TypeScript ​

计费说明 ​

实用场景 ​