常规 SERP 数据库

概述

常规 SERP 数据库收录了 5 亿条 Google 搜索结果页数据，标准自然结果与付费结果。

该数据库支持两种交付格式：

• JSON
• CSV

说明：这是一个旧版说明页。若需查看新版目录结构，可参考 /v3/databases/google/serp_regular/ 的文档。

计费说明

该数据库的费用取决于数据集的规模以及地理位置参数。

原文未提供固定单价，因此无法直接换算为人民币参考价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

字段说明

顶层字段

字段名	类型	说明
keyword	string	搜索，采用 UTF-8 编码。
location	integer	地区代码，对应目标地区的唯一标识。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用 location_code 列表。例如：2840 表示美国。
language	string	语言代码，对应指定地区下可用语言的唯一标识。可通过 /v3/dataforseo_labs/locations_and_languages 获取可用 language_code 列表。例如：en 表示英语。
spell	string	搜索引擎自动纠错后的。如果搜索引擎对原词做了纠正，这里会返回纠正后的词；如果未纠错，则为 null。
spell_type	string	自动纠错类型。可能值：did_you_mean、showing_results_for、no_results_found_for。未纠错时为 null。
keyword_info	array	返回的数据。
bing_keyword_info	array	基于 Bing Ads 的数据。注意：Bing 数据在部分地区和语言下可用。
serp_info	array	当前可用的 SERP 数据概况。
extra	array	的附加信息。

keyword_info 字段

字段名	类型	说明
search_volume	integer	平均月搜索量。表示指定在 Google 上的大致月均搜索次数，范围可能基于 google.com 或合作网络。
cpc	float	平均点击成本，单位为。表示该历史平均 CPC。
competition	float	竞争度，取值范围 0 到 1。基于广告数据，表示竞价竞争强度。
time_update	string	数据最近更新时间。原说明示例格式为“month/day/year hours:minutes:seconds UTC”，示例数据中也可能返回 ISO 8601 时间。
categories	array	产品与服务分类。
history	array	月度搜索量历史数据，表示该在指定地区的历史月搜索次数。

bing_keyword_info 字段

字段名	类型	说明
search_volume	integer	Bing 最近一个月的搜索量。
time_update	string	数据最近更新时间，采用 ISO 8601 格式，例如：2020-09-12T00:07:43.0733218Z。
history	array	Bing 月度搜索量历史数据。

serp_info 字段

字段名	类型	说明
check_url	string	搜索结果页直达链接，可用于核对返回结果是否与搜索引擎页面一致。
items_count	integer	serp 数组中返回的结果数量。
keyword_difficulty	integer	难度，范围 0 到 100。表示该自然结果前 10 的难易程度，基于对 SERP 前 10 页面链接画像等因素分析得出。
se_results_count	integer	搜索结果总量。
time_update	string	SERP 数据最近更新时间。原说明示例格式为“month/day/year hours:minutes:seconds UTC”，示例数据中也可能返回 ISO 8601 时间。
serp	array	当前下采集到的 SERP素。

serp 数组字段

字段名	类型	说明
rank_group	integer	分组排名。在相同 type素组的位置；不同 type 的不会计该排名。
rank_absolute	integer	绝对排名。表示该在 SERP 中的绝对位置。注意：返回结果按升序排列，但高级 SERP 功能位可能被省略。若需获取高级 SERP 功能与富摘要在的完整位置数据，请参考高级 SERP 数据库。
type	string	SERP素类型。可能值：organic、paid、featured_snippet。
domain	string	结果所属域名。
url	string	结果 URL。
title	string	搜索结果标题。
description	string	搜索结果摘要描述。
breadcrumb	string	搜索结果中的面屑路径。
etv	float	预估自然流量。通常根据搜索量与 CTR 估算某 URL 对应域名的月度自然流量。
impressions_etv	float	基于量估算的自然流量。
traffic_cost	float	预估流量成本。表示将该 URL 当前获得的自然流量通过付费广告获取时的估算月成本，通常由自然流量估值与付费 CPC 推导得出。

extra 字段

字段名	类型	说明
core_keyword	string	分组中的核心词。表示在 keyword_info 维度上与当前相似的一组词中的主；若无匹分组，则为 null。

地区与语言代码获取

可通过以下容路径获取支持的地区与语言代码：

/v3/dataforseo_labs/locations_and_languages

示例地址：

https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages

数据结构示例

下面是该数据库 JSON 格式的结构示例：

