Skip to content

Google 完整数据库

GET /v3/dataforseo_labs/locations_and_languages

概述

Google 完整数据库是由以下两类数据组成的统一数据库:

  • Google SERP 数据库:来自 67 个地区的数百万条 Google 搜索结果,以及精选摘要、知识图谱、People Also Ask、热门等丰富的 SERP 特性。
  • Google 数据库:数十亿条搜索词,并提供广告数据,例如搜索量趋势、CPC、竞争度和竞争级别。

本数据库提供 JSON 格式。每条记录对应一个,并可能同时指标、历史搜索量、SERP 结果、搜索意图及扩展信息。

> 本页面描述的是数据库文件结构,不是用于提交任务的在线查询接口。数据库中的 serp_infokeyword_info 等字段为预采集数据。

数据获取

数据库文件地区和语言提供。可通过本平台获取对应位置的 JSON 数据文件。

位置和语言代码可通过以下接口查询:

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

示例:

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

数据库文件示例通常采用以下命名格式:

text
{LOCATION}_{LANGUAGE}.json.gz

例如:

text
US_en.json.gz

数据格式

数据库文件采用 UTF-8 编码。每条记录为一个 JSON 对象,文件整体为按记录排列的数据集合。

部分字段在无数据时返回:

  • null
  • 空数组 []
  • 空对象 {}

解析时应根据字段类型进行容处理。

顶层字段

字段类型说明
keywordstring,采用 UTF-8 编码。
locationinteger地区代码,对应位置的唯一标识。
languagestring语言代码,对应地区可用语言的唯一标识。
spellstring搜索引擎自动纠正后的。如果搜索结果针对纠正后的返回,则提供纠正后的文本;无纠正时通常为 null
spell_typestring自动纠正类型。可选值:did_you_meanshowing_results_forno_results_found_forincluding_results_for
keyword_infoobject当前的指标。
serp_infoobject当前对应的 SERP 数据。
extraobject补信息。
search_intent_infoobject搜索意图信息。

keyword_info 指标

字段类型说明
search_volumeinteger平均月搜索量,表示该在 Google 搜索中的大致月搜索次数。
cpcfloat平均每次点击费用。该字段基于广告数据中的 high_top_of_page_bid 计算,不代表单独提供的 CPC 原始值。
competitionfloat广告竞争度,取值范围为 01,边界值。
competition_levelstring付费 SERP 中的竞争级别。可选值:LOWMEDIUMHIGH;未知时为 null
low_top_of_page_bidfloat广告展示在首页顶部所需的较低出价参考值,通常高于约 20% 的最低展示出价。该值可能因地区不同而变化。
high_top_of_page_bidfloat广告展示在首页顶部所需的较高出价参考值,通常高于约 80% 的最低展示出价。该值可能因地区不同而变化。
time_updatestring数据最后更新时间,采用 ISO 8601 格式,例如 2020-09-12T00:07:43.0733218Z
categoriesarray产品和服务类别。
historyobject历史月搜索量。通常提供过去约 4 年的数据,键名格式为 YYYYMM,例如 202002

history 示例

json
{
  "201902": 140,
  "201903": 170,
  "201904": 90,
  "202001": 50,
  "202002": 140
}

serp_info SERP 数据

字段类型说明
check_urlstring对应搜索结果的直接 URL,可用于核对返回的 SERP。
items_countintegerserp 数组中返回的结果数量。
keyword_difficultyinteger前 10 条自然结果的难度,按对数刻度取值 0100。该指标会分析 SERP 前 10 个页面的链接画像等因素。
se_results_countintegerSERP 中的结果总数。
time_updatestringSERP 数据最后更新时间,采用 ISO 8601 格式。
previous_updated_timestringSERP 数据上一次更新时间,采用 ISO 8601 格式。
item_typesarray当前 SERP 中出现的结果类型。
serparray当前的 SERP素。

item_types 可选值

