怎么调用 Google 趋势 搜索热度走势 API?
interest_over_time使用 platform="google_trends"、action="interest_over_time" 调用“搜索热度走势”能力;返回列表,主要包含 time、date_from、date_to、values、period_averages、partial 等 7 个字段。
Google 趋势 interest_over_time 的参数分别是什么意思?
keywords必填- 要比较的搜索词,1–5 个的数组(如 ["openai", "anthropic"]),每个最多 80 字、10 个词。
Google 趋势帮助说明数据来自真实搜索的抽样,每个点除以该地区、该时段的搜索总量后缩放到 0–100,搜索量很少的词显示为 0。这里支撑 values 的含义;本接口的 country、time_window、search_type 筛选由 EveryInfra 定义,该来源不证明结果。官方来源:Google 趋势帮助:关于 Google 趋势数据的常见问题来源核查:
country可选- 看哪个国家的热度,两位国家代码(如 us、gb、jp);不填看全球。
language可选- 语言,两位语言代码(如 en、ja);一般不用填。
search_type可选- 看哪种搜索的热度:web(网页,默认)、news、youtube、images、shopping。
time_window可选- 时间范围:day(过去一天)、week(7 天)、month(30 天)、quarter(90 天)、year(12 个月,默认)、five_years(5 年)。
Google 趋势 返回字段与含义(6)
- date_from
- 这个时间点的起始日期(YYYY-MM-DD);按周统计时是一周的第一天。
- date_to
- 这个时间点的结束日期(YYYY-MM-DD);按小时、分钟取点时没有。
- time
- 这个时间点的起始时刻,UTC,ISO 8601;day、week 时间范围下按分钟或小时取点,看这个字段。
- values
- 每个关键词在这个时间点的热度,0–100,以本次查询里所有关键词、所有时间点的最高值为 100;键是关键词。
- period_averages
- 每个关键词在整个时间段的平均热度(每行相同),键是关键词。
- partial
- true 表示这个时间点的数据还没统计完(通常是最后一个点)。