Google 历史数据库

GET /v3/dataforseo_labs/locations_and_languages

Google 历史数据库提供海量及历史指标搜索量、竞争度、点击费用等数据。

历史数据最早可追溯至 2021 年 8 月。数据库提供 JSON 格式。

数据库按地点和数据规模区分，支持的地点与语言可通过以下接口查询：

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

例如：

location_code 为 2840：美国
language_code 为 en：英语

数据结构

数据库中的每条记录代表一个，结构如下。

字段	类型	说明
`keyword`	string	，使用 UTF-8 编码
`location`	integer	地点代码，对应地点的唯一标识
`language`	string	语言代码，对应指定地点可用语言的唯一标识
`spell`	string / null	搜索引擎自动修正后的。如果搜索引擎针对原返回了修正结果，则提供修正后的
`spell_type`	string / null	自动修正类型
`keyword_info_history`	object	返回的历史指标，按月份组织
`extra`	object	的附加信息
`search_intent_info`	object	返回的搜索意图信息

`spell_type` 可能值

值	说明
`did_you_mean`	你是不是想搜索
`showing_results_for`	显示以下的搜索结果
`no_results_found_for`	未找到以下的结果

`keyword_info_history`

keyword_info_history 是一个对象键名为 YYYYMM 格式的月份，例如 202109。

字段	类型	说明
`$date`	object	月份变量，使用 `YYYYMM` 格式
`search_volume`	integer	平均月搜索量，表示指定在 Google 或 Google 及合作伙伴中的大致搜索次数，取决于定位设置
`cpc`	float / null	历史平均每次点击费用。该字段基于广告数据中的 `high_top_of_page_bid` 计算，原始单位为
`competition`	float / null	竞争度，取值范围为 `0` 至 `1`，边界值。该指标基于广告数据计算
`competition_level`	string / null	付费搜索结果中的竞争等级
`low_top_of_page_bid`	float / null	广告展示在首页顶部所需的最低出价估值
`high_top_of_page_bid`	float / null	广告展示在首页顶部所需的最高出价估值
`time_update`	string	数据最后更新时间，使用 ISO 8601 格式
`categories`	array	产品和服务类别
`history`	object	月度搜索量历史记录

`competition_level` 可能值

值	说明
`LOW`	低
`MEDIUM`	中
`HIGH`	高
`null`	未知

如果竞争等级未知，字段值为 null。

出价字段说明

low_top_of_page_bid：表示根据广告统计数据，约高于最低广告展示出价的 20% 的估值。
high_top_of_page_bid：表示根据广告统计数据，约高于最低广告展示出价的 80% 的估值。
出价数值可能因请求中指定的地点不同而变化。
数据源不提供独立的 CPC 历史数据，因此 cpc 基于 high_top_of_page_bid 返回。

`time_update` 格式

时间使用 ISO 8601 格式：

text

YYYY-MM-DDThh:mm:ss.sssssssZ

示例：

text

2020-09-12T00:07:43.0733218Z

`history`

history 记录在指定地点的月度搜索量，通常 $date 对应月份之前最多 4 年的数据。

示例：

json

{
  "202109": 40
}

`extra`

extra 用于保存的附加信息。

字段	类型	说明
`core_keyword`	string / null	分组中的核心。该分组在 `keyword_info` 参数上相似特征的。如果值为 `null`，表示数据库中没有符合条件的匹
`synonym_clustering_algorithm`	string / null	用于识别同义词的算法
`detected_language`	string / null	系统识别出的语言
`keyword_difficulty`	integer / null	难度，表示自然搜索结果前 10 名的难易程度，取值范围为 `0` 至 `100`

`synonym_clustering_algorithm` 可能值

值	说明
`keyword_metrics`	基于指标参数的算法
`text_processing`	基于文本处理的算法
`null`	对应算法未识别出与该同义的

`keyword_difficulty`

keyword_difficulty 用于估算自然搜索结果前 10 名的可能性：

取值范围为 0 至 100
数值越高，通常表示排名难度越大
该指标采用对数尺度计算
计算时会综合分析搜索结果前 10 个页面的链接画像等因素

`search_intent_info`

search_intent_info 用于描述的搜索意图。

字段	类型	说明
`main_intent`	string	主要搜索意图
`foreign_intent`	array	补搜索意图
`last_updated_time`	string	搜索意图数据最后更新时间，使用 ISO 8601 格式

搜索意图可能值

值	说明
`informational`	信息型
`navigational`	导航型
`commercial`	商业调查型
`transactional`	交易型

数据示例

以下示例展示数据库中单条记录的结构：

json

