SeerMarTech API 文档

主题

Google 常规 SERP 数据库 ​

概述 ​

Google 常规 SERP 数据库收录了海量搜索结果页数据，覆盖标准自然结果、付费结果以及精选摘要等常见 SERP素。除结构化的 SERP 明细外，本数据库还提供对应的搜索量、竞价、竞争度、难度、搜索意图等指标，适合用于研究、SERP 分析和 SEO 策略建模。

该数据库支持 JSON 和 CSV 两种格式。

可用套资源：

  • 数据库示例文件：可下载指定地区与语言的样例数据
  • 地区与语言单：可通过接口获取支持的 location_code 与 language_code

计费说明 ​

该数据库的费用取决于的数据规模以及地区参数。

由于平台按数据库规格动态计费，本文不固定列出单价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

数据字段说明 ​

顶层字段 ​

字段名类型说明
keywordstring，采用 UTF-8 编码
locationinteger地区代码，对应地区唯一标识
languagestring语言代码，对应地区下可用语言的唯一标识
spellstring搜索引擎自动纠错后的；当搜索引擎对原进行了修正并返回结果时提供
spell_typestring自动纠错类型

spell_type 可选值：

  • did_you_mean
  • showing_results_for
  • no_results_found_for
  • including_results_for

地区与语言代码获取 ​

可通过以下接口获取支持的地区与语言列表：

/v3/dataforseo_labs/locations_and_languages

示例说明：

  • 2840 表示 United States
  • en 表示 English

keyword_info 对象 ​

返回维度的数据指标。

字段名类型说明
search_volumeinteger月均搜索量，表示该在 google.com 上的大致月搜索次数
cpcfloat平均单次点击成本。该值原始口径为 USD
competitionfloat竞争度，取值范围 0 到 1
competition_levelstring付费搜索竞争等级，可为 LOW、MEDIUM、HIGH，未知时为 null
low_top_of_page_bidfloat广告出现在首页顶部位置的较低竞价参考值，约高于最低出价样本中的 20%
high_top_of_page_bidfloat广告出现在首页顶部位置的较高竞价参考值，约高于最低出价样本中的 80%
time_updatestring数据最近更新时间，ISO 8601 格式
categoriesarray产品与服务分类
historyobject月度搜索量历史数据，表示对应地区下该每月的近似搜索次数

补说明：

  • cpc 基于广告数据推导，返回值来自 high_top_of_page_bid 数据口径
  • low_top_of_page_bid 和 high_top_of_page_bid 会因地区不同而变化
  • time_update 格式示例：2020-09-12T00:07:43.0733218Z

serp_info 对象 ​

返回该对应的 SERP 概览信息。

字段名类型说明
check_urlstring指向搜索结果页的直达链接，可用于核验结果
items_countintegerserp 数组中返回的结果数量
keyword_difficultyinteger难度，表示自然搜索前 10 名的难易程度，范围 0–100
se_results_countinteger搜索引擎结果总量
time_updatestringSERP 数据最近更新时间，ISO 8601 格式
serparray该下识别到的 SERP素列表

补说明：

  • keyword_difficulty 为对数尺度分值，结合 SERP 前 10 页面的链接画像等多项因素计算
  • time_update 格式示例：2020-09-12T00:07:43.0733218Z

serp 数组字段 ​

serp含当前下识别到的各类结果。

字段名类型说明
rank_groupinteger分组排名；在相同 type 的组排序
rank_absoluteintegerSERP 绝对排名；基于整体结果位置排序
typestring结果类型
domainstring结果所属域名
urlstring结果链接
titlestringSERP 标题
descriptionstring结果摘要描述
breadcrumbstring面屑路径
etvfloat预估自然流量
traffic_costfloat将该自然流量通过付费广告获取时的预估成本

type 可选值：

  • organic
  • paid
  • featured_snippet

补说明：

  • rank_group 会忽略不同 type 的位置统计同类型结果中的顺序
  • rank_absolute 为绝对位置，但部分高级 SERP 特性的位置可能不会计该结果集中
  • etv 由 CTR 与搜索量估算得出
  • traffic_cost = 自然流量预估值 etv × 付费点击成本 cpc

extra 对象 ​

返回附加信息。

