概览页数据
说明:
- 以下接口对应控制台品牌首页「概览」:顶部指标卡、品牌趋势、竞品对比、分组明细、引用域名排行、引用文章排行。
- 筛选条件与页面顶部一致:时间范围、大模型、用户提问分类、提问标签。未传
platforms、title_ids、tag_ids时表示不限制。 - 带
fluctuation的指标中,value为当前值,fluctuation为相对上一同等长度周期的变化值。 - 品牌提及率为百分比;平均排名仅统计已提及品牌的回答,数值越小表示排名越靠前。
- 用户提问分类ID可通过「获取用户提问分类列表」取得;竞品ID可通过「获取竞品列表」取得。
获取概览指标
- 请求方法:POST
- 请求路径:
/geo/base/dashboard
说明:
- 该接口用于获取首页顶部的品牌提及率、平均排名、曝光效果分数。
brand_id、begin_date、end_date必填。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| exposure.value | float | 品牌提及率 |
| exposure.fluctuation | float | 品牌提及率变化值 |
| avg_rank.value | float | 平均排名 |
| avg_rank.fluctuation | float | 平均排名变化值 |
| score.value | float | 曝光效果分数 |
| score.fluctuation | float | 曝光效果分数变化值 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"exposure": {
"value": 8.5,
"fluctuation": -0.2
},
"avg_rank": {
"value": 5.2,
"fluctuation": 2.62
},
"score": {
"value": 6,
"fluctuation": -1.1
}
}
}获取监控用户提问
- 请求方法:POST
- 请求路径:
/geo/prompt/trends
说明:
- 该接口用于获取首页顶部的监控用户提问数量、变化值,以及按日变化趋势。
brand_id、begin_date、end_date必填。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| prompt_count | int | 当前监控用户提问数 |
| fluctuation | int | 监控用户提问数变化值 |
| prompt_trends | object 数组 | 按日变化趋势 |
| prompt_trends.date | string | 日期,格式:YYYY-MM-DD |
| prompt_trends.prompt_count | int | 当日监控用户提问数 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"prompt_count": 46,
"fluctuation": 2,
"prompt_trends": [
{
"date": "2026-08-25",
"prompt_count": 44
},
{
"date": "2026-08-31",
"prompt_count": 46
}
]
}
}获取品牌提及率趋势
- 请求方法:POST
- 请求路径:
/geo/exposure/trends
说明:
- 该接口用于获取首页「品牌趋势」中的品牌提及率、平均排名按日数据,以及已选竞品的同期数据。
brand_id、begin_date、end_date必填。- 未传
competitor_ids时,仅返回本品牌趋势。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| competitor_ids | string 数组 | 竞品ID列表 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| brand_statistics | object 数组 | 本品牌按日统计 |
| brand_statistics.date | string | 日期,格式:YYYY-MM-DD |
| brand_statistics.name | string | 品牌名称 |
| brand_statistics.exposure | float | 品牌提及率 |
| brand_statistics.avg_rank | float | 平均排名 |
| brand_statistics.task_count | int | 当日监测回答数 |
| competitor_statistics | object 数组 | 竞品按日统计 |
| competitor_statistics.competitor_id | string | 竞品ID |
| competitor_statistics.name | string | 竞品名称 |
| competitor_statistics.statistics | object 数组 | 该竞品按日统计 |
| competitor_statistics.statistics.date | string | 日期,格式:YYYY-MM-DD |
| competitor_statistics.statistics.exposure | float | 竞品提及率 |
| competitor_statistics.statistics.avg_rank | float | 竞品平均排名 |
| competitor_statistics.statistics.task_count | int | 当日监测回答数 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"brand_statistics": [
{
"date": "2026-08-25",
"name": "测试品牌A",
"exposure": 8.7,
"avg_rank": 5.1,
"task_count": 46
},
{
"date": "2026-08-31",
"name": "测试品牌A",
"exposure": 8.5,
"avg_rank": 5.2,
"task_count": 46
}
],
"competitor_statistics": [
{
"competitor_id": "competitor_test_001",
"name": "测试竞品A",
"statistics": [
{
"date": "2026-08-25",
"exposure": 2.1,
"avg_rank": 7.4,
"task_count": 46
},
{
"date": "2026-08-31",
"exposure": 1.98,
"avg_rank": 7.6,
"task_count": 46
}
]
}
]
}
}获取曝光效果分数趋势
- 请求方法:POST
- 请求路径:
/geo/score/trends
说明:
- 该接口用于获取首页「品牌趋势」切换为曝光效果分数时的按日数据,以及已选竞品的同期数据。
brand_id、begin_date、end_date必填。- 未传
competitor_ids时,仅返回本品牌趋势。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| competitor_ids | string 数组 | 竞品ID列表 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| brand_statistics | object 数组 | 本品牌按日统计 |
| brand_statistics.date | string | 日期,格式:YYYY-MM-DD |
| brand_statistics.name | string | 品牌名称 |
| brand_statistics.score | float | 曝光效果分数 |
| brand_statistics.task_count | int | 当日监测回答数 |
| competitor_statistics | object 数组 | 竞品按日统计 |
| competitor_statistics.competitor_id | string | 竞品ID |
| competitor_statistics.name | string | 竞品名称 |
| competitor_statistics.statistics | object 数组 | 该竞品按日统计 |
| competitor_statistics.statistics.date | string | 日期,格式:YYYY-MM-DD |
| competitor_statistics.statistics.score | float | 竞品曝光效果分数 |
| competitor_statistics.statistics.task_count | int | 当日监测回答数 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"brand_statistics": [
{
"date": "2026-08-25",
"name": "测试品牌A",
"score": 7.1,
"task_count": 46
},
{
"date": "2026-08-31",
"name": "测试品牌A",
"score": 6,
"task_count": 46
}
],
"competitor_statistics": [
{
"competitor_id": "competitor_test_001",
"name": "测试竞品A",
"statistics": [
{
"date": "2026-08-25",
"score": 3.2,
"task_count": 46
},
{
"date": "2026-08-31",
"score": 2.8,
"task_count": 46
}
]
}
]
}
}获取品牌与竞品提及率对比
- 请求方法:POST
- 请求路径:
/geo/exposure/rank
说明:
- 该接口用于获取首页「竞品对比」中的品牌提及率、平均排名对比结果。
brand_id、begin_date、end_date必填。competitor_id为0表示当前品牌,其余为竞品。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| competitor_ids | string 数组 | 竞品ID列表;不传时返回本品牌及全部竞品 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| competitor_id | string | 对比对象ID;0 表示当前品牌 |
| competitor_name | string | 对比对象名称 |
| exposure | float | 品牌提及率 |
| fluctuation | float | 品牌提及率变化值 |
| avg_rank.value | float | 平均排名 |
| avg_rank.fluctuation | float | 平均排名变化值 |
响应示例:
{
"code": 0,
"msg": "success",
"data": [
{
"competitor_id": "0",
"competitor_name": "测试品牌A",
"exposure": 8.5,
"fluctuation": -0.2,
"avg_rank": {
"value": 5.2,
"fluctuation": 2.62
}
},
{
"competitor_id": "competitor_test_001",
"competitor_name": "测试竞品A",
"exposure": 1.98,
"fluctuation": 0.1,
"avg_rank": {
"value": 7.6,
"fluctuation": 0.2
}
}
]
}获取品牌与竞品曝光效果分数对比
- 请求方法:POST
- 请求路径:
/geo/score/rank
说明:
- 该接口用于获取首页「竞品对比」切换为曝光效果分数时的对比结果。
brand_id、begin_date、end_date必填。competitor_id为0表示当前品牌,其余为竞品。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| competitor_ids | string 数组 | 竞品ID列表;不传时返回本品牌及全部竞品 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| competitor_id | string | 对比对象ID;0 表示当前品牌 |
| competitor_name | string | 对比对象名称 |
| score | float | 曝光效果分数 |
| fluctuation | float | 曝光效果分数变化值 |
响应示例:
{
"code": 0,
"msg": "success",
"data": [
{
"competitor_id": "0",
"competitor_name": "测试品牌A",
"score": 6,
"fluctuation": -1.1
},
{
"competitor_id": "competitor_test_001",
"competitor_name": "测试竞品A",
"score": 2.8,
"fluctuation": -0.4
}
]
}获取分组指标
- 请求方法:POST
- 请求路径:
/geo/title/rank
说明:
- 该接口用于获取首页底部按用户提问分类汇总的提及率、平均排名、曝光效果分数。
brand_id、begin_date、end_date必填。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| exposure | object 数组 | 按分类汇总的品牌提及率 |
| exposure.title_id | string | 用户提问分类ID |
| exposure.title_name | string | 用户提问分类名称 |
| exposure.exposure | float | 品牌提及率 |
| exposure.fluctuation | float | 品牌提及率变化值 |
| avg_rank | object 数组 | 按分类汇总的平均排名 |
| avg_rank.title_id | string | 用户提问分类ID |
| avg_rank.title_name | string | 用户提问分类名称 |
| avg_rank.avg_rank | float | 平均排名 |
| avg_rank.fluctuation | float | 平均排名变化值 |
| score | object 数组 | 按分类汇总的曝光效果分数 |
| score.title_id | string | 用户提问分类ID |
| score.title_name | string | 用户提问分类名称 |
| score.score | float | 曝光效果分数 |
| score.fluctuation | float | 曝光效果分数变化值 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"exposure": [
{
"title_id": "title_test_001",
"title_name": "产品选型",
"exposure": 12.5,
"fluctuation": 1.2
}
],
"avg_rank": [
{
"title_id": "title_test_001",
"title_name": "产品选型",
"avg_rank": 4.8,
"fluctuation": -0.3
}
],
"score": [
{
"title_id": "title_test_001",
"title_name": "产品选型",
"score": 7,
"fluctuation": 0.5
}
]
}
}获取引用域名排行
- 请求方法:POST
- 请求路径:
/geo/domain/rank
说明:
- 该接口用于获取首页「引用域名排行榜」。按引用次数降序返回大模型回答中引用过的域名。
brand_id、begin_date、end_date必填。- 首页预览通常传
page=1、page_size=5;查看全部时按分页拉取,total为符合条件的域名总数。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| prompt_ids | string 数组 | 用户提问ID列表 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
| domain | string | 域名关键字,按域名模糊匹配 | 否 |
| page | int | 页码,从 1 开始 | 否 |
| page_size | int | 每页数量 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| reference_count | object 数组 | 引用域名列表,按引用次数降序 |
| reference_count.domain | string | 引用域名 |
| reference_count.count | int | 引用次数 |
| reference_count.is_own | bool | 是否为当前品牌官网域名 |
| total | int | 符合条件的域名总数 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"reference_count": [
{
"domain": "www.iesdouyin.com",
"count": 829,
"is_own": false
},
{
"domain": "blog.csdn.net",
"count": 252,
"is_own": false
}
],
"total": 347
}
}获取引用文章排行
- 请求方法:POST
- 请求路径:
/geo/article/rank
说明:
- 该接口用于获取首页「引用文章排行榜」。按引用次数降序返回大模型回答中引用过的文章。
brand_id、begin_date、end_date必填。- 首页预览通常传
page=1、page_size=5;查看全部时按分页拉取,total为符合条件的文章总数。 - 未纳入平台追踪的文章,
article_id为空,source为0。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| title_ids | string 数组 | 用户提问分类ID列表 | 否 |
| prompt_ids | string 数组 | 用户提问ID列表 | 否 |
| platforms | string 数组 | 大模型平台筛选;空数组或不传表示全部平台 | 否 |
| tag_ids | string 数组 | 提问标签ID列表 | 否 |
| keyword | string | 关键字,按文章标题或域名模糊匹配 | 否 |
| page | int | 页码,从 1 开始 | 否 |
| page_size | int | 每页数量 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| reference_count | object 数组 | 引用文章列表,按引用次数降序 |
| reference_count.article | string | 文章标题 |
| reference_count.url | string | 文章链接 |
| reference_count.domain | string | 文章所属域名 |
| reference_count.count | int | 引用次数 |
| reference_count.source | int | 文章来源:0-未关联追踪文章,1-平台创作,2-用户创作,3-官网文章 |
| reference_count.article_id | string | 已追踪文章的文章ID;未追踪时为空 |
| total | int | 符合条件的文章总数 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"reference_count": [
{
"article": "谁说20岁的女生要用贵价护肤品",
"url": "https://www.iesdouyin.com/share/video/example",
"domain": "www.iesdouyin.com",
"count": 38,
"source": 0,
"article_id": ""
},
{
"article": "新手护肤入门看这一篇就够",
"url": "https://blog.csdn.net/example/article",
"domain": "blog.csdn.net",
"count": 38,
"source": 2,
"article_id": "article_test_001"
}
],
"total": 1052
}
}获取可筛选的大模型平台
- 请求方法:POST
- 请求路径:
/geo/team/get/filter_platforms
说明:
- 该接口用于获取当前团队可用的大模型平台列表,作为概览页
platforms入参使用。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| team_id | string | 团队ID | 是 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| data | object | 平台映射;key 为平台展示名,value 为平台标识 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"DEEPSEEK": "deepseek",
"DOUBAO": "doubao",
"YUANBAO": "yuanbao",
"KIMI": "kimi",
"CHATGPT": "chatgpt"
}
}