{
 "keyword": "العقارات للبيع",
 "location": 2818,
 "language": "ar",
 "spell": null,
 "spell_type": null,
 "keyword_info": {
 "search_volume": 1900,
 "cpc": 0.39376,
 "competition": 0.4347943722943723,
 "time_update": "2021-04-17T22:38:34.6370679Z",
 "categories": [],
 "history": {
 "202004": 1600,
 "202005": 1900,
 "202006": 2400,
 "202007": 1900,
 "202008": 2400,
 "202009": 1900,
 "202010": 1600,
 "202011": 1600,
 "202012": 1300,
 "202101": 1600,
 "202102": 1300,
 "202103": 1600
 }
 },
 "bing_keyword_info": null,
 "serp_info": {
 "check_url": "https://www.google.com.eg/search?q=%D8%A7%D9%84%D8%B9%D9%82%D8%A7%D8%B1%D8%A7%D8%AA%20%D9%84%D9%84%D8%A8%D9%8A%D8%B9&num=100&hl=ar&gl=EG&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCek2XMN2iTYUEUTExCUJoEUs",
 "items_count": 101,
 "keyword_difficulty": 67,
 "se_results_count": 56900000,
 "time_update": "2021-04-13T17:41:57.4277307Z",
 "serp": [
 {
 "rank_group": 86,
 "rank_absolute": 86,
 "type": "organic",
 "domain": "www.elbalad.news",
 "url": "https://www.elbalad.news/4659640",
 "title": "قبل شراء شقة.. تعرف على إجراءات البيع ونقلية بالشهر ...",
 "description": "وزارة العدل أكدت أنه خفض توثيق العقارات بالشهر العقاري لتصل إلى 2000 جنيه كحد أقصى عن الوحدة العقارية ، زادتاحتها أوتها.",
 "breadcrumb": "https://www.elbalad.news › ...",
 "etv": 3.9899999999999998,
 "impressions_etv": 0,
 "traffic_cost": 1.5711024
 },
 {
 "rank_group": 87,
 "rank_absolute": 87,
 "type": "organic",
 "domain": "www.linkedin.com",
 "url": "https://www.linkedin.com/company/%D8%A8%D9%8A%D8%B9-%D9%88%D8%B4%D8%B1%D8%A7%D8%A1-%D9%84%D9%84%D8%B9%D9%82%D8%A7%D8%B1%D8%A7%D8%AA",
 "title": "بيع وشراء للعقارات | LinkedIn",
 "description": "بيع وشراء للعقارات | 404 followers on LinkedIn. بيع وشراء هو اقوى العقارية فى سهولة البحث وسهولة التسجيل وتحظى الشركات العقاريةكة والافراد ...",
 "breadcrumb": "https://www.linkedin.com › company › بيع-وشراء-للعقا...",
 "etv": 3.9899999999999998,
 "impressions_etv": 0,
 "traffic_cost": 1.5711024
 }
 ]
 },
 "extra": {
 "core_keyword": "عقارات للبيع"
 }
}

使用说明

该页面描述的是“常规 SERP 数据库”的数据结构本身，不是一个独立的任务型接口说明页。因此这里主要用于帮助你理解数据库导出中的字段含义、类型与业务解释。

如果你在本平台数据库接口或导出文件中使用该数据结构，建议重点以下字段：

• 用 keyword、location、language 确定查询语境
• 用 spell、spell_type 识别搜索引擎纠错行为
• 用 keyword_info.search_volume、cpc、competition 判断商业价值
• 用 serp_info.keyword_difficulty 评估自然排名难度
• 用 serp 数组分析排名页面、标题、摘要、域名及流量价值
• 用 extra.core_keyword 做聚类或主题归并

注意事项

1. rank_absolute 可能不会所有高级 SERP素位置，因此不适合用来还原完整富结果布局。
2. bing_keyword_info 在部分地区与语言下可用，返回 null 属于正常。
3. categories、history 等字段可能因数据覆盖不同而为空或缺失部分月份。
4. 时间字段在不同数据块中可能采用不同格式，接时建议按响应做容解析。
5. cpc 与 traffic_cost 原始单位为；如需报表统一为人民币，建议在业务侧自行换算。

实用场景

• 评估价值：结合 search_volume、cpc、competition，筛选高商业价值且竞争可控的目标词。
• 分析自然结果格局：读取 serp 中的 domain、title、rank_absolute，识别当前 SERP 的主导站点与类型。
• 判断 SEO 切难度：依据 keyword_difficulty 和前排结果质量，评估新页面前 10 的可行性。
• 识别搜索意图修正：通过 spell 与 spell_type 判断用户是否被搜索引擎改写，优化归类与投放策略。
• 进行竞品流量估算：使用 etv 与 traffic_cost 粗略估算竞品页面的自然流量价值，优级排序。