Skip to main content
POST
查询指定品牌在指定时间范围内 AI 引用来源按网站类型的覆盖分布,返回各网站类型下的平台总数、品牌相关平台数、占比及高频引用平台数量,用于分析品牌在不同来源渠道类型上的覆盖情况。
执行模式:SYNC · 实时请求。 请求发出后服务端同步执行业务,结果直接在当前响应的 data 中返回,不存在异步任务、无需轮询、无需二次查询。

接口速查

请求头

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

请求体

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

返回参数

业务结果位于 data,为按网站类型(websiteType)分组的统计数组。无数据时 data 为空数组 []。
object[]
网站类型统计数组。每个元素为一个网站类型的覆盖统计。
string
网站类型。来源网站类型。
integer
平台总数。该网站类型下的来源平台总数。
number
平台总占比。该网站类型平台占全部平台的百分比(%)。
品牌相关平台数。该网站类型下提及品牌的平台数量。
品牌相关平台占比。品牌相关平台占全部平台的百分比(%)。
number
品牌占比差值。品牌相关平台占比 − 平台总占比(%),可能为负数。
integer
高频平台数。该网站类型下引用次数大于 10 的平台数量。
高频品牌相关平台数。品牌相关且引用次数大于 10 的平台数量。
integer
竞品相关平台数。该网站类型下提及过竞品的平台数量。

接入注意事项

  1. apiCode 必须固定为 source.website.type.platform。
  2. brandId 为必填参数,为空返回 4001(所需参数不足)。
  3. startDate/endDate 格式必须为 yyyy-MM-dd,默认最近 7 天,最大查询跨度 6 个月,endDate 不能晚于今天,开始日期晚于结束日期将直接报错。
  4. 返回结构为网站类型统计数组;无数据时 data 为空数组 []。
  5. 各占比字段单位为百分比(%);percentageDifference = 品牌相关平台占比 − 平台总占比,可能为负数。
  6. highTotalPlatformCount 为该网站类型下引用次数大于 10 的平台数量。
完整响应类型可表示为 ReturnResult<List<WebsiteTypePlatformStatistics>>(ReturnResult 定义见 6.2.5)。
可按以上 TypeScript 类型定义解析响应数据。
本页的 cURL 与 Java 示例来自官方接口文档;Python 与 Node.js 示例为等价转写,未经服务端联调,请以实际返回结果为准。