DataForSEODataForSEO

Google Trends 实时探索

/keywords_data_google_trends_explore_live

获取 Google Trends“探索”功能的关键词热度数据,可查询 Google 搜索、Google 新闻、Google 图片、Google 购物及 YouTube 的关键词趋势。

最近 7 天完成的调用
0

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

通过你的 Agent 使用

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

输入参数

keywords选填
关键词,未指定 `category_code` 时必填。最多 5 个,每个最多 100 个字符,长度必须大于 1。输入关键词中的逗号会移除并忽略。关键词不能由以下字符组合而成:< > | " - + = ~ ! : * ( ) [ ] { }。获取 google_trends_topics_list 和 google_trends_queries_list 条目时最多指定 1 个关键词。DataForSEO API 中 keyword 和 keywords 字段的规则及限制参见帮助中心文章。
location_name选填
搜索引擎地区完整名称,可选。不使用则返回全球结果。提供后无需 location_code。可使用数组设置多个地区,分别对应特定关键词,详情参见相关说明。可请求 https://api.dataforseo.com/v3/keywords_data/google_trends/locations 获取可用地区及 location_name。例如:United Kingdom。
location_code选填
搜索引擎地区代码,可选。不使用则返回全球结果。提供后无需 location_name。可使用数组设置多个地区,分别对应特定关键词,详情参见相关说明。可请求 https://api.dataforseo.com/v3/keywords_data/google_trends/locations 获取可用地区及 location_code。例如:2840。
language_name选填
搜索引擎语言的完整名称。 可选字段。默认值: English;使用此字段后无需指定 language_code;可单独请求下列地址,获取搜索引擎可用语言及其 language_name : https://api.dataforseo.com/v3/keywords_data/google_trends/languages;例如: English
language_code选填
搜索引擎语言代码。 可选字段。默认值: en;使用此字段后无需指定 language_name;可单独请求下列地址,获取搜索引擎可用语言及其 language_code : https://api.dataforseo.com/v3/keywords_data/google_trends/languages;例如: en
type选填
元素类型
category_code选填
Google Trends 搜索分类,未指定 `keywords` 时必填。未指定 `keywords` 时此值必须大于 `0`;提供 `keywords` 但不提供此字段时,默认 0,搜索所有可用分类。可请求 https://api.dataforseo.com/v3/keywords_data/google_trends/categories 获取可用分类及 category_code。
date_from选填
时间范围起始日期,可选。未指定时默认去年的同月同日。web 类型最早为 2004-01-01,其他类型最早为 2008-01-01。日期格式为 "yyyy-mm-dd",例如 "2019-01-15"。
date_to选填
时间范围结束日期,可选。未指定时默认今天。日期格式为 "yyyy-mm-dd",例如 "2019-01-15"。
time_range选填
预设时间范围,可选。指定 date_from 或 date_to 时忽略此字段。所有 type 均支持:past_hour、past_4_hours、past_day、past_7_days、past_30_days、past_90_days、past_12_months、past_5_years。仅 web 支持 2004_present;news、youtube、images、froogle 支持 2008_present。
item_types选填
返回条目类型,可选。为加快请求,每次指定一种。可用值:"google_trends_graph"、"google_trends_map"、"google_trends_topics_list"、"google_trends_queries_list",默认 "google_trends_graph"。获取 google_trends_topics_list 或 google_trends_queries_list 时,keywords 字段最多指定 1 个关键词。

输入示例

{
  "location_name": "United States",
  "date_from": "2019-01-01",
  "date_to": "2020-01-01",
  "type": "youtube",
  "category_code": 3,
  "keywords": [
    "rugby",
    "cricket"
  ]
}

输出

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