SeerMarTech API 文档

主题

数据库 ​

GET /v3/dataforseo_labs/locations_and_languages

概述 ​

本页为数据库的旧版说明，建议优参考更新后的 /v3/databases/google/keywords/ 文档。

数据库 30 亿条搜索词，并提供搜索量趋势、每次点击费用（CPC）、竞争度、展示次数等数据。数据库支持 JSON 和 CSV 两种格式。

本页描述的是数据库字段结构，不定义可直接调用的 HTTP 方法和 API 路径。数据库的获取方式及可用版本，以当前账户权限和最新接口文档为准。

价格说明 ​

费用取决于数据库的规模和地域参数。当前页面未提供固定单价。

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

字段说明 ​

基础字段 ​

字段类型说明
keywordstring，使用 UTF-8 编码。
locationinteger地域代码，用于唯一标识对应地域。例如，2840 表示美国。可通过以下接口获取可用地域及 location_code：https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages
languagestring语言代码，用于标识指定地域支持的语言。例如，en 表示英语。可通过以下接口获取可用语言及 language_code：https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages
spellstring | null搜索引擎自动修正后的。如果搜索引擎对原始进行了修正并返回修正后的结果，则此字段修正后的。
spell_typestring | null自动修正类型。可选值：did_you_mean、showing_results_for、no_results_found_for。

keyword_info：数据 ​

keyword_info 通常为对象，返回的搜索趋势和广告指标。

字段类型说明
search_volumeinteger平均月搜索量。表示指定在目标地域的近似月搜索次数，取决于搜索引擎及投放定位设置。
cpcfloat平均每次点击费用。表示历史上为该支付的平均 CPC，原始数据以计价。
competitionfloat竞争度，取值范围为 0 到 1，边界值。数值基于广告数据计算，数值越高通常表示竞争越激烈。
time_updatestring数据最近更新时间。通常采用 UTC 时间，格式为 月/日/年 时:分:秒，例如 05/08/2020 09:47:05。
categoriesarray产品和服务分类。
historyobject按月份统计的搜索量历史数据。键通常为 YYYYMM 格式，值为指定地域该的近似搜索次数。

impressions_info：展示次数数据 ​

impressions_info 通常为对象，提供指定的广告展示、点击和成本估算数据。

字段类型说明
ad_position_averagefloat | null平均广告位置，表示该在搜索结果页中付费结果的平均排名。
ad_position_minfloat | null最低广告位置。
ad_position_maxfloat | null最高广告位置。
cpc_avgfloat | null平均 CPC，表示历史平均每次点击费用。
cpc_minfloat | null最低历史 CPC。
cpc_maxfloat | null最高历史 CPC。
daily_impressions_avgfloat平均每日广告展示次数。
daily_impressions_minfloat最低每日广告展示次数。
daily_impressions_maxfloat最高每日广告展示次数。
daily_clicks_avgfloat平均每日广告点击次数。
daily_clicks_minfloat最低每日广告点击次数。
daily_clicks_maxfloat最高每日广告点击次数。
bidinteger最高出价。数据库通常使用 999 出价返回结果，以获取更参考价值的展示数据。
daily_cost_avgfloat平均每日广告费用。
daily_cost_minfloat最低每日广告费用。
daily_cost_maxfloat最高每日广告费用。
time_updatestring展示次数数据最近更新时间，通常为 UTC 时间。

> 容性说明：部分历史 JSON 示例中将 ad_position_average 表示为 ad_position_avg。接时应以响应字段为准，并容两种字段名称。

bing_keyword_info：搜索引擎数据 ​

bing_keyword_info 通常为对象或 null，基于 Bing 广告数据的指标。

> 注意：Bing 数据覆盖部分地域和语言。可用范围请通过 /v3/dataforseo_labs/locations_and_languages 查询。

字段类型说明
search_volumeintegerBing 月搜索量，表示过去一个月该在 Bing 的搜索次数。
time_updatestring数据最近更新时间，采用 ISO 8601 格式：YYYY-MM-DDThh:mm:ss.sssssssZ，例如 2020-09-12T00:07:43.0733218Z。
historyobject按月份统计的 Bing 搜索量历史数据。