{
  "keyword": "huckleberry bookstore",
  "location": 2124,
  "language": "fr",
  "spell": null,
  "spell_type": null,
  "keyword_info_history": {
    "202203": {
      "search_volume": 480,
      "cpc": null,
      "competition": 0.12,
      "competition_level": "LOW",
      "low_top_of_page_bid": null,
      "high_top_of_page_bid": null,
      "time_update": "2022-05-10T19:17:54.2726860Z",
      "categories": [],
      "history": {
        "202105": 390,
        "202106": 390,
        "202107": 390,
        "202108": 390,
        "202109": 390,
        "202110": 390,
        "202111": 590,
        "202112": 880,
        "202201": 590,
        "202202": 390,
        "202203": 480,
        "202204": 480
      }
    },
    "202204": {
      "search_volume": 480,
      "cpc": null,
      "competition": 0.12,
      "competition_level": "LOW",
      "low_top_of_page_bid": null,
      "high_top_of_page_bid": null,
      "time_update": "2022-06-02T23:21:21.7580528Z",
      "categories": [],
      "history": {
        "202105": 390,
        "202106": 390,
        "202107": 390,
        "202108": 390,
        "202109": 390,
        "202110": 390,
        "202111": 590,
        "202112": 880,
        "202201": 590,
        "202202": 390,
        "202203": 480,
        "202204": 480
      }
    },
    "202205": {
      "search_volume": 480,
      "cpc": null,
      "competition": 0.06,
      "competition_level": "LOW",
      "low_top_of_page_bid": null,
      "high_top_of_page_bid": null,
      "time_update": "2022-06-15T14:14:14.8835515Z",
      "categories": [],
      "history": {
        "202106": 390,
        "202107": 390,
        "202108": 390,
        "202109": 390,
        "202110": 390,
        "202111": 590,
        "202112": 880,
        "202201": 590,
        "202202": 390,
        "202203": 480,
        "202204": 480,
        "202205": 480
      }
    },
    "202206": {
      "search_volume": 480,
      "cpc": null,
      "competition": 0.13,
      "competition_level": "LOW",
      "low_top_of_page_bid": null,
      "high_top_of_page_bid": null,
      "time_update": "2022-07-12T18:44:24.3630256Z",
      "categories": [],
      "history": {
        "202107": 390,
        "202108": 390,
        "202109": 390,
        "202110": 390,
        "202111": 590,
        "202112": 880,
        "202201": 590,
        "202202": 390,
        "202203": 480,
        "202204": 480,
        "202205": 480,
        "202206": 390
      }
    },
    "202302": {
      "search_volume": 480,
      "cpc": null,
      "competition": 0.23,
      "competition_level": "LOW",
      "low_top_of_page_bid": null,
      "high_top_of_page_bid": null,
      "time_update": "2023-03-21T23:09:18.9404970Z",
      "categories": [],
      "history": {
        "202203": 390,
        "202204": 480,
        "202205": 390,
        "202206": 390,
        "202207": 390,
        "202208": 390,
        "202209": 390,
        "202210": 480,
        "202211": 590,
        "202212": 880,
        "202301": 590,
        "202302": 480
      }
    }
  },
  "extra": {
    "core_keyword": null,
    "detected_language": "en",
    "keyword_difficulty": 15
  },
  "search_intent_info": {
    "main_intent": "commercial",
    "foreign_intent": [],
    "last_updated_time": "2023-03-04T13:14:40.0735962Z"
  }
}

下载与支持范围

数据库提供 JSON 格式。
可根据地点和语言下载对应数据库文件。
支持的地点和语言列表可通过以下接口获取：

http

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

数据库历史数据自 2021 年 8 月起提供。
数据库费用取决于数据库规模和地点参数。
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

实用场景

分析搜索趋势：利用 history 和 search_volume 对比不同月份的搜索需求，识别季节性增长和长期下滑词。
筛选高价值主题：结合搜索量、CPC、竞争度和难度，优选择流量潜力与排名可行性顾的主题。
规划区域化 SEO 策略：按 location 和 language 对进行拆分，为不同国家、地区和语言市场制定本地化计划。
识别用户搜索意图：使用 main_intent 和 foreign_intent 区分信息型、商业调查型和交易型，匹页面与转化页面。
监测语义与同义词：通过 core_keyword、synonym_clustering_algorithm 和 detected_language 归并相近，减少重复并完善覆盖。

Google 历史数据库 ​

数据结构 ​

spell_type 可能值 ​

keyword_info_history ​

competition_level 可能值 ​

出价字段说明 ​

time_update 格式 ​

history ​

extra ​

synonym_clustering_algorithm 可能值 ​

keyword_difficulty ​

search_intent_info ​

搜索意图可能值 ​

数据示例 ​

下载与支持范围 ​

实用场景 ​