Skip to main content
POST
查询指定品牌下 AI 对话问题在各 AI 平台的监测明细,包括推荐/曝光情况、情感分析、品牌排名、Top3 竞品、提及商品数量及 AI 平台回答原文等。支持多条件组合筛选、时间范围限制、排序与分页,是监测能力最完整的实时查询接口。
执行模式:SYNC · 实时请求。 请求发出后服务端同步执行业务,结果直接在当前响应的 data 中返回,不存在异步任务、无需轮询、无需二次查询。

接口速查

请求头

string
required
开发者 API Key,例如 AIBase_xxx。用于身份认证、有效期与调用权限校验,请仅在服务端保存和使用。
string
required
固定为 application/json。
string
开发者自定义请求 ID,用于请求追踪;不传时系统自动生成 UUID。

请求体

string
required
固定为 prompt.analysis.detail
string
required
所属品牌 ID,为空返回 4001
string
按主题筛选
string
按AI对话问题关键词筛选
string
按 AI 平台筛选,如 deepseek
string
格式 yyyy-MM-dd;默认最近 7 天
string
格式 yyyy-MM-dd;默认今天,不能晚于今天
integer
默认 1
integer
默认 50,最大 100,超限自动截断为 100
string
见下方排序字段说明;默认按查询日期倒序
string
如 ASC / DESC
string
情感类型筛选,如 正面 / 中性 / 负面
string
按具体问题筛选
string
情感词类型,如 positive
string
情感关键词筛选

排序字段说明

时间范围规则:startDate/endDate 不传时默认查询最近 7 天;endDate 晚于今天会被自动截断为今天;起止时间跨度最大 6 个月,超范围自动截断;开始日期晚于结束日期将直接报错。

返回参数

业务结果位于 data,为分页结构,其中 records 为分析明细列表。
object[]
AI 对话问题分析明细。
string
问题唯一标识。
string
AI 对话问题文本。
string
所属主题名称。
string
所属主题 ID。
string
本次分析对应的 AI 平台。
integer
品牌被推荐/曝光次数。
string
如 正面 / 中性 / 负面。
number
情感得分。
integer
品牌在该回答中的排名,未上榜时为 0。
string
回答中出现的前 3 个竞品,逗号分隔,可能为 null。
string
格式 yyyy-MM-dd。
integer
该问题提及的商品数量,无商品为 0。
object
正/负/中性情感关键词列表,可能为 null。
object
同上,见上方分页字段说明。
object
同上,见上方分页字段说明。
string
大模型回答原文,可能较长或为 null。
long / integer
总数、每页条数、当前页、总页数。
long / integer
同上,见上方分页字段说明。
long / integer
同上,见上方分页字段说明。
long / integer
同上,见上方分页字段说明。

接入注意事项

  1. apiCode 必须固定为 prompt.analysis.detail。
  2. brandId 为必填参数,为空返回 4001(所需参数不足)。
  3. startDate/endDate 格式必须为 yyyy-MM-dd,默认最近 7 天,最大查询跨度 6 个月。
  4. endDate 不能晚于今天;开始日期晚于结束日期会报错。
  5. pageSize 默认 50,最大 100,超限自动截断为 100。
  6. fieldSort 仅支持文档列出的取值,非法值将回退为默认排序(查询日期倒序)。
  7. position = 0 表示品牌未上榜,不代表接口失败。
  8. competitorsTop3、三个情感关键词字段及 resultContent 可能为 null,解析时做好空值兼容。
  9. 本接口查询数据量较大,建议使用筛选条件缩小范围,控制 pageSize。
完整响应类型可表示为 ReturnResult<PageResult<PromptAnalysisDetail>>(PageResult 定义见 6.2.5)。
可按以下 TypeScript 类型定义解析响应数据。
本页的 cURL 与 Java 示例来自官方接口文档;Python 与 Node.js 示例为等价转写,未经服务端联调,请以实际返回结果为准。