text
answer_box
app
carousel
multi_carousel
featured_snippet
google_flights
google_reviews
google_hotels
images
jobs
knowledge_graph
local_pack
hotels_pack
map
organic
paid
people_also_ask
related_searches
people_also_search
shopping
top_stories
twitter
video
events
recipes
top_sights
scholarly_articles
popular_products
questions_and_answers
find_results_on
stocks_box
commercial_units
local_services
math_solver
currency_box
product_considerations
short_videos
refine_products
perspectives
discussions_and_forums
compare_sites
ai_overview
third_party_reviews

serp 通用字段

许多 SERP素会以下通用字段:

字段类型说明
typestringSERP素类型。
positionstring素在 SERP 中的对齐位置,可选值:leftright
xpathstring素在页面中的 XPath。
traffic_costfloat将估算自然流量转化为付费流量所需的预计月度广告成本,通常按 etv × cpc 计算。
rank_groupinteger同类型中的分组排名。不同类型之间通常不计同一组排名。
rank_absoluteinteger素在所有 SERP素中的绝对排名。
etvfloat估算自然月流量,通常按点击率与搜索量计算。
is_newboolean与数据库上一版本相比是否为新增。
is_upboolean与上一版本相比排名是否上升。
is_downboolean与上一版本相比排名是否下降。
previous_rank_absoluteinteger最近一次更新前的绝对排名。
rank_infoobject页面和主域名排名信息。
page_rankinteger页面排名。
main_domain_rankinteger主域名排名。

常见结果字段

字段类型说明
titlestring结果标题。
descriptionstring结果描述或摘要。
snippetstring结果摘要文本。
pre_snippetstring添加在结果描述之前的附加信息。
extended_snippetstring添加在结果描述之后的附加信息。
breadcrumbstringSERP 中显示的面屑。
urlstring结果绝对 URL。
relative_urlstring结果相对 URL。
domainstring结果域名。
main_domainstring不含子域名的主域名。
cache_urlstring页面缓存 URL。
highlightedarray描述文本中以粗体突出显示的词语。
is_imageboolean是否图片。
is_videoboolean是否视频。
is_featured_snippetboolean是否为精选摘要。
amp_versionboolean是否存在 AMP 版本。
is_maliciousboolean是否被标记为恶意结果。
timestampstring结果发布时间,通常采用 UTC 格式 yyyy-mm-dd hh:mm:ss +00:00
imagesarray图片信息。
linksarray站点链接信息。
ratingobject结果评分。
priceobject产品、服务或住宿价格信息。

rating 评分对象

字段类型说明
rating_typestring评分类型,可选值:Max5PercentsCustomMax
valueinteger/float评分值。
votes_countinteger评价数量。
rating_maxinteger评分上限。

price 价格对象

字段类型说明
currentfloat当前价格。
regularfloat未打折时的常规价格。
max_valuefloat价格区间中的最高价格。
currencystring价格使用的货币 ISO 代码。
is_price_rangeboolean是否为价格区间。
displayed_pricestringSERP 中原样展示的价格文本。

images 图片

字段类型说明
typestring固定为 images_element
altstring图片替代文本。
urlstring页面 URL。
image_urlstring图片 URL。

图片 URL 可能指向原始资源,也可能指向本平台的存储地址。

字段类型说明
typestring固定为 link_element
titlestring链接标题。
descriptionstring链接描述。
urlstring链接 URL。
domainstring链接域名。

如果没有站点链接,links 通常为 null

主要 SERP素结构

serp 数组中的每个对象根据 type 表示不同的搜索结果模块。以下字段为各类型的主要业务字段;除特别说明外,各类型还可能通用排名字段。

organic 自然结果

主要字段:

  • title:结果标题。
  • description:结果描述。
  • breadcrumb:面屑。
  • domainmain_domain:域名和主域名。
  • urlrelative_url:绝对 URL 和相对 URL。
  • imageslinks:图片和站点链接。
  • ratingprice:评分和价格信息。
  • related_search_url:搜索 URL。
  • related_result:同域名结果。
  • extended_people_also_search:点击结果后返回 SERP 时可能出现的搜索扩展。
  • about_this_result:结果面板,已弃用,始终为 null
  • is_web_story:是否为 Web Story。
  • traffic_costrank_grouprank_absoluteetv:流量成本、分组排名、绝对排名和估算流量。

related_result 可:

字段类型说明
typestring固定为 related_result
xpathstring素 XPath。
domainstring域名。
titlestring结果标题。
urlstring结果 URL。
cache_urlstring缓存 URL。
related_search_urlstring相似搜索 URL。
breadcrumbstring面屑。
is_imageboolean是否图片。
is_videoboolean是否视频。
descriptionstring结果描述。
pre_snippetstring描述前附加信息。
extended_snippetstring描述后附加信息。
imagesarray图片信息。
ratingobject评分信息。
priceobject价格信息。

主要字段:

  • title:广告标题。
  • domainmain_domain:广告域名。
  • description:广告描述。
  • breadcrumb:广告面屑。
  • urlrelative_url:广告 URL。
  • highlighted:突出显示词语。
  • extra.ad_aclk:广告标识符。
  • description_rows:扩展描述,没有时为 null
  • links:广告站点链接。
  • price:价格信息。
  • rank_info:页面和域名排名信息。
  • traffic_costrank_grouprank_absoluteetv:流量及排名估算字段。
字段类型说明
titlestring结果标题。
featured_titlestring精选摘要来源页面标题。
descriptionstring结果描述。
tableobject表格数据,没有时为 null
domainstring来源域名。
main_domainstring主域名。
urlstring来源 URL。
relative_urlstring相对 URL。
imagesarray图片信息。
timestampstring发布时间。

table 对象:

  • table_header:表头数组。
  • table_content:表格数组。

answer_box 直接答案

字段类型说明
textarray答案文本,没有时为 null
linksarray答案中的链接。
typestring固定为 answer_box

carousel 主要字段:

  • title:模块标题。
  • items:轮播项目数组。
  • 项目字段:titlesubtitletype,项目类型通常为 carousel_element

multi_carousel 主要字段:

  • items:多层轮播项目。
  • typemulti_carousel
  • 项目类型:multi_carousel_element
  • multi_carousel_snippets:轮播摘要数组。
  • 摘要类型:multi_carousel_snippet
  • title:项目标题。
字段类型说明
itemsarray搜索项目。
typestring固定为 related_searches

people_also_search 用户还搜索了

字段类型说明
titlestring模块标题。
itemsarray搜索项目。
typestring固定为 people_also_search

people_also_ask People Also Ask

主要字段:

  • items:问题项目数组。
  • typepeople_also_ask_element
  • title:问题标题。
  • seed_question:触发扩展结果的种子问题。
  • xpath: XPath。
  • expanded_element:展开后的答案。

展开通常:

  • featured_title
  • url
  • domain
  • title
  • description
  • images
  • table
  • type

还可能:

  • people_also_ask_ai_overview_expanded_element
  • ai_overview_element
  • ai_overview_video_element
  • ai_overview_table_element
  • ai_overview_expanded_element
  • asynchronous_ai_overview

local_pack 本地结果

主要字段:

  • title:本地商户标题。
  • description:商户描述。
  • phone:电话号码。
  • booking_url:预约 URL。
  • is_paid:是否为广告。
  • rating:评分对象。
  • domainmain_domainurlrelative_url:网站信息。
  • is_newis_upis_downprevious_rank_absolute:排名变化。
  • rank_infopositionxpathtraffic_costrank_grouprank_absoluteetv:排名和流量字段。

knowledge_graph 知识图谱

主要字段:

  • title:知识图谱标题。
  • subtitle:副标题。
  • description:描述。
  • card_id:卡片标识符。
  • url: URL。
  • logo_url:Logo URL。
  • items:知识图谱子。

子类型:

text
knowledge_graph_carousel_item
knowledge_graph_carousel_element
knowledge_graph_description_item
knowledge_graph_list_item
knowledge_graph_list_element
knowledge_graph_row_item
knowledge_graph_part_item
knowledge_graph_shopping_item
knowledge_graph_shopping_element
knowledge_graph_expanded_item
knowledge_graph_expanded_element
knowledge_graph_ai_overview_item
knowledge_graph_images_item
knowledge_graph_images_element
knowledge_graph_description_item

常见子字段:

  • title
  • subtitle
  • text
  • url
  • domain
  • image_url
  • data_attrid
  • link
  • links
  • items
  • expanded_element
  • table
  • price

