Skip to main content
POST
查询指定品牌在指定时间范围内各 AI 对话问题在各平台的排名表现,按 AI 对话问题(promptText)分组返回问题的曝光率、平均提及位次、问题数量、情感得分、Top1/Top3/Top10/十名以后命中数量与排名等级等,便于分析具体问题在 AI 平台上的表现。
执行模式:SYNC · 实时请求。 请求发出后服务端同步执行业务,结果直接在当前响应的 data 中返回,不存在异步任务、无需轮询、无需二次查询。

接口速查

请求头

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

请求体

string
required
固定为 llm.prompt
string
required
所属品牌 ID,为空返回 4001
string
按 AI 平台筛选,如 deepseek;不传返回全部平台
string
格式 yyyy-MM-dd;默认最近 7 天
string
格式 yyyy-MM-dd;默认今天,不能晚于今天
时间范围规则:startDate/endDate 不传时默认查询最近 7 天;endDate 晚于今天会被自动截断为今天;起止时间跨度最大 6 个月;开始日期晚于结束日期将直接报错。

返回参数

业务结果位于 data,为按 AI 对话问题(promptText)分组的结构,每个问题对应该问题在各平台的统计数组。无数据时 data 为空对象 {}。
本接口 data 为按名称分组的映射结构:下表中的 <分组名>[] 表示各分组下的统计数组,实际键名为动态值(平台名 / 主题名 / 意图名 / AI 对话问题文本)。
object
键为 AI 对话问题文本,值为该问题在各平台的统计数组。
string
AI 平台名称。
string
问题所属主题名称。
string
问题的场景意图。
string
AI 对话问题文本。
number
该问题下品牌的曝光率(%)。
number
品牌在该问题的平均提及位次。
integer
该问题的 AI 对话问题数量。
number
该问题的情感得分。
integer
品牌排名第1 的命中数量。
integer
品牌排名前3 的命中数量。
integer
品牌排名前10 的命中数量。
integer
品牌排名在 10 以后的命中数量。
string
排名等级:top1 / top3 / top10 / top10之外 / 未命中。
string
AI 对话问题唯一标识。

接入注意事项

  1. apiCode 必须固定为 llm.prompt。
  2. brandId 为必填参数,为空返回 4001(所需参数不足)。
  3. startDate/endDate 格式必须为 yyyy-MM-dd,默认最近 7 天,最大查询跨度 6 个月。
  4. 返回结构为「AI对话问题 → 统计数组」的分组对象;无数据时 data 为空对象 {},解析时做好空值兼容。
  5. rankLevel 取值:top1 / top3 / top10 / top10之外 / 未命中。
  6. top1Count、top3Count、top10Count、top11Count 分别对应排名第1、前3、前10、10 名以后的命中数量;top11Count 不含前 10。
  7. 同一问题下可能包含多个 AI 平台的统计记录。
完整响应类型可表示为 ReturnResult<Map<String, List<PromptDetailStat>>>(ReturnResult 定义见 6.2.5)。
可按以下 TypeScript 类型定义解析响应数据。
本页的 cURL 与 Java 示例来自官方接口文档;Python 与 Node.js 示例为等价转写,未经服务端联调,请以实际返回结果为准。