Skip to main content
POST
分页查询指定品牌在指定时间范围内命中负面关键词的 AI 对话问题详情,返回每个问题的负面关键词列表、情感得分、AI 平台、品牌曝光次数与所属主题。
执行模式:SYNC · 实时请求。 请求发出后服务端同步执行业务,结果直接在当前响应的 data 中返回,不存在异步任务、无需轮询、无需二次查询。

接口速查

请求头

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

请求体

string
required
固定为 sentiment.prompt.negative.details。
object
required
业务请求参数对象。
string
required
品牌 ID。所属品牌 ID,为空返回 4001
string
AI平台。按 AI 平台筛选,如 deepseek;不传返回全部平台
string
开始日期。格式 yyyy-MM-dd;默认最近 7 天
string
结束日期。格式 yyyy-MM-dd;默认今天,不能晚于今天
integer
页码。默认 1
integer
每页条数。默认 50,最大 100,超限自动截断为 100
时间范围规则:startDate/endDate 不传时默认查询最近 7 天;endDate 晚于今天会被自动截断为今天;起止时间跨度最大 6 个月;开始日期晚于结束日期将直接报错。

返回参数

业务结果位于 data,为分页结构,其中 records 为 AI 对话口碑负面详情列表。无数据时返回空记录分页(records 为空数组、total 为 0)。
object[]
AI对话口碑负面详情列表。命中负面关键词的 AI 对话问题详情。
object[]
负面关键词列表。仅包含负面情感命中的关键词数组。
string
情感倾向。取值 正面 / 中性 / 负面。
integer
情感得分。取值范围 -100 ~ 100,负值代表负面。
string
AI平台名称。如 豆包、DeepSeek、腾讯元宝 等。
string
AI对话问题ID。AI 对话问题的唯一标识。
integer
曝光次数。品牌在该问题下的曝光次数,0 表示未提及品牌。
string
AI对话问题。AI 对话问题原文。
string
主题名称。问题所属业务主题,无归属时为 null。
string
查询日期。查询日期,格式 yyyy-MM-dd。
integer
required
记录总数。
integer
required
每页条数。
integer
required
当前页码。
integer
required
总页数。

接入注意事项

  1. apiCode 必须固定为 sentiment.prompt.negative.details。
  2. brandId 为必填参数,为空返回 4001(所需参数不足)。
  3. startDate/endDate 格式必须为 yyyy-MM-dd,默认最近 7 天,最大查询跨度 6 个月。
  4. 返回结构为分页对象;无数据时返回空记录分页(records 为空数组、total 为 0)。
  5. 仅返回命中负面关键词的 AI 对话问题,按记录创建时间倒序。
  6. sentimentScore 取值范围 -100 ~ 100,负值代表负面。
  7. topicName 无归属主题时为 null;negativeKeywordsList 为负面关键词数组。
  8. pageNo 默认 1,pageSize 默认 50、最大 100,超限自动截断为 100。
完整响应类型可表示为 ReturnResult<PageResult<PromptNegativeDetail>>(PageResult 定义见 6.2.5)。
可按以上 TypeScript 类型定义解析响应数据。
本页的 cURL 与 Java 示例来自官方接口文档;Python 与 Node.js 示例为等价转写,未经服务端联调,请以实际返回结果为准。