主题
本平台 Labs API：旧版总览
本页汇总 本平台 Labs API 旧版可用接口。
注意：该 API 结构已于 2022-03-19 更新。本页列出的是旧版接口文档。平台 API 仍持续容支持这一版本。
接口分类
研究
- 站点：返回与目标域名的。
- ：返回来自 Google SERP“搜索”区域的。
- 建议：基于指定种子词，返回前置、后置或插词后的扩展。
- 创意：返回与指定种子词处于相同主题类别的。
- 历史搜索量：返回历史搜索量，以及当前 CPC 和竞争度。
- 批量难度：返回自然搜索前 10 结果的排名难度。
市场维度分析
- 域名分类：按分类返回的总体排名与流量数据。
- 分类：返回最近一个月搜索量、过去 12 个月搜索趋势，以及当前 CPC 和竞争度。
- 分类维度域名指标：返回历史排名、当前及历史 ETV、展示型 ETV、预估付费流量成本等数据。
- Google 热门搜索：返回 AdWords、Bing Ads 指标、商品分类及 Google SERP 数据。
竞品研究
- 域名 Whois 概览：返回来自自然搜索和付费搜索的排名与流量信息。
- 已排名：返回任意域名或 URL 在 SERP 中已有排名的。
- SERP 竞争对手：返回指定对应的竞争域名及排名。
- 竞争域名分析：返回域名在自然搜索和付费搜索中的排名与流量总览。
- 域名交集：返回两个指定域名在同一 SERP 中同时排名的。
- 子域名分析：返回目标域名的子域名，以及在自然和付费搜索中的排名分布。
- 页面：返回指定域名下排名和流量数据的页面。
- 域名排名概览：返回自然搜索与付费搜索的排名和流量概览。
- 历史 SERP：返回指定日期范围的 SERP 历史快，精选摘要及扩展。
- 历史排名概览：返回指定域名在自然与付费搜索中的历史排名和流量数据。
- 页面交集：返回多个指定页面在同一 SERP 中同时排名的。
- 批量流量预估：最多支持对 1,000 个域名返回预估月度流量。
调用方式
本组 API 支持 Live 方法。
这意味着调用时无需拆分为单独的 POST 和 GET 轮询流程，请求后即可直接获得结果。
频率限制
- 默认速率上限：每分钟最多 2000 次 API 调用
- 如需提升限额，请联系本平台支持团队
计费说明
本组接口按请求计费，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
如需查看账户整体消耗，可调用用户数据接口进行查询，例如：
/v3/appendix/user_data/
测试与联调
你可以使用本平台提供的沙箱环境进行测试：
/v3/appendix/sandbox/
认证示例
所有请求均建议通过 Bearer Token 认证：
bash
Authorization: Bearer smt_live_YOUR_KEY调用示例
以下示例展示旧版 Labs 接口的统一调用方式。参数请以对应端点文档为准。
cURL
bash
curl -X POST "https://api.seermartech.cn/v3/dataforseo_labs/keywords_for_site/live/" \
-H "Authorization: Bearer smt_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"target": "example.com",
"location_name": "United States",
"language_name": "English"
}
]'Python
python
import requests
url = "https://api.seermartech.cn/v3/dataforseo_labs/keywords_for_site/live/"
headers = {
"Authorization": "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json"
}
payload = [
{
"target": "example.com",
"location_name": "United States",
"language_name": "English"
}
]
response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.text)TypeScript
typescript
const response = await fetch(
"https://api.seermartech.cn/v3/dataforseo_labs/keywords_for_site/live/",
{
method: "POST",
headers: {
"Authorization": "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify([
{
target: "example.com",
location_name: "United States",
language_name: "English"
}
])
}
);
const data = await response.json;
console.log(data);响应说明
本页为总览页，不各端点完整字段定义。响应通常以下通用信息：
version：接口版本status_code：状态码status_message：状态信息time：请求处理时间cost：本次请求扣费tasks_count：任务数量tasks_error：失败任务数量tasks：任务结果数组
各业务端点在 tasks[].result 下返回对应数据结构，请参考接口文档。
常见说明
- 旧版接口仍可继续使用，但建议新接前确认是否需要容旧结构。
- 本组接口适用于研究、市场分析、竞品发现、历史排名分析等 SEO 场景。
- 如需更高吞吐或批量分析能力，可按业务拆分调用不同端点。
实用场景
- 挖掘行业池：基于种子词、站点或分类批量获取候选，快速扩规划与投放词库。
- 分析竞品自然流量来源：查看竞品域名的已排名、页面和子域名结构，定位核心流量。
- 识别竞争强度：结合难度、CPC、竞争度与历史搜索量，筛选更产出比的目标词。
- 发现市场机会交集：通过域名交集、页面交集和 SERP 竞争对手分析，找出与你业务最直接的搜索竞争对象。
- 追踪历史排名变化：利用历史 SERP 和历史排名概览，复盘算法波动、改版或投放策略带来的影响。