为什么必须读本页
同一个词在不同系统里可能有不同分母或时间边界。下面每一条都是 /v1 的稳定产品口径；对账时先复现口径，再判断是不是数据问题。
提及 (mention)
按回答二值计。一条回答里提到品牌 1 次或 10 次都记 1。判定为大小写不敏感的子串匹配；匹配集是品牌名加 merchants.brand_aliases 中的别名。
可见度提及率
提及数 ÷ status='ok' 的运行数。分母不排除空正文行，所以抓取成功但正文为空的行会稀释提及率；失败、跳过和运行中的行不进分母。
SoV 扫描基数
与可见度分母不同：CompetitorSovStats.ScannedRuns 只计 status='ok' 且正文非空的运行。同一窗口下 SoV 基数小于或等于可见度分母；对不齐是设计如此。
引用 (citation)
按出现次数计。同一 URL 在一条回答里出现两次，记录为两条引用和两个 position。position 是该回答 citations 数组里的 1-based 下标。
SoV (声量份额)
某品牌提及数 ÷ 窗口内所有被追踪品牌（自家加竞品）的提及数之和 × 100。分母只含已追踪品牌，不含未配置的第三方品牌。
排名 (rank)
按 SoV 降序，1-based。窗口内所有被追踪品牌都无提及时，rank 字段不返回；自家无提及但竞品有提及时，自家返回末位名次，不是 null。
日期分桶
/v1 不接收内部界面使用的 CalendarDays 与 dayShifts，因此使用 UTC 锚定的固定 24 小时桶。桌面界面可按客户端本地日历日分桶；跨日或夏令时边界与 API 出现差异是已知且刻意的。
时间窗口
所有端点统一使用半开区间 [since, until)，时间单位是 Unix 毫秒。until 对应的瞬间不计入当前窗口。显式 since=0 是有效时间戳，表示 Unix epoch；只有省略参数才可能启用端点默认窗口。
软删行
可见度时间序列与 SoV 等趋势聚合包含软删行，与内部统计口径一致；明细类端点排除软删行。可见度矩阵按最新明细读模型处理，也排除软删行并返回 retention meta。/v1 不暴露内部面的 batchId 或 IncludeDeleted 例外。
保留期
明细保留 90 天。对于早于 meta.retention_start_ms 的窗口，聚合可能有数而明细为空。
API 调用计数
2xx 与 4xx 计数；ETag 条件命中的 304、429 与 5xx 不计。无效 key 的 401 无法归属租户，只进入 IP 限流，不进入 api_calls_month。窗口是自然月，锚点由 /quota-usage 的 monthStartMs 发布。
分页与调用次数
拉 100 页就是 100 次调用。建议在内存与响应体可接受的前提下使用较大的 limit，最大 1000。
情感 (sentiment)
DeepSeek 判定回答对自家品牌的立场，范围 [-1, 1]。null 表示未判定，不等于中性 0。