SeerMarTech API 文档

主题

数据 API 概览 ​

数据 API 是本平台用于分析的核心数据接口，提供基于不同搜索引擎的数据源，可用于搜索量评估、扩展、站点词挖掘、广告流量测算与趋势分析等场景。

本接口当前覆盖两类数据源：Google 与 Bing。

支持的数据源与接口 ​

Google ​

  • 搜索量 /v3/keywords_data/google_ads/search_volume/live/

  • 网站 /v3/keywords_data/google_ads/keywords_for_site/live/

  • 扩展 /v3/keywords_data/google_ads/keywords_for_keywords/live/

  • 广告流量 /v3/keywords_data/google_ads/ad_traffic_by_keywords/live/

  • Google Trends Explore /v3/keywords_data/google_trends/explore/task_post/

Bing ​

  • 搜索量 /v3/keywords_data/bing/search_volume/live/

  • 网站 /v3/keywords_data/bing/keywords_for_site/live/

  • 扩展 /v3/keywords_data/bing/keywords_for_keywords/live/

  • 表现 /v3/keywords_data/bing/keyword_performance/live/

容性说明 ​

Google Ads 数据接口基于新版 Google Ads API，不再使用旧版 Google AdWords API。

如果你当前仍在使用旧版接口，应升级到 Google Ads 对应路径。可用接口列表建议通过 /v3/keywords_data/endpoints/ 查看。

接口返回结果会受到以下条件影响：

  • language
  • location
  • 各端点特有参数

因此，同一在不同国家、语言、设备或筛选条件下，结果可能不同。

数据限制与合规说明 ​

Google 与 Bing 接口会受到各自广告政策限制。对于以下高风险或受限类别，通常无法返回数据，例如：

  • 武器
  • 烟草
  • 药物
  • 暴力
  • 恐怖主义
  • 受广告平台限制的主题

请特别注意：

如果你一次批量提交多个，例如 100 个，而任意一个命中受限类别，则整批都可能无法返回数据。

因此，建议在批量请求前对做过滤或拆批处理，以减少整批失败的风险。

调用方式 ​

数据接口支持两种主要结果获取方式：Standard 和 Live。

Live 方法 ​

如果你的系统需要即时返回结果，推荐使用 Live 方法。

特点：

  • 单次请求即可直接返回结果
  • 不需要拆分为 POST 建任务 + GET 取结果
  • 适合在线查询、实时分析、前台交互场景

Standard 方法 ​

如果你不要求实时结果，可以使用 Standard 方法。

特点：

  • 需要创建任务，再单独请求结果
  • 成本通常更低
  • 适合批量处理、离线分析、定时采集场景

回调通知 ​

使用 Standard 方法时，你还可以在任务提交时设置以下回调参数：

  • pingback_url：任务完成后通知你的服务
  • postback_url：任务完成后将结果直接推送给你的服务

批量任务处理 ​

当你一次提交多个任务时，可以通过 Tasks Ready 接口获取已完成任务的 id 列表，再使用对应的 Task GET 接口逐个获取结果。

这种方式适合：

  • 大规模库处理
  • 定时任务调度
  • 异步数据管道集成

限流说明 ​

默认，你每分钟最多可发送 2000 次 API 调用。

如果你的业务需要更高吞吐量，可联系平台申请提升限额。

计费说明 ​

数据接口的费用取决于：

  • 调用方法（Standard 或 Live）
  • 任务执行优级
  • 端点类型

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

你也可以通过以下方式核对账户消耗：

  • 在控制台查看接口使用
  • 调用用户数据接口：/v3/appendix/user_data/

沙箱测试 ​

你可以通过沙箱环境验证请求结构、字段格式与集成逻辑，再切换到正式环境发起真实请求。

认证方式 ​

所有请求均应在请求头中携带 Bearer Token：

bash
Authorization: Bearer smt_live_YOUR_KEY

请求格式说明 ​

对于 POST 接口，请求体统一使用 JSON 数组格式：

json
[
 {
 "language_name": "English",
 "location_name": "United States",
 "keywords": [
 "seo tools",
 "keyword research"
 ]
 }
]

调用示例 ​

以下示例展示 Live 类接口的基本调用方式。参数请以对应端点文档为准。

cURL ​

bash
curl -X POST "https://api.seermartech.cn/v3/keywords_data/google_ads/search_volume/live/" \
 -H "Authorization: Bearer smt_live_YOUR_KEY" \
 -H "Content-Type: application/json" \
 -d '[
 {
 "language_name": "English",
 "location_name": "United States",
 "keywords": ["seo tools", "keyword research"]
 }
 ]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/keywords_data/google_ads/search_volume/live/"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

# POST 请求体需为 JSON 数组
payload = [
 {
 "language_name": "English",
 "location_name": "United States",
 "keywords": ["seo tools", "keyword research"]
 }
]

response = requests.post(url, json=payload, headers=headers, timeout=60)
print(response.status_code)
print(response.text)

TypeScript ​

typescript
const url = "https://api.seermartech.cn/v3/keywords_data/google_ads/search_volume/live/";

const payload = [
 {
 language_name: "English",
 location_name: "United States",
 keywords: ["seo tools", "keyword research"],
 },
];

async function main {
 const response = await fetch(url, {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
 body: JSON.stringify(payload),
 });

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

main;

结果与参数说明 ​

本页为概览文档，主要说明数据 API 的能力边界、调用方式与使用限制。以下需以端点文档为准：

-填参数

  • 可选筛选条件
  • 返回字段结构
  • 错误码与异常场景
  • 单次任务支持的数量
  • 计费规则与优级差异

建议在接前逐一查目标接口的详细说明，例如搜索量、扩展、站点词或趋势分析端点。

错误与异常注意事项 ​

接数据接口时，常见问题：

  • 请求体不是 JSON 数组
  • 语言或地区参数无效
  • 批量中受限主题
  • 请求频率每分钟限额
  • Standard 方法下未正确轮询或未处理回调

排查时建议重点：

  • HTTP 状态码
  • 响应中的 status_code
  • 响应中的 status_message
  • 响应中的 cost
  • 任务 id 与结果获取链路是否一致

最佳实践建议 ​

  • 将高风险与普通分批提交，整批无结果
  • 实时业务优使用 Live，离线批处理优使用 Standard
  • 大批量任务结合 pingback_url 或 postback_url 降低轮询成本
  • 对不同国家/语言分别建任务，保证结果可解释性
  • 在批量生产前用沙箱或小样本验证参数与字段

实用场景 ​

  • 挖掘搜索量：评估目标词在不同国家和语言下的需求规模，帮助制定选题和投放优级
  • 扩展长尾：基于种子词获取词与相近词，提升 SEO 词库覆盖率和布局完整度
  • 分析竞品站点用词：通过站点接口识别竞品获取流量的核心主题，栏目规划与页面优化
  • 估算广告机会：结合广告流量接口评估商业词价值，为 SEM 出价和预算分提供依据
  • 监控趋势变化：使用趋势类接口观察热度随时间的变化，识别季节性机会与热点主题切换

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API