extra：附加信息 ​

字段类型说明
core_keywordstring | null组中的核心。该字段表示一组在 keyword_info 参数上相似性的中的主。如果为 null，表示数据库中没有符合条件的核心。

JSON 数据示例 ​

以下示例展示数据库记录的型结构：

json
[
  {
    "keyword": "الر ثلاثي الابعاد",
    "location": 2818,
    "language": "ar",
    "spell": null,
    "spell_type": null,
    "keyword_info": {
      "search_volume": 720,
      "cpc": 0.015523,
      "competition": 0.019329507701600728,
      "time_update": "2021-03-24T04:01:47.4351095Z",
      "categories": [],
      "history": {
        "202003": 1000,
        "202004": 1000,
        "202005": 880,
        "202006": 1000,
        "202007": 720,
        "202008": 590,
        "202009": 480,
        "202010": 480,
        "202011": 480,
        "202012": 590,
        "202101": 590,
        "202102": 480
      }
    },
    "impressions_info": {
      "ad_position_avg": null,
      "ad_position_min": null,
      "ad_position_max": null,
      "cpc_avg": null,
      "cpc_min": null,
      "cpc_max": null,
      "daily_impressions_avg": 0,
      "daily_impressions_min": 0,
      "daily_impressions_max": 0,
      "daily_clicks_avg": 0,
      "daily_clicks_min": 0,
      "daily_clicks_max": 0,
      "bid": 999,
      "daily_cost_avg": 0,
      "daily_cost_min": 0,
      "daily_cost_max": 0,
      "time_update": "2021-03-19T14:07:03.9208731Z"
    },
    "bing_keyword_info": null,
    "extra": {
      "core_keyword": "رس ثلاثية الابعاد"
    }
  },
  {
    "keyword": "اليرة هيا",
    "location": 2818,
    "language": "ar",
    "spell": null,
    "spell_type": null,
    "keyword_info": {
      "search_volume": 720,
      "cpc": 0.009519,
      "competition": 0.0033973161202649907,
      "time_update": "2021-03-31T21:57:05.1516650Z",
      "categories": [],
      "history": {
        "202003": 2900,
        "202004": 880,
        "202005": 590,
        "202006": 590,
        "202007": 720,
        "202008": 590,
        "202009": 480,
        "202010": 390,
        "202011": 390,
        "202012": 390,
        "202101": 390,
        "202102": 880
      }
    },
    "impressions_info": {
      "ad_position_avg": null,
      "ad_position_min": null,
      "ad_position_max": null,
      "cpc_avg": null,
      "cpc_min": null,
      "cpc_max": null,
      "daily_impressions_avg": 0,
      "daily_impressions_min": 0,
      "daily_impressions_max": 0,
      "daily_clicks_avg": 0,
      "daily_clicks_min": 0,
      "daily_clicks_max": 0,
      "bid": 999,
      "daily_cost_avg": 0,
      "daily_cost_min": 0,
      "daily_cost_max": 0,
      "time_update": "2021-03-28T14:05:34.4503662Z"
    },
    "bing_keyword_info": null,
    "extra": {
      "core_keyword": null
    }
  }
]

数据处理建议 ​

  • keyword_info、impressions_info 和 bing_keyword_info 可能为空，解析时应处理 null 值。
  • history 中的月份键使用 YYYYMM 格式，适合转换为时间序列后进行趋势分析。
  • cpc、cpc_avg、cpc_min 和 cpc_max 为历史广告成本指标，不应直接视为当前实时出价。
  • location 与 language 应结合使用，将同一在不同地域或语言环境下的数据混为一谈。
  • categories 可能为空数组，表示当前记录未返回产品或服务分类。

实用场景 ​

  • 筛选高搜索量、低竞争度，建立 SEO选题池，提高自然流量获取效率。
  • 分析月度搜索趋势，识别季节性需求和增长主题，发布与预算排期。
  • 对比不同地域和语言的数据，制定本地化 SEO 策略，提升多市场覆盖能力。
  • 评估广告展示、点击和成本区间，估算投放潜力并优化付费搜索预算。
  • 根据 core_keyword 聚合相似，构建主题集群和架构，减少竞争。

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

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