我们自己的访问统计默认开启。Google Analytics 只在你同意后启用,用来了解公开页面是否有用,不统计登录后的工作台。详见 隐私政策。

Google 趋势

Google 趋势 API

比较 1–5 个关键词在 Google 上的搜索热度随时间的变化(0–100 的相对值),可选国家、时间范围(一天到五年)和搜索类型(网页、新闻、YouTube、图片、购物),用来看季节性、需求起落和品牌对比;给的是相对热度,不是搜索次数。 调用 POST /api/v1/social ;返回结构化 JSON,$8.81 / 千次;失败不计费。

平台运行状态

24h 健康值
正常
正常

30 天趋势

Google 趋势 能力清单

能力做什么单价24 小时运行状态
搜索热度走势interest_over_time用 interest_over_time 一次比较 1–5 个词在 Google 上的热度随时间的变化。$8.81 / 千次正常

点能力名进它的文档:参数、返回字段、代码示例和试用。

Google 趋势 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

能力必填参数可选参数单次条数模式单价返回字段
interest_over_timekeywordscountry, language, search_type, time_window—同步$8.81 / 千次time · date_from · date_to · values · period_averages · partial · platform

怎么调用 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 表示这个时间点的数据还没统计完(通常是最后一个点)。
Google 趋势 interest_over_time 调用流程一次 Google 趋势 interest_over_time 调用的全过程:向 POST /api/v1/social 发送 platform="google_trends"、action="interest_over_time",以及必填参数 keywords;返回结构化 JSON,含 time、date_from、date_to、values、period_averages 等字段;返回列表,计费 $8.81 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "google_trends"action: "interest_over_time"keywordsEveryInfra$8.81 / 千次2 · 响应 · 列表timedate_fromdate_tovaluesperiod_averages
一次 Google 趋势 interest_over_time 调用的全过程:向 POST /api/v1/social 发送 platform="google_trends"、action="interest_over_time",以及必填参数 keywords;返回结构化 JSON,含 time、date_from、date_to、values、period_averages 等字段;返回列表,计费 $8.81 / 千次,失败与空结果不计费。

Google 趋势 原始字段名

EveryInfra 统一字段名

左边是 Google 趋势 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Google 趋势 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 6 个字段名只在 Google 趋势 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • time
  • date_from
  • date_to
  • values
  • period_averages
  • partial

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

time
这个时间点的起始时刻,UTC,ISO 8601;day、week 时间范围下按分钟或小时取点,看这个字段。
date_from
这个时间点的起始日期(YYYY-MM-DD);按周统计时是一周的第一天。
date_to
这个时间点的结束日期(YYYY-MM-DD);按小时、分钟取点时没有。
values
每个关键词在这个时间点的热度,0–100,以本次查询里所有关键词、所有时间点的最高值为 100;键是关键词。
period_averages
每个关键词在整个时间段的平均热度(每行相同),键是关键词。
partial
true 表示这个时间点的数据还没统计完(通常是最后一个点)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

请求填写示例

一次最多比较 5 个词,热度是 0–100 的相对值;不填 country 看全球,不填 time_window 看过去 12 个月。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

google_trends_interest_over_time.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"google_trends","action":"interest_over_time","params":{"keywords":["openai","anthropic"]}}'

记录字段预览(非真实响应)

仅展示 interest_over_time 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "time": null,
  "date_from": null,
  "date_to": null,
  "values": null,
  "period_averages": null,
  "partial": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

Google 趋势 API 如何比较几个关键词的搜索热度?

用 interest_over_time 一次比较 1–5 个词在 Google 上的热度随时间的变化。

查看 interest_over_time 的 keywords 参数
  • keywords 填 1–5 个词的数组;country 选国家(不填看全球),time_window 选 day、week、month、quarter、year(默认)、five_years,search_type 可看 news、youtube、images、shopping 的热度。
  • 每行是一个时间点:time、date_from、date_to,values 是每个词 0–100 的相对热度(本次查询最高点为 100),比较两个以上的词时带 period_averages;最后一个点常还没统计完,partial 为 true。

Google 趋势 API 常见问题

Google 趋势 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="google_trends"、action 和 params。以 interest_over_time 为例,必填 keywords,可选 country、language、search_type、time_window。一次最多比较 5 个词,热度是 0–100 的相对值;不填 country 看全球,不填 time_window 看过去 12 个月。 Google 趋势 共 1 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Google 趋势 API 怎么收费?

$8.81 / 千次,Google 趋势 全部 1 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 113 次 Google 趋势 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Google 趋势 API 一次能返回多少条数据?

Google 趋势 有 1 个列表接口,包括 interest_over_time。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Google 趋势 API 返回哪些字段?

当前目录为 interest_over_time 列出 time、date_from、date_to、values、period_averages、partial 等 7 个字段名。按全站当前目录统计,6 个字段名只在 Google 趋势 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

Google 趋势 API 如何比较几个关键词的搜索热度?

用 interest_over_time 一次比较 1–5 个词在 Google 上的热度随时间的变化。 keywords 填 1–5 个词的数组;country 选国家(不填看全球),time_window 选 day、week、month、quarter、year(默认)、five_years,search_type 可看 news、youtube、images、shopping 的热度。 每行是一个时间点:time、date_from、date_to,values 是每个词 0–100 的相对热度(本次查询最高点为 100),比较两个以上的词时带 period_averages;最后一个点常还没统计完,partial 为 true。

可以先免费试用 Google 趋势 API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 Google 趋势 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 1 个能力。无需信用卡。

开始调用 Google 趋势 API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 Google 趋势 接口验证结果。

免费开始