linklinks 中的链接通常:

  • type: link_element
  • title
  • description
  • url

data_attrid 是搜索引擎定义的数据属性标识,例如:

text
action:listen_artist

ai_overview AI 摘要

主要字段:

字段类型说明
typestring固定为 ai_overview
asynchronous_ai_overviewboolean是否异步加载。true 表示异步加载,false 表示从缓存加载。
markdownstringAI 摘要的 Markdown。
itemsarray摘要项目。
referencesarray用于生成摘要的网页引用。

常见子类型:

text
ai_overview_element
ai_overview_video_element
ai_overview_table_element
ai_overview_expanded_element
ai_overview_expanded_component
ai_overview_reference
images_element
link_element

ai_overview_element

字段类型说明
titlestring子标题。
textstring摘要文本或描述。
markdownstringMarkdown 格式。
linksarray摘要中引用的网站链接。
imagesarray摘要中的图片。
referencesarray网页引用。

ai_overview_reference

字段类型说明
typestring固定为 ai_overview_reference
sourcestring引用来源名称或标题。
domainstring引用域名。
urlstring引用页面 URL。
titlestring引用页面标题。
textstring用于生成摘要的页面文本片段。

ai_overview_video_element

  • title
  • snippet
  • url
  • domain
  • image_url
  • source
  • date
  • timestamp

ai_overview_table_element

  • markdown
  • table
  • table_header
  • table_content
  • references

ai_overview_expanded_element

  • title
  • text
  • components
  • images
  • links
  • references

组件类型为 ai_overview_expanded_component,通常:

  • title
  • text
  • markdown
  • images

top_stories 热门

主要字段:

  • items
  • source
  • domain
  • title
  • date
  • amp_version
  • url
  • timestamp
  • image_url
  • badges
  • type: top_stories

twitter 社交媒体结果

主要字段:

  • title
  • url
  • items
  • tweet
  • date
  • timestamp
  • type: twitter

map 地图结果

主要字段:

  • title
  • url
  • type: map
  • position
  • xpath
  • traffic_cost
  • rank_group
  • rank_absolute
  • etv

google_flights 航班结果

主要字段:

  • type: google_flights
  • title
  • url
  • items

子类型为 google_flights_element,可:

  • description
  • url

google_reviews Google 评论

字段类型说明
reviews_countinteger评论数量。
place_idstring地点标识符。
featurestring评论模块附加特征。
typestring固定为 google_reviews

video 视频结果

主要字段:

  • items
  • source
  • title
  • url
  • timestamp
  • type: video

子类型通常为 video_element

images 图片结果

主要字段:

  • title
  • url
  • items
  • related_image_searches
  • type: images

related_image_searches 已弃用,始终为 null

shopping 商品结果

主要字段:

  • title
  • items
  • type: shopping

商品通常:

  • title
  • price
  • source
  • description
  • marketplace
  • marketplace_url
  • rating

主要字段:

  • title
  • seller
  • image_url
  • items

商品项目还可能:

  • snippet
  • seller
  • more_sellers
  • price
  • rating
  • product_identifiers

product_identifiers

字段类型说明
product_idstringGoogle Shopping 中的商品唯一标识。
data_docidstringSERP 数据唯一标识。
gidstringGoogle Shopping局商品标识。

jobs 招聘结果

主要字段:

  • title
  • url
  • items

招聘项目:

  • title
  • description
  • author
  • job_posted_time
  • contract_type
  • salary
  • url
  • timestamp

events 活动结果

主要字段:

  • type: events
  • url
  • title
  • items

活动项目类型为 events_element,可:

  • title
  • snippet
  • url

find_results_on 平台结果

主要字段:

  • type: find_results_on
  • items

结果项目类型为 find_results_on_element,可:

  • title
  • domain
  • url
  • source

stocks_box 股票信息

主要字段:

  • type: stocks_box
  • title
  • source
  • snippet
  • price
  • url
  • domain
  • table
  • graph

graph.items 中的图表点类型为 graph_element

字段类型说明
datestring日期时间,采用 yyyy-mm-ddThh:mm:ss 格式。
valueinteger对应时间的股票价格。

