databases/serp/regular

GET /v3/dataforseo_labs/locations_and_languages

常规 SERP 数据库

> 本页面为旧版文档。常规 SERP 数据库 5 亿条 Google 搜索结果页数据，覆盖标准自然搜索结果和付费搜索结果，支持 JSON 与 CSV 格式。

本页面未定义独立的 HTTP 方法与请求路径；如需使用新版数据库接口，请参考更新后的常规 SERP 数据库文档。

数据与计费

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

字段说明

顶层字段

字段	类型	说明
keyword	string	搜索查询词，使用 UTF-8 编码。
location	integer	地域代码，对应地域的唯一标识。可通过以下接口获取可用地域及 location_code：https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages。例如，2840 表示美国。
language	string	语言代码，对应地域可用语言的唯一标识。可通过 https://api.seermartech.cn/v3/dataforseo_labs/locations_and_languages 获取可用语言及 language_code。例如，en 表示英语。
spell	string / null	搜索引擎自动纠正后的。如果搜索引擎对原进行了纠正，则返回纠正后的；未纠正时返回 null。
spell_type	string / null	自动纠正类型。可选值：did_you_mean、showing_results_for、no_results_found_for。未纠正时返回 null。
keyword_info	object / null	返回的数据。
bing_keyword_info	object / null	基于 Bing Ads 的数据。该数据适用于有限的地域和语言组合。
serp_info	object / null	返回对应的 SERP 数据。
extra	object / null	的附加信息。

keyword_info 字段

字段	类型	说明
search_volume	integer	平均月搜索量。根据用户定位设置，表示 Google 搜索或 Google 及合作伙伴上对该的月均估算搜索次数。
cpc	float	每次点击费用，表示历史上该的平均点击费用，单位为。该字段是原始广告数据指标，不代表本平台的扣费价格。
competition	float	竞争度，基于广告数据计算，取值范围为 0 至 1，边界值。
time_update	string	数据的最后更新时间，格式为 月/日/年 时:分:秒 UTC。例如：05/08/2020 09:47:05。响应也可能采用 ISO 8601 时间格式。
categories	array	产品和服务分类。
history	object	按月份记录的搜索量，键名格式通常为 YYYYMM。

bing_keyword_info 字段

字段	类型	说明
search_volume	integer	Bing 月搜索量，表示过去一个月在 Bing 上对该的搜索次数。
time_update	string	Bing 数据的最后更新时间，采用 ISO 8601 格式：YYYY-MM-DDThh:mm:ss.sssssssZ。例如：2020-09-12T00:07:43.0733218Z。
history	object	按月份记录的 Bing 搜索量。

> 注意：Bing 数据适用于有限的地域和语言组合。

serp_info 字段

字段	类型	说明
check_url	string	搜索结果页的直接 URL，可用于核验返回结果是否准确。
items_count	integer	serp 数组中返回的结果项数量。
keyword_difficulty	integer	自然搜索结果前 10 名的难度，取值范围为 0 至 100。该指标基于前 10 个 SERP 页面的网站链接特征等因素计算，数值越高通常表示竞争越激烈。
se_results_count	integer	搜索引擎结果页中的结果总数。
time_update	string	SERP 数据的最后更新时间，格式为 月/日/年 时:分:秒 UTC。例如：05/08/2020 09:47:05。
serp	array	返回对应的 SERP素数据。

serp 数组字段

字段	类型	说明
rank_group	integer	分组排名。在 type 相同的一组中进行排名；不同类型之间不会计算分组排名。
rank_absolute	integer	SERP 中的绝对排名，即该在所有结果中的绝对位置。返回值通常按升序排列。高级 SERP 特征对应的位置可能会被省略；如需高级 SERP 特征和富摘要及位置，请使用高级 SERP 数据库。
type	string	结果类型。可选值：organic、paid、featured_snippet。
domain	string	SERP 中的域名。
url	string	结果对应的 URL。
title	string	SERP 结果标题。
description	string	SERP 结果的描述。
breadcrumb	string	SERP 中显示的面屑路径。
etv	float	估算流量。表示该 URL 所在域名的月均估算自然流量，通常根据点击率（CTR）与搜索量计算。
impressions_etv	float	基于展示次数计算的估算流量。表示该 URL 所在域名的月均估算自然流量，通常根据点击率（CTR）与展示次数计算。
traffic_cost	float	自然搜索流量的估算广告成本。表示如果通过 Google Search 付费广告获取同等月均自然流量，预计需要支付的费用，通常按自然流量 etv 与付费点击费用 cpc 的乘积计算。

extra 字段

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

JSON 数据示例

以下示例展示一条记录的主要结构，serp 数组保留一个结果项：

{
  "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",
    "items_count": 101,
    "keyword_difficulty": 67,
    "se_results_count": 56900000,
    "time_update": "2021-04-13T17:41:57.4277307Z",
    "serp": [
      {
        "rank_group": 1,
        "rank_absolute": 1,
        "type": "organic",
        "domain": "example.com",
        "url": "https://example.com/real-estate",
        "title": "عقارات للبيع",
        "description": "搜索结果描述。",
        "breadcrumb": "https://example.com › real-estate",
        "etv": 3.99,
        "impressions_etv": 0,
        "traffic_cost": 1.5711024
      }
    ]
  },
  "extra": {
    "core_keyword": "عقارات للبيع"
  }
}

数据格式

数据库支持以下格式：

• JSON：以结构化对象形式返回、SERP、广告及流量估算数据。
• CSV：以表格形式返回数据，适合批量下载、离线分析和导数据仓库。

实用场景

• 分析排名竞争度：结合 keyword_difficulty、competition 和自然结果列表，筛选适合重点的，优化 SEO 资源分。
• 监控自然与付费结果分布：根据 serp 中的 organic、paid 和 featured_snippet 类型，评估搜索结果页的流量竞争结构，制定与广告协同策略。
• 发现竞争对手排名页面：按 domain、url 和 rank_absolute 聚合 SERP 数据，识别竞品获得自然流量的页面和，支持竞品拆解。
• 估算 SEO 流量与广告替代成本：使用 etv、impressions_etv 和 traffic_cost 评估带来的潜在自然流量及付费获取成本，预算规划。
• 追踪搜索趋势：读取 keyword_info.history 和 bing_keyword_info.history 的月度数据，识别季节性需求变化，为日历和落地页规划提供依据。