DataForSEODataForSEO

Google 热门搜索实时查询

/dataforseo_labs_google_top_searches_live

DataForSEO Labs 热门搜索接口可访问 DataForSEO 关键词数据库中超过七十亿(7 billion) 个关键词。每个返回的关键词都包含 Google Ads 指标、商品类别及 Google 搜索结果等相关数据。

最近 7 天完成的调用
0

统计不包含取消的调用。执行时间仅统计成功调用。

通过你的 Agent 使用

请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 DataForSEO 的 /dataforseo_labs_google_top_searches_live 接口。

输入参数

location_name选填
地区的完整名称。 未指定以下字段时必填: location_code;注意: 必须至少指定以下其中一项: location_name 或 location_code;可单独请求下列地址,获取可用地区及其 location_name : https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;例如: United Kingdom
location_code选填
地区代码。 未指定以下字段时必填: location_name;注意: 必须至少指定以下其中一项: location_name 或 location_code;可单独请求下列地址,获取可用地区及其 location_code : https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;例如: 2840
language_name选填
语言的完整名称。 未指定以下字段时必填: language_code;注意: 必须至少指定以下其中一项: language_name 或 language_code;可单独请求下列地址,获取可用地区及其 language_name : https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;例如: English
language_code选填
语言代码。 未指定以下字段时必填: language_name;注意: 必须至少指定以下其中一项: language_name 或 language_code;可单独请求下列地址,获取可用地区及其 language_code : https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;例如: en
include_serp_info选填
包含各关键词的搜索结果页数据,可选。true 时为响应中每个关键词返回 serp_info 数组,包含搜索结果数量、相关 URL 和搜索结果页特性。默认 false。
ignore_synonyms选填
忽略高度相似的关键词。 可选字段。设为 true 仅返回核心关键词,排除所有高度相似的关键词; 默认值: false
filters选填
结果筛选参数数组。 可选字段。 可同时添加多个筛选条件(最多 8 个)。 请在条件间设置逻辑运算符 and , or 。支持以下运算符: regex , not_regex , < , <= , > , >= , = , <> , in , not_in , match , not_match , ilike , not_ilike , like , not_like 可将 % 与 like、not_like、ilike、not_ilike 配合使用,匹配任意零个或多个字符的字符串。 例如: ["keyword_info.search_volume",">",0] [["keyword_info.search_volume","in",[0,1000]], "and", ["keyword_info.competition_level","=","LOW"]] [["keyword_info.search_volume",">",100], "and", [["keyword_info.cpc","<",0.5], "or", ["keyword_info.high_top_of_page_bid","<=",0.5]]] 筛选条件详情参见 Dataforseo Labs 筛选说明 或此 帮助中心指南
order_by选填
结果排序规则。 可选字段。可使用 filters 数组中相同的字段值对结果排序。 可用排序类型: asc :按升序排列结果; desc :按降序排列结果; 请使用逗号指定排序类型。 例如: ["keyword_info.competition,desc"] 默认规则: ["keyword_info.search_volume,desc"];注意:单次请求最多设置三条排序规则。 请使用逗号分隔多个排序规则。 例如: ["keyword_info.search_volume,desc","keyword_info.cpc,desc"]
limit必填
返回关键词数上限,可选。可在后续请求中使用每次响应提供的 offset_token,获取超过 1000 条结果。默认 1000,最大 1000。
offset选填
返回关键词结果数组的偏移量。 可选字段。默认值: 0 指定为 10 时,跳过结果数组的前十个关键词,返回后续关键词。 注意: 建议仅在获取不超过 10,000 条结果时使用此参数;超过 10,000 条结果请使用 offset_token 。
offset_token选填
后续请求使用的偏移令牌。 可选字段。 由每次请求响应中的同名字段提供。; 单次请求获取超过 10,000 条结果时,可用此参数避免超时; 指定唯一的 offset_token 响应数组中的值,可获取初始任务的后续结果; offset_token 各后续任务的值均唯一。 注意: 请求指定 offset_token 时,处理任务将忽略除 limit 之外的所有其他参数。. 此参数详情参见帮助中心。
include_clickstream_data必填
仅使用 Basic 费率;付费的点击流升级已禁用。

输入示例

{
  "language_name": "English",
  "location_code": 2840,
  "limit": 3,
  "include_clickstream_data": false
}

输出

原生任务结果封装;在支持时包含条目、聚合结果和分页信息。