提供一至两个关键词、支持的国家名称、起止日期，以及网页、新闻或购物来源。Agent 会获取 DataForSEO 对这段日期内各已报告地区的相对热度估算。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
提供一至两个关键词、支持的国家名称、起止日期，以及网页、新闻或购物来源。Agent 会获取 DataForSEO 对这段日期内各已报告地区的相对热度估算。
查看所选日期范围内的关键词地区热度汇总。可用记录包含地区名称及每个词的相对热度；提交两个词时，还可能提供同一地区内的词间比较，以及跨词、跨地区采用共同基准的比较。Agent 可以整理这些数值，说明每个词在哪些地区相对更受关注，以及两个词的比较情况。
用[Google 搜索]比较[美国]从[2023年1月1日]到[2024年1月1日]期间[rugby]和[cricket]的搜索热度。展示各地区的热度分数和可用的词语对比。解释这些分数代表什么，并标出缺失或数据不足的情况。
数值是相对指标，不是搜索次数或人口比例。每个词各自的地区数值与词间比较采用不同参考基准。地区覆盖和数据时效会有差异；这里不提供随时间变化的趋势曲线。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
完整比较请求request | object | 必填 | 五项均需提供：一至两个关键词、来源类型、开始日期、结束日期和支持的地区名称。它们共同确定地区热度汇总范围；没有单独的区域、语言或翻页设置。
|
内容来源类型request.type | string | 必填 | 必填字符串，长度为 1–256 个字符。使用 web 表示 Google 搜索，news 表示 Google 新闻，ecommerce 表示 Google 购物。这些来源分类供 DataForSEO 建模使用；工具不会自动选择来源。
|
结束日期request.date_to | string | 必填 | 必填字符串，长度为 1–256 个字符。使用 YYYY-MM-DD 格式，与开始日期一起确定所需范围。结果是该日期范围内的地区汇总，不是按日期排列的观测序列。
|
要比较的关键词request.keywords | array | 必填 | 必填数组，包含一至两个关键词。一个关键词可查看其地区热度；两个关键词还可获得可用的词间比较。只提交一个关键词时，没有双词比较。
|
每个关键词request.keywords[] | string | — | 每项为非空字符串，长度为 1–256 个字符。使用普通词语，避免符号、特殊字符或表情。使用非拉丁文字时，选择使用该文字的国家。
|
开始日期request.date_from | string | 必填 | 必填字符串，长度为 1–256 个字符，使用 YYYY-MM-DD 格式。供应商说明 web 的可用历史起点为 2004-01-01，news 和 ecommerce 为 2008-01-01；这不保证整个历史范围内都有完整地区数据。
|
支持的国家名称request.location_name | string | 必填 | 必填字符串，长度为 1–256 个字符。填写供应商支持的完整地区名称，例如 United States 或 United Kingdom。数据对应该地点所属的国家；需填写支持的名称，而非数字国家代码。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"keywords",
"date_from",
"date_to",
"type",
"location_name"
],
"properties": {
"type": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"date_to": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 2,
"minItems": 1
},
"date_from": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"location_name": {
"type": "string",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
DataForSEO 综合相关内容、内容受欢迎程度及多种来源的匿名网络行为来估算热度。这是 DataForSEO 的建模数据，并非 Google Trends 官方观测值。具体定义可查看地区热度说明。
填写一到两个想查询的词语、国家、日期范围和搜索来源。例如，用[Google 搜索]查看[rugby]和[cricket]在[美国]从[2023年1月1日]到[2024年1月1日]的地区热度。查看新闻或网购商品时，选[Google 新闻]或[Google 购物]。
用[Google 搜索]比较[美国]从[2023年1月1日]到[2024年1月1日]期间[rugby]和[cricket]的搜索热度。展示各地区的热度分数和可用的词语对比。解释这些分数代表什么，并标出缺失或数据不足的情况。
每个词的最高热度地区记为 100；两个词在同一地区比较时，该比较也会单独以最高值记为 100，所以不同部分的分数不能直接比较。这些数字是热度估算，不是搜索次数或人数。0 表示数据不足；缺失结果表示没有可用资料。
不是。每个词的地区热度数值，都以该词在相关地区中的最高热度作为 100 的参考。50 是相对于这个参考的数值。每个词各有自己的参考基准，因此两个词都得到 100，也不能说明它们的搜索需求相同。
如果结果包含同一地区内的词间比较，请按随附的关键词顺序读取数值。不要把两个词各自归一化的地区分数当作采用共同基准的数值直接比较。保留报告中的比较值，不假定它们合计为 100，也不换算成人群比例。
它以所提交关键词和相关地区中的最高热度作为共同的 100 参考，便于在同一尺度下阅读这些数值。供应商把这组数据命名为 absolute_items，但其中仍是相对指标，不是实际搜索次数。
供应商将 0 定义为数据不足，不能据此认定没有搜索。只提交一个词时，双词比较为 null。其他缺失数值或地区表示信息不可用；未知的地区标识应保持为空，不要自行补造。
这里汇总的是所选日期范围内的地区相对热度，没有逐周或逐日的趋势曲线。数据覆盖与距今时间会有差异。返回的 UTC 时间记录结果被接收的时刻，不是每个地区数值的采集时间。可将它用于了解建模热度背景，不宜当作当前市场规模。