Google 常规 SERP 数据库

GET /v3/dataforseo_labs/locations_and_languages

数据库概述

Google 常规 SERP 数据库数百万个 Google 搜索结果页面，覆盖标准自然搜索结果、付费搜索结果和精选摘要。除 SERP素的结构化数据外，数据库还提供的搜索量、点击价格、竞争度、难度等指标。

数据库支持以下格式：

• JSON
• CSV

数据库按、地区和语言组织。示例数据可参考美国地区、英语环境下的 JSON 数据样本。

如需获取支持的地区和语言列表，可调用：

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

认证示例：

curl --request GET \
  --url https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages \
  --header 'Authorization: Bearer smt_live_YOUR_KEY'

例如：

• location: 2840 表示美国
• language: en 表示英语

计费说明

费用取决于数据库的规模和地区参数。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

字段说明

顶层字段

字段	类型	说明
keyword	string	，使用 UTF-8 编码。
location	integer	地区代码，对应地区的唯一标识。
language	string	语言代码，对应地区可用语言的唯一标识。
spell	string	搜索引擎自动修正后的。如果搜索引擎针对修正后的返回结果，则该字段修正后的。
spell_type	string	自动修正类型。可能值：did_you_mean、showing_results_for、no_results_found_for、including_results_for。
keyword_info	object	返回的指标数据。
serp_info	object	返回对应的 SERP 数据。
extra	object	的附加信息。
search_intent_info	object	返回的搜索意图数据。

keyword_info 字段

字段	类型	说明
search_volume	integer	平均月搜索量，表示该在 Google 搜索中的近似月搜索次数。
cpc	float	每次点击费用。表示历史上该的平均点击价格，原始指标以计。由于广告平台不单独提供 CPC 数据，该字段基于 high_top_of_page_bid 计算。
competition	float	竞争度，基于广告数据计算，取值范围为 0 至 1，边界值。
competition_level	string	付费 SERP 中的竞争等级。可能值：LOW、MEDIUM、HIGH。如果无法确定，则返回 null。
low_top_of_page_bid	float	广告显示在首页顶部所需的最低出价。该值大致高于广告展示时最低出价的 20% 分位值，并可能因地区而异。
high_top_of_page_bid	float	广告显示在首页顶部所需的较高出价。该值大致高于广告展示时最低出价的 80% 分位值，并可能因地区而异。
time_update	string	指标的最近更新时间，采用 ISO 8601 格式，例如 2020-09-12T00:07:43.0733218Z。
categories	array	产品和服务类别。
history	object	月度搜索量历史数据，表示指定地区中该的近似月搜索次数。对象键通常采用 YYYYMM 格式。

serp_info 字段

字段	类型	说明
check_url	string	指向搜索结果页面的直接 URL，可用于验证返回的 SERP 是否准确。
items_count	integer	serp 数组中返回的结果数量。
keyword_difficulty	integer	前 10 个自然搜索结果的难度，采用 0 至 100 的对数尺度计算。该指标会综合分析 SERP 前 10 个页面的链接等数据。
se_results_count	integer	SERP 中的结果总数。
time_update	string	SERP 数据的最近更新时间，采用 ISO 8601 格式，例如 2020-09-12T00:07:43.0733218Z。
serp	array	指定对应的 SERP素数据。

serp 数组字段

字段	类型	说明
rank_group	integer	分组排名。在 type 相同的一组 SERP素中的位置。不同类型之间不会计算到同一个 rank_group 中。
rank_absolute	integer	绝对排名。在所有已发现 SERP素中的绝对位置。返回值按升序排列。部分高级 SERP 特性可能不会计该排名；如需完整的高级 SERP 特性及富摘要排名，请参考高级 SERP 数据库。
type	string	SERP素类型。可能值：organic（自然结果）、paid（付费结果）、featured_snippet（精选摘要）。
domain	string	SERP 中的域名。
url	string	结果对应的 URL。
title	string	SERP 结果标题。
description	string	SERP 结果描述。
breadcrumb	string	SERP 中显示的面屑路径。
etv	float	预计流量值，表示该 URL 每月可能获得的自然搜索流量。通常根据点击率与该 URL 排名的搜索量计算。
traffic_cost	float	预计流量成本，表示通过付费搜索广告获取同等自然流量所需的月度广告成本。该指标通常由自然流量估算值 etv 与付费点击价格 cpc 相乘得到。

extra 字段

字段	类型	说明
core_keyword	string	分组中的核心。用于标识在指标等方面相似性的组。如果数据库中没有符合条件的，则返回 null。
synonym_clustering_algorithm	string	用于识别同义词的算法。可能值：keyword_metrics（基于指标）、text_processing（基于文本处理）。如果相应算法未识别出与当前同义的，则返回 null。
detected_language	string	系统识别出的语言。
keyword_difficulty	integer	前 10 个自然搜索结果的难度，取值范围为 0 至 100。

search_intent_info 字段

字段	类型	说明
main_intent	string	主要搜索意图。可能值：informational（信息型）、navigational（导航型）、commercial（商业调查型）、transactional（交易型）。
foreign_intent	array	补搜索意图。可能值：informational、navigational、commercial、transactional。
last_updated_time	string	搜索意图数据的最近更新时间，采用 ISO 8601 格式，例如 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"
  }
}

数据处理说明

• keyword_info.history 中的键表示月份，例如 202302 表示 2023 年 2 月。
• cpc、low_top_of_page_bid 和 high_top_of_page_bid 可能因地区、和数据可用性返回 null。
• rank_group 用于比较相同类型的 SERP素。
• rank_absolute 用于表示在当前返回结果中的整体绝对位置。
• etv 是估算值，不代表访问量。
• traffic_cost 是基于自然流量和付费点击价格估算的广告成本，不代表广告消耗。
• detected_language 可能与请求中的 language 不一致，因为该字段表示系统对文本的识别结果。

实用场景

• 筛选高价值：结合 search_volume、cpc、competition 和 keyword_difficulty 评估价值，制定 SEO和投放优级。
• 分析竞争页面流量：使用 domain、url、etv 和 traffic_cost 识别自然搜索流量较高且备商业价值的竞争页面。
• 监测 SERP 结果结构：按 type、rank_group 和 rank_absolute 分析自然结果、付费结果及精选摘要的分布，优化页面在目标 SERP 中的展示机会。
• 规划区域化 SEO：结合 location、language 和 history 对不同国家或语言市场的需求进行比较，制定本地化策略。
• 构建搜索意图地图：使用 main_intent 和 foreign_intent 将划分为信息型、导航型、商业调查型和交易型，匹不同阶段的与转化页面。