数据实验室 API 总览

概述

数据实验室 API 是进行研究与搜索分析的重要数据来源。本接口基于平台 API 的数据库，提供、SERP 以及域名的数据能力。

该 API 的端点按搜索引擎或平台维度划分，目前可获取以下来源的、竞争对手与排名信息：

Google：/v3/dataforseo_labs/google/overview/
Amazon：/v3/dataforseo_labs/amazon/overview/
Google Play：/v3/dataforseo_labs/google_play/overview/
App Store：/v3/dataforseo_labs/app_store/overview/

如果你需要围绕该 API 的常见问题、使用限制或最佳实践进行进一步接，可结合对应端点文档与参考文档使用。

请求方式

数据实验室 API 支持 Live 实时调用方式。

这意味着：

无需拆分为单独的 POST 与 GET 两步请求
直接调用对应端点即可获取即时结果
适合需要实时返回分析数据的业务场景

调用限制

使用本接口时，请注意以下限流规则：

每分钟最多 2000 次 API 调用
同时并发请求数上限为 30

如需更高额，请联系本平台支持团队评估。

计费说明

该 API 按请求计费。费用会因端点与请求参数而有所不同。

说明如下：

实扣费以响应头 X-SeerMarTech-Charge-CNY 为准
可通过用户数据接口单独查询账户消耗
如需联调或功能验证，可优使用沙箱能力进行测试

认证方式

调用 API 时，请在请求头中携带 Bearer Token：

bash

Authorization: Bearer smt_live_YOUR_KEY

基础地址

所有示例请求均使用以下基础地址：

text

https://api.seermartech.cn

请求格式

对于 POST 接口，请使用 JSON 数组作为请求体：

json

[
 {
 "example": "value"
 }
]

接口路径结构

数据实验室 API 的容路径保留如下：

/v3/dataforseo_labs/google/...
/v3/dataforseo_labs/amazon/...
/v3/dataforseo_labs/google_play/...
/v3/dataforseo_labs/app_store/...

这些路径为容 API 路径，调用时需原样保留。

调用示例

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

cURL

bash

curl -X POST "https://api.seermartech.cn/v3/dataforseo_labs/google/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/google/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, timeout=60)
print(response.status_code)
print(response.text)

TypeScript

typescript

const url = "https://api.seermartech.cn/v3/dataforseo_labs/google/keywords_for_site/live";

const payload = [
 {
 target: "example.com",
 location_name: "United States",
 language_name: "English"
 }
];

// 发起实时请求
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(data);

响应说明

不同子端点返回的数据结构会有所差异，但通常会以下通用信息：

字段	类型	说明
`version`	string	API 版本号
`status_code`	integer	响应状态码
`status_message`	string	响应状态说明
`time`	string	请求处理耗时
`cost`	number	本次请求扣费金额
`tasks_count`	integer	本次请求中的任务数量
`tasks_error`	integer	失败任务数量
`tasks`	array	任务结果列表

tasks 数组中的每个任务通常会进一步任务状态、参数以及结果数据。请以端点的字段说明为准。

常见错误与注意事项

场景	说明
请求体不是数组	POST 请求体为 JSON 数组格式，即 `[{...}]`
并发过高	同时请求数 30 时，可能被限流
QPM限	每分钟调用次数 2000 时，可能返回限流错误
认证失败	请检查 `Authorization: Bearer smt_live_YOUR_KEY` 是否正确
参数不匹	不同搜索引擎子端点支持的参数可能不同，应以对应接口文档为准

适用范围

你可以基于该 API 构建以下类型的数据能力：

研究
自然搜索竞争分析
域名可见度与排名分析
SERP 机会挖掘
电商与应用市场搜索洞察

子模块导航

按平台划分的主要模块如下：

平台	概览路径
Google	`/v3/dataforseo_labs/google/overview/`
Amazon	`/v3/dataforseo_labs/amazon/overview/`
Google Play	`/v3/dataforseo_labs/google_play/overview/`
App Store	`/v3/dataforseo_labs/app_store/overview/`

实用场景

挖掘机会：围绕目标站点、行业或竞品获取与排名数据，制定规划与自然流量增长策略。
分析搜索竞争格局：识别同一集合下的主要竞争域名，评估竞品覆盖范围与流量争夺强度。
监控站点排名表现：结合域名与维度的数据，持续跟踪搜索可见度变化，及时发现排名波动。
评估平台搜索潜力：分别从 Google、Amazon、Google Play、App Store 等渠道观察搜索需求差异，为电商与应用增长提供依据。
支持选题与投放决策：利用、SERP 与竞争数据判断高价值主题，提升 SEO生产和投放资源分效率。

数据实验室 API 总览 ​

概述 ​

请求方式 ​

调用限制 ​

计费说明 ​

认证方式 ​

基础地址 ​

请求格式 ​

接口路径结构 ​

调用示例 ​

cURL ​

Python ​

TypeScript ​

响应说明 ​

常见错误与注意事项 ​

适用范围 ​

子模块导航 ​

实用场景 ​