数据投影
数据里保留了什么
五种响应值结构,以及字段缺失的含义。
小而有类型的值
item:id 加 title 或 text,可选来源链接、作者、published_at、指标、媒体和回复关系。
profile_card:id 和 name,可选简介、认证、粉丝、关注、作品数、所在地和来源链接。
leaderboard:原生排名和标题,可选热度、链接和查询词。
distribution 和 timeseries 是面向专项能力的额外结构。它们出现在 schema 里,不代表当前启用的核心接口会返回它们。
缺失即不可得
缺失的指标不等于 0。不要编造来源链接,也不要把热度指数当成浏览量。原始公开措辞和可用的来源标识都会保留;SocialToAI 不会悄悄用 AI 摘要替换正文。
平台特有的信息放在 platform_extra。只有含义和采集时间一致时才比较指标。社交样本不是总体层面的证据。
可追溯调用,但日志不留正文
Run 和 Cell 记录只保留运行与计费元数据,上游响应正文不写入运行日志。短期加密重放缓存用于幂等,到期后硬删除。
来源链接和媒体可能失效。fetched_at 记录采集时间,不保证永久副本。