previous_items 保存前一时间段的收盘数据。

> 股票和汇率结果可能存在延迟,不能视为实时金融报价。

currency_box 汇率换算

主要字段:

字段类型说明
typestring固定为 currency_box
valueinteger换算数值。
converted_valuefloat换算后的数值。
currencystring原始货币。
converted_currencystring目标货币。
timestampstring结果时间。
tableobject汇率表格。
graphobject汇率图表。
previous_itemsarray前一时间段汇率数据。

图表点类型为 graph_element,:

  • date
  • value

recipes 食谱结果

主要字段:

  • type: recipes
  • items

食谱项目可:

  • title
  • url
  • domain
  • source
  • description
  • time
  • rating

top_sights 热门景点

主要字段:

  • type: top_sights
  • items

景点项目可:

  • title
  • url
  • description
  • rating

scholarly_articles 学术文章

主要字段:

  • type: scholarly_articles
  • items
  • title
  • url

文章项目可:

  • title
  • url
  • author
  • description
  • rating

questions_and_answers 问答结果

主要字段:

  • type: questions_and_answers
  • items

问答项目可:

  • url
  • question_text
  • answer_text
  • source
  • votes

hotels_pack店结果

主要字段:

字段类型说明
typestring固定为 hotels_pack
titlestring店模块标题。
date_fromstring住日期,格式为 YYYY-MM-DD
date_tostring离店日期,格式为 YYYY-MM-DD
itemsarray店结果。

项目可:

  • title
  • url
  • description
  • domain
  • rating
  • price
  • is_paid

commercial_units 商业单

主要字段:

  • type: commercial_units
  • title
  • items

项目类型为 commercial_units_element,可:

  • title
  • url
  • domain
  • price
  • source
  • rating

local_services 本地服务

主要字段:

  • type: local_services
  • title
  • url
  • domain
  • items

服务项目类型为 local_services_element,可:

  • title
  • url
  • domain
  • description
  • rating
  • profile_image_url

math_solver 数学计算

主要字段:

字段类型说明
typestring固定为 math_solver
titlestring数学表达式标题。
resultstring方程计算结果。
itemsarray计算步骤。

计算步骤类型为 math_solver_elementmath_solver_expanded_element,可:

  • title
  • expanded_element
  • solution

app 应用结果

主要字段:

  • items
  • type: app

应用项目可:

  • url
  • title
  • description
  • price

product_considerations 产品考虑因素

主要字段:

  • type: product_considerations
  • title
  • items

项目类型为 product_considerations_element,可:

  • title
  • consideration_category
  • expanded_element

展开类型:

  • product_considerations_expanded_element
  • product_considerations_ai_overview_expanded_element

字段:

  • featured_title
  • breadcrumb
  • snippet
  • domain
  • url
  • related_searches
  • timestamp
  • about_this_result
  • items
  • images
  • references

about_this_result 已弃用,始终为 null

short_videos 短视频

主要字段:

  • type: short_videos
  • title
  • items

视频项目可:

  • title
  • url
  • domain
  • source

refine_products 商品筛选建议

主要字段:

  • type: refine_products
  • title
  • items

项目可:

  • title
  • image_url
  • keyword
  • refine_type

perspectives 观点

主要字段:

  • type: perspectives
  • title
  • items

项目可:

  • title
  • description
  • url
  • domain
  • date
  • source
  • timestamp

discussions_and_forums 讨论与论坛

主要字段:

  • type: discussions_and_forums
  • title
  • items

项目可:

  • title
  • url
  • domain
  • source
  • description
  • timestamp
  • posts_count

compare_sites 站点比较

主要字段:

  • type: compare_sites
  • title
  • items

项目可:

  • title
  • url
  • domain
  • image_url
  • source

third_party_reviews 第三方评论

主要字段:

  • type: third_party_reviews
  • reviews_count
  • title
  • url
  • rating
  • position
  • xpath
  • rank_group
  • rank_absolute
  • traffic_cost
  • etv

google_hotels店实体

字段类型说明
hotel_identifierstringGoogle 分的唯一标识,例如 CgoIjaeSlI6CnNpVEAE
urlstring店实体 URL。
typestring固定为 google_hotels

