Skip to Content
OpenAPI 接入概览页数据

概览页数据

说明:

  • 以下接口对应控制台品牌首页「概览」:顶部指标卡、品牌趋势、竞品对比、分组明细、引用域名排行、引用文章排行。
  • 筛选条件与页面顶部一致:时间范围、大模型、用户提问分类、提问标签。未传 platforms、title_ids、tag_ids 时表示不限制。
  • 带 fluctuation 的指标中,value 为当前值,fluctuation 为相对上一同等长度周期的变化值。
  • 品牌提及率为百分比;平均排名仅统计已提及品牌的回答,数值越小表示排名越靠前。
  • 用户提问分类ID可通过「获取用户提问分类列表」取得;竞品ID可通过「获取竞品列表」取得。

获取概览指标

  • 请求方法:POST
  • 请求路径:/geo/base/dashboard

说明:

  • 该接口用于获取首页顶部的品牌提及率、平均排名、曝光效果分数。
  • brand_id、begin_date、end_date 必填。

请求参数:

入参类型含义是否必填
brand_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否

响应参数:

返回值类型含义
exposure.valuefloat品牌提及率
exposure.fluctuationfloat品牌提及率变化值
avg_rank.valuefloat平均排名
avg_rank.fluctuationfloat平均排名变化值
score.valuefloat曝光效果分数
score.fluctuationfloat曝光效果分数变化值

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
tag_idsstring 数组提问标签ID列表否

响应参数:

返回值类型含义
prompt_countint当前监控用户提问数
fluctuationint监控用户提问数变化值
prompt_trendsobject 数组按日变化趋势
prompt_trends.datestring日期,格式:YYYY-MM-DD
prompt_trends.prompt_countint当日监控用户提问数

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
competitor_idsstring 数组竞品ID列表否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否

响应参数:

返回值类型含义
brand_statisticsobject 数组本品牌按日统计
brand_statistics.datestring日期,格式:YYYY-MM-DD
brand_statistics.namestring品牌名称
brand_statistics.exposurefloat品牌提及率
brand_statistics.avg_rankfloat平均排名
brand_statistics.task_countint当日监测回答数
competitor_statisticsobject 数组竞品按日统计
competitor_statistics.competitor_idstring竞品ID
competitor_statistics.namestring竞品名称
competitor_statistics.statisticsobject 数组该竞品按日统计
competitor_statistics.statistics.datestring日期,格式:YYYY-MM-DD
competitor_statistics.statistics.exposurefloat竞品提及率
competitor_statistics.statistics.avg_rankfloat竞品平均排名
competitor_statistics.statistics.task_countint当日监测回答数

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
competitor_idsstring 数组竞品ID列表否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否

响应参数:

返回值类型含义
brand_statisticsobject 数组本品牌按日统计
brand_statistics.datestring日期,格式:YYYY-MM-DD
brand_statistics.namestring品牌名称
brand_statistics.scorefloat曝光效果分数
brand_statistics.task_countint当日监测回答数
competitor_statisticsobject 数组竞品按日统计
competitor_statistics.competitor_idstring竞品ID
competitor_statistics.namestring竞品名称
competitor_statistics.statisticsobject 数组该竞品按日统计
competitor_statistics.statistics.datestring日期,格式:YYYY-MM-DD
competitor_statistics.statistics.scorefloat竞品曝光效果分数
competitor_statistics.statistics.task_countint当日监测回答数

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
competitor_idsstring 数组竞品ID列表;不传时返回本品牌及全部竞品否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否

响应参数:

返回值类型含义
competitor_idstring对比对象ID;0 表示当前品牌
competitor_namestring对比对象名称
exposurefloat品牌提及率
fluctuationfloat品牌提及率变化值
avg_rank.valuefloat平均排名
avg_rank.fluctuationfloat平均排名变化值

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
competitor_idsstring 数组竞品ID列表;不传时返回本品牌及全部竞品否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否

响应参数:

返回值类型含义
competitor_idstring对比对象ID;0 表示当前品牌
competitor_namestring对比对象名称
scorefloat曝光效果分数
fluctuationfloat曝光效果分数变化值

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否

响应参数:

返回值类型含义
exposureobject 数组按分类汇总的品牌提及率
exposure.title_idstring用户提问分类ID
exposure.title_namestring用户提问分类名称
exposure.exposurefloat品牌提及率
exposure.fluctuationfloat品牌提及率变化值
avg_rankobject 数组按分类汇总的平均排名
avg_rank.title_idstring用户提问分类ID
avg_rank.title_namestring用户提问分类名称
avg_rank.avg_rankfloat平均排名
avg_rank.fluctuationfloat平均排名变化值
scoreobject 数组按分类汇总的曝光效果分数
score.title_idstring用户提问分类ID
score.title_namestring用户提问分类名称
score.scorefloat曝光效果分数
score.fluctuationfloat曝光效果分数变化值

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
prompt_idsstring 数组用户提问ID列表否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否
domainstring域名关键字,按域名模糊匹配否
pageint页码,从 1 开始否
page_sizeint每页数量否

响应参数:

返回值类型含义
reference_countobject 数组引用域名列表,按引用次数降序
reference_count.domainstring引用域名
reference_count.countint引用次数
reference_count.is_ownbool是否为当前品牌官网域名
totalint符合条件的域名总数

响应示例:

{ "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_idstring品牌ID是
begin_datestring开始日期,格式:YYYY-MM-DD是
end_datestring结束日期,格式:YYYY-MM-DD是
title_idsstring 数组用户提问分类ID列表否
prompt_idsstring 数组用户提问ID列表否
platformsstring 数组大模型平台筛选;空数组或不传表示全部平台否
tag_idsstring 数组提问标签ID列表否
keywordstring关键字,按文章标题或域名模糊匹配否
pageint页码,从 1 开始否
page_sizeint每页数量否

响应参数:

返回值类型含义
reference_countobject 数组引用文章列表,按引用次数降序
reference_count.articlestring文章标题
reference_count.urlstring文章链接
reference_count.domainstring文章所属域名
reference_count.countint引用次数
reference_count.sourceint文章来源:0-未关联追踪文章,1-平台创作,2-用户创作,3-官网文章
reference_count.article_idstring已追踪文章的文章ID;未追踪时为空
totalint符合条件的文章总数

响应示例:

{ "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_idstring团队ID是

响应参数:

返回值类型含义
dataobject平台映射;key 为平台展示名,value 为平台标识

响应示例:

{ "code": 0, "msg": "success", "data": { "DEEPSEEK": "deepseek", "DOUBAO": "doubao", "YUANBAO": "yuanbao", "KIMI": "kimi", "CHATGPT": "chatgpt" } }
Answerbit - AI搜索可见度追踪平台