搜索建议
API + MCP查询参数
手动超时时长(秒)。
要返回的结果数量。
用于对结果排序的列。有效的列标识符请参见响应 Schema,但 volume_monthly 除外:该端点的 order_by 不支持它。
过滤表达式。可识别以下列标识符(这与 select 参数可识别的标识符不同)。
cpc:每次点击费用,表示广告主在付费搜索结果中为某关键词的每次广告点击支付的平均价格(单位:美分)。
type: integer nullable
cps:每次搜索点击数(或 CPS)是点击与关键词搜索量的比率。它显示了当人们在给定国家/地区搜索目标关键词时,平均有多少个不同的搜索结果被点击。
type: float nullable
difficulty(10 单位):以 100 分制估算某关键词进入自然搜索结果前 10 名的难度。
type: integer nullable
first_seen:我们首次检查某关键词搜索引擎结果的日期。
type: datetime nullable
global_volume(10 单位):在我们的数据库中,所有国家/地区每月平均搜索目标关键词的次数。
type: integer nullable
intents(10 单位):表示用户搜索查询背后的目的。对象字段:informational、navigational、commercial、transactional、branded 或 local。所有字段类型均为 bool,可能值为 true 或 false。
type: object nullable
keyword:关键词。
type: string
parent_topic:父主题用于判断:在页面上改为覆盖更广泛的主题时,是否仍能通过该页面在目标关键词上获得排名。为识别父主题,我们会取该关键词排名第 1 的页面,并找到为该页面带来最多流量的关键词。
type: string nullable
serp_domain_rating_top10_min:该关键词在前 10 个结果中必须至少有一个排名位置,其 DR 不高于此值。
type: float nullable
serp_domain_rating_top5_min:该关键词在前 5 个结果中必须至少有一个排名位置,其 DR 不高于此值。
type: float nullable
serp_features:搜索引擎结果页(SERP)上的增强型结果,并非传统的自然结果。
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"
serp_last_update:我们上次检查某关键词搜索引擎结果的日期。
type: datetime nullable
traffic_potential(10 单位):目标关键词排名第 1 的页面,从其所有有排名的关键词获得的自然搜索流量总和。
type: integer nullable
volume(10 单位):根据最新可用的 12 个月数据,估算该关键词每月平均搜索量。
type: integer nullable
volume_desktop_pct:该关键词搜索中在桌面设备上完成的占比。
type: float nullable
volume_mobile_pct:该关键词搜索中在移动设备上完成的占比。
type: float nullable
word_count:字数。
type: integer
要返回的列的逗号分隔列表。有效的列标识符请参见响应 Schema。
两个字母的国家代码(ISO 3166-1 alpha-2)。
[已于 2024 年 8 月 5 日弃用]。
用于显示指标的关键词列表,以逗号分隔。
用于显示指标的现有关键词列表的 ID。
输出格式。
响应
每次点击费用显示的是广告商在付费搜索结果中为某个关键词的每次广告点击所支付的平均价格,以美分计。
每次搜索点击数(或 CPS)是点击与关键词搜索量的比率。它显示了当人们在给定国家/地区搜索目标关键词时,平均有多少个不同的搜索结果被点击。
(10 单位)以 100 分制估算某关键词在前 10 个自然搜索结果中排名的难度。
我们首次检查某关键词搜索引擎结果的日期。
(10 个单位) 目标关键词在数据库中所有国家每月平均搜索次数。
(10 个单位) 指示用户搜索查询背后的目的。对象字段:informational、navigational、commercial、transactional、branded 或 local。所有字段类型均为 bool,可能的取值为 true 或 false。
父主题决定是否能通过页面上更一般的主题对目标关键词进行排名。为了识别父主题,我们会提取目标关键词排名第一的页面,并找到为该页面带来最多流量的关键词。
搜索引擎结果页面 (SERP) 上非传统自然搜索结果的丰富结果。
上次检查关键词搜索引擎结果的日期。
(10 个单位) 目标关键词排名第 1 的页面,从其所有排名关键词获得的自然搜索流量总和。
(10 个单位) 基于最近已知的 12 个月数据,对关键词平均每月搜索次数的估算。
在桌面设备上进行的关键词搜索占比。
在移动设备上进行的关键词搜索占比。
(10 个单位) 对关键词最近一个月搜索次数的估算。该字段可能不会包含在 order_by 参数中