字段名类型说明
core_keywordstring分组中的核心词
synonym_clustering_algorithmstring识别同义词所使用的算法
detected_languagestring系统识别出的语言
keyword_difficultyinteger难度，范围 0–100

synonym_clustering_algorithm 可选值：

  • keyword_metrics：基于 keyword_info 指标的算法
  • text_processing：基于文本处理的算法

补说明：

  • 若 core_keyword 为 null，表示数据库中未识别到满足条件的同组核心词
  • 若 synonym_clustering_algorithm 为 null，表示未识别出可归类为同义词的结果

search_intent_info 对象 ​

返回搜索意图信息。

字段名类型说明
main_intentstring主要搜索意图
foreign_intentarray补搜索意图
last_updated_timestring搜索意图数据最近更新时间，ISO 8601 格式

main_intent 与 foreign_intent 可选值：

  • informational：信息型
  • navigational：导航型
  • commercial：商业调研型
  • transactional：交易型

时间格式示例：

2022-09-12T00:07:43.0733218Z

数据结构示例 ​

以下为 JSON 数据结构示例：

json
{
 "keyword": "mountain painting",
 "location": 2528,
 "language": "nl",
 "spell": null,
 "spell_type": null,
 "keyword_info": {
 "search_volume": 260,
 "cpc": null,
 "competition": 0.99,
 "competition_level": "HIGH",
 "low_top_of_page_bid": null,
 "high_top_of_page_bid": null,
 "time_update": "2023-03-14T07:02:10.0979701Z",
 "categories": [],
 "history": {
 "202203": 320,
 "202204": 210,
 "202205": 260,
 "202206": 320,
 "202207": 210,
 "202208": 260,
 "202209": 260,
 "202210": 260,
 "202211": 320,
 "202212": 210,
 "202301": 390,
 "202302": 320
 }
 },
 "serp_info": {
 "check_url": "https://www.google.nl/search?q=mountain%20painting&num=100&hl=nl&gl=NL&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCbvkh9vDCcZHEZ8Kvf_OdaGz",
 "items_count": 102,
 "keyword_difficulty": 20,
 "se_results_count": 455000000,
 "time_update": "2023-03-12T22:20:17.3263383Z",
 "serp": []
 },
 "extra": {
 "core_keyword": null,
 "detected_language": "en",
 "keyword_difficulty": 20
 },
 "search_intent_info": {
 "main_intent": "commercial",
 "foreign_intent": [],
 "last_updated_time": "2023-03-03T13:08:27.4586525Z"
 }
}

获取地区与语言列表示例 ​

如果需要确定 location 和 language 的可用取值，可调用地区与语言接口。

cURL ​

bash
curl -X POST "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages" \
 -H "Authorization: Bearer smt_live_YOUR_KEY" \
 -H "Content-Type: application/json" \
 -d '[{}]'

Python ​

python
import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

# POST 请求体为 JSON 数组
payload = [{}]

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

TypeScript ​

typescript
const response = await fetch("https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages", {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 // POST 请求体为 JSON 数组
 body: JSON.stringify([{}])
});

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

使用说明 ​

  • 本页描述的是数据库数据结构，而不是单一实时查询响应格式
  • 数据可用于离线分析、建模、SERP 特征识别和竞品监控
  • 若业务需要更完整的高级 SERP 特性位置数据，应考虑使用支持更丰富结果类型的高级 SERP 数据库
  • 涉及 CPC、流量成本等金额字段时，原始数据口径通常为；如需在业务系统中展示人民币，可按换算规则自行处理

实用场景 ​

  • 筛选高价值：结合 search_volume、competition、keyword_difficulty，识别搜索量高且排名难度可控的词，提升投放和 SEO 选题效率。
  • 分析 SERP 格局：基于 serp 中的 organic、paid、featured_snippet 分布，判断某类的自然位竞争强弱与广告挤压程度。
  • 评估页面流量潜力：通过 etv 与 traffic_cost 估算自然排名页面的流量价值，为栏目建设、落地页优化和资源倾斜提供依据。
  • 构建分组与语义聚类：利用 core_keyword、detected_language 和同义聚类算法信息，对海量进行聚合，支持专题页与矩阵规划。
  • 识别用户搜索意图：依据 main_intent 和 foreign_intent 区分信息型、商业型与交易型，优化类型、转化路径与页面模板设计。

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

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