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

接口速查

请求头

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

请求体

string
required
固定为 source.industry.website.type。
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
平台数量占比。该网站类型平台数占全部平台数的百分比(%)。
integer
URL 数量。去重后的平台 URL 数。
number
URL 数量占比。该网站类型 URL 数占全部 URL 数的百分比(%)。
integer
总引用次数。该网站类型下的总引用次数。

接入注意事项

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