Google 数据库

GET /v3/dataforseo_labs/locations_and_languages

数据库简介

Google 数据库数十亿条搜索词，并提供搜索量趋势及广告数据。

数据来源于多个渠道 Google Ads 和 Google 搜索结果页。本平台会持续扩库，并根据 Google Ads 的更新周期，通常在每月下半月逐步更新数据。

数据库支持以下格式：

JSON
CSV

可下载美国地区、英语语言的 JSON 数据样例。完整支持的地区列表可通过 CSV 格式获取，以本平台当前发布的文件为准。

计费说明

费用取决于所请求数据库的规模和地区参数。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

地区与语言代码

数据库中的 location 和 language 字段分别表示地区代码和语言代码。可通过以下接口获取支持的地区和语言列表：

text

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

请求体为 JSON 数组，例如：

bash

curl --request POST \
  --url https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {}
  ]'

示例：

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

数据字段

字段	类型	说明
`keyword`	string	，使用 UTF-8 编码。
`location`	integer	地区代码，对应唯一地区标识。
`language`	string	语言代码，对应指定地区支持的语言。
`spell`	string	搜索引擎自动纠正后的。如果搜索引擎针对原返回了纠正后的结果，则此字段纠正后的；如果未发生纠正，则为 `null`。
`spell_type`	string	自动纠正类型。可能的值：`did_you_mean`、`showing_results_for`、`no_results_found_for`。
`keyword_info`	object	返回的指标数据。
`keyword_info.search_volume`	integer	平均月搜索量。表示指定在 Google 或 Google 及合作伙伴上的近似搜索次数，取决于定位设置。
`keyword_info.cpc`	float	每次点击费用，表示该历史平均点击成本。该字段并非独立的 CPC 原始数据，而是基于广告数据中的 `high_top_of_page_bid` 计算得出。
`keyword_info.competition`	float	竞争度，表示与该的相对竞争程度。取值范围为 `0` 到 `1`，边界值。
`keyword_info.competition_level`	string	付费搜索结果中的竞争等级。可能的值：`LOW`、`MEDIUM`、`HIGH`。如果无法确定，则返回 `null`。
`keyword_info.low_top_of_page_bid`	float	广告展示在搜索结果首页顶部所需的最低出价。该值通常高于广告主历史统计中约 20% 的最低展示出价。数值可能因请求中的地区而异。
`keyword_info.high_top_of_page_bid`	float	广告展示在搜索结果首页顶部所需的较高出价。该值通常高于广告主历史统计中约 80% 的最低展示出价。数值可能因请求中的地区而异。
`keyword_info.time_update`	string	指标最近更新时间，使用 ISO 8601 格式：`YYYY-MM-DDThh:mm:ss.sssssssZ`。例如：`2020-09-12T00:07:43.0733218Z`。
`keyword_info.categories`	array	产品和服务分类。
`keyword_info.history`	object	月度搜索量历史数据，表示指定地区中该的近似月搜索量。历史数据最长可追溯 4 年。对象键通常为 `YYYYMM` 格式。
`extra`	object	附加信息。
`extra.core_keyword`	string	组中的核心。该字段用于标识在 `keyword_info` 参数上相似特征的一组。如果数据库中没有符合条件的，则返回 `null`。
`extra.synonym_clustering_algorithm`	string	用于识别同义词的算法。可能的值：`keyword_metrics`，表示基于 `keyword_info` 参数识别；`text_processing`，表示基于文本处理算法识别。如果相应算法未识别出与当前对应的同义词，则返回 `null`。
`extra.detected_language`	string	系统识别出的语言。
`extra.keyword_difficulty`	integer	自然搜索结果前十名的难度，取值范围为 `0` 到 `100`。该指标基于前十个搜索结果页面的链接画像等因素计算，数值越高通常表示排名难度越大。
`search_intent_info`	object	返回的搜索意图信息。
`search_intent_info.main_intent`	string	主要搜索意图。可能的值：`informational`（信息型）、`navigational`（导航型）、`commercial`（商业调研型）、`transactional`（交易型）。
`search_intent_info.foreign_intent`	array	补搜索意图。可能的值：`informational`、`navigational`、`commercial`、`transactional`。
`search_intent_info.last_updated_time`	string	搜索意图数据最近更新时间，使用 ISO 8601 格式。例如：`2022-09-12T00:07:43.0733218Z`。

字段结构说明

`keyword_info`

keyword_info 为对象，搜索量、竞价、竞争度、分类和历史趋势等数据。

`extra`

extra 为对象，核心、识别语言和难度等附加信息。部分版本还可能返回 synonym_clustering_algorithm 字段。

`search_intent_info`

search_intent_info 为对象，用于描述的主要搜索意图、补意图及意图数据更新时间。

JSON 数据示例

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

json

{
  "keyword": "races day",
  "location": 2036,
  "language": "en",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 260,
    "cpc": null,
    "competition": 0.01,
    "competition_level": "LOW",
    "low_top_of_page_bid": null,
    "high_top_of_page_bid": null,
    "time_update": "2023-03-21T20:25:36.3263513Z",
    "categories": [],
    "history": {
      "202203": 210,
      "202204": 170,
      "202205": 210,
      "202206": 170,
      "202207": 260,
      "202208": 320,
      "202209": 320,
      "202210": 720,
      "202211": 260,
      "202212": 260,
      "202301": 170,
      "202302": 170
    }
  },
  "extra": {
    "core_keyword": null,
    "detected_language": "en",
    "keyword_difficulty": 57
  },
  "search_intent_info": {
    "main_intent": "informational",
    "foreign_intent": [],
    "last_updated_time": "2023-03-02T17:23:41.2125531Z"
  }
}

数据处理建议

search_volume 表示平均月搜索量，适合用于规模评估和优级排序。
history 提供按月拆分的搜索量，可用于识别季节性需求和趋势变化。
cpc、competition 和 competition_level 主要反映付费搜索竞争，不等同于自然排名难度。
keyword_difficulty 反映自然搜索结果排名难度，建议与搜索意图、搜索量和竞争度结合使用。
spell 不为 null 时，建议同时保留原始和纠正后的，丢失用户真实信息。
categories、search_intent_info 和 extra 可能为空，应在数据库和分析逻辑中做好空值处理。

实用场景

筛选高潜力：结合 search_volume、competition 和 keyword_difficulty，优识别搜索需求高且自然排名难度可控的。
分析季节性趋势：利用 history 字段对比不同月份的搜索量，为发布、促销活动和广告预算安排提供依据。
构建主题集群：使用 core_keyword 和同义词聚类算法字段，将语义相近的归并为主题组，提升规划效率。
匹搜索意图与落地页：依据 main_intent 和 foreign_intent 区分信息型、商业调研型及交易型需求，优化页面类型和转化路径。
评估付费搜索竞争：结合 cpc、low_top_of_page_bid、high_top_of_page_bid 和 competition_level，制定投放和竞价策略。

Google 数据库 ​

数据库简介 ​

计费说明 ​

地区与语言代码 ​

数据字段 ​

字段结构说明 ​

keyword_info ​

extra ​

search_intent_info ​

JSON 数据示例 ​

数据处理建议 ​

实用场景 ​