提供 1–2 个关键词、受支持的国家、起止日期和搜索来源，让 Agent 解读 DataForSEO 返回的年龄与性别相对热度；两个词有数据时，还可查看同一类别内的对比。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
提供 1–2 个关键词、受支持的国家、起止日期和搜索来源，让 Agent 解读 DataForSEO 返回的年龄与性别相对热度；两个词有数据时，还可查看同一类别内的对比。
获取所选期间的人群热度汇总：每个关键词可用的年龄、性别指标，以及两个词在同一年龄或性别类别中的相对比较。可用这些指标探索某个话题在哪些群体中相对更突出。每个词的年龄指标和性别指标分别把最热门类别设为 100；两个词的比较则把它们在同一类别中的合计热度设为 100。
比较[美国]地区从[2023年1月1日]到[2024年1月1日]在[普通网页搜索]中的[橄榄球]和[板球]搜索兴趣估算。按年龄组和性别组展示相对分数；这些不是人数或人群占比。清楚标出数据不足的分组。
这些数值是模型估算的相对指标，不是受众占比、人数或已核实的搜索者资料。返回 0 表示数据不足，缺失类别可能没有可用数据；只提供一个词时没有双词比较。结果是期间汇总，不是逐日或逐月趋势，也不能证明当前活动或覆盖所有人群。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
人群指标请求request | object | 必填 | 必填对象，包含关键词、起止日期、搜索来源和受支持的国家全名。五个属性都必须提供。
|
搜索来源request.type | string | 必填 | 必填字符串。web 表示 Google 搜索，news 表示 Google 新闻，ecommerce 表示 Google 购物。Tool 接受 1–256 字符的非空字符串，请使用供应商支持的这三个值之一。
|
结束日期request.date_to | string | 必填 | 必填字符串，长度 1–256 字符。用 YYYY-MM-DD 格式的日历日期填写所选期间的结束日期。
|
关键词request.keywords | array | 必填 | 必填数组，包含 1–2 个关键词字符串。两个词有数据时可进行同一类别内的比较；一个词只返回自身的人群指标，没有双词比较。
|
关键词内容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 人群指标方法与输入说明。
例如，比较[美国]地区从[2023年1月1日]到[2024年1月1日]在[普通网页搜索]中的[橄榄球]和[板球]。也可以选择新闻文章或网店商品页；日期直接用日常写法。
比较[美国]地区从[2023年1月1日]到[2024年1月1日]在[普通网页搜索]中的[橄榄球]和[板球]搜索兴趣估算。按年龄组和性别组展示相对分数；这些不是人数或人群占比。清楚标出数据不足的分组。
单独看一个词时，100 表示它在对应年龄组或性别组中的相对最高值。比较两个词时，分数只表示这两个词在同一组里的相对热度。它们不是人数或全部搜索者的占比；0 表示数据不足。
不是。每个关键词把最热门年龄组设为 100，最热门性别类别也单独设为 100；其他值分别与这两个最高值比较。它们不必相加等于 100，也不是受众占比。
在返回的同一年龄或性别类别内，双词比较按两词合计热度分配数值，合计为 100。请按返回的关键词顺序对应数值。这不是两词占全部搜索的比例，也不能据此判断该人群的规模；只有一个词时，这项比较为 null。
供应商把 0 定义为数据不足，不是没有人或没有搜索。null 或缺失类别表示没有可用结果。应保留这些区别，不把缺失值补成 0。
选择 web、news 或 ecommerce，提供受支持的国家全名，并填写 YYYY-MM-DD 格式的起止日期。web 可用历史从 2004-01-01 起，news/ecommerce 从 2008-01-01 起。数据以国家为范围，地点名称不能证明结果是精确的城市人群。
这是 DataForSEO 根据内容关联和匿名网络行为来源估算的热度指标。它汇总所选期间，不提供个人搜索者资料或时间序列。响应收到的时间也不能证明全部底层数据的采集时间。