extra 补信息

字段类型说明
core_keywordstring分组中的核心。如果没有匹,返回 null
synonym_clustering_algorithmstring同义词聚类算法。可选值:keyword_metricstext_processing;无法识别时为 null
detected_languagestring系统识别出的语言。
keyword_difficultyinteger自然结果前 10 名的难度,取值范围为 0100

search_intent_info 搜索意图

字段类型说明
main_intentstring主要搜索意图。可选值:informationalnavigationalcommercialtransactional
foreign_intentarray补搜索意图,数组使用与 main_intent 相同的枚举值。
last_updated_timestring搜索意图数据最后更新时间,采用 ISO 8601 格式。

数据记录示例

以下示例展示一条记录的主要结构。为便于,部分大型数组和 SERP素已省略:

json
{
  "keyword": "no deposit cash bonus",
  "location": 2840,
  "language": "en",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 90,
    "cpc": 8.948175,
    "competition": 1,
    "competition_level": "HIGH",
    "low_top_of_page_bid": null,
    "high_top_of_page_bid": null,
    "time_update": "2020-09-12T00:07:43.0733218Z",
    "categories": [],
    "history": {
      "201902": 140,
      "201903": 170,
      "201904": 90,
      "202001": 50,
      "202002": 140
    }
  },
  "serp_info": {
    "check_url": "https://www.google.com/search?q=st%20mark%27s%20campanile%20tickets&num=100&hl=en&gl=US",
    "items_count": 84,
    "keyword_difficulty": 67,
    "se_results_count": 73,
    "time_update": "2022-04-03T14:23:56.6678836Z",
    "previous_updated_time": "2022-02-05T21:18:02.7517072Z",
    "item_types": [
      "organic",
      "featured_snippet",
      "people_also_ask",
      "knowledge_graph"
    ],
    "serp": [
      {
        "type": "organic",
        "title": "How to pronounce TENTATIVELY in English",
        "description": "How to pronounce tentatively. How to say tentatively.",
        "domain": "dictionary.cambridge.org",
        "main_domain": "cambridge.org",
        "url": "https://dictionary.cambridge.org/us/pronunciation/english/tentatively",
        "relative_url": "/us/pronunciation/english/tentatively",
        "is_new": false,
        "is_up": true,
        "is_down": false,
        "previous_rank_absolute": 5,
        "position": "left",
        "rank_group": 1,
        "rank_absolute": 4,
        "etv": 33.44,
        "traffic_cost": 0
      },
      {
        "type": "featured_snippet",
        "title": "BRS Deluxe Carbon & GFO Reactor",
        "domain": "www.youtube.com",
        "main_domain": "youtube.com",
        "url": "https://www.youtube.com/watch?v=RNEZ8H_DLgQ",
        "is_new": true,
        "is_up": false,
        "is_down": false,
        "previous_rank_absolute": 0,
        "position": "left",
        "rank_group": 1,
        "rank_absolute": 1
      }
    ]
  },
  "extra": {
    "core_keyword": null,
    "synonym_clustering_algorithm": null,
    "detected_language": "en",
    "keyword_difficulty": 22
  },
  "search_intent_info": {
    "main_intent": "navigational",
    "foreign_intent": [],
    "last_updated_time": "2023-03-03T08:19:40.9387576Z"
  }
}

计费说明

数据库费用取决于数据库的:

  • 文件规模;
  • 地区参数;
  • 语言参数;
  • 数据范围。

本页面未提供固定单价。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

实用场景

  • 筛选高搜索量、低竞争度,建立选题和优级单,提升 SEO 资源效率。
  • 分析目标的 SERP 特性分布,识别精选摘要、问答、知识图谱、视频和商品模块,制定匹搜索结果页面的策略。
  • 对比自然结果与付费结果,结合 rank_absoluteetvtraffic_costcpc 评估的自然流量价值与广告竞争强度。
  • 追踪历史搜索量和 SERP 排名变化,发现季节性需求、排名波动及优化机会。
  • 提取搜索意图与问题,按信息型、导航型、商业型和交易型意图规划集群、落地页及转化路径。

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