# 数据里保留了什么

五种响应值结构，以及字段缺失的含义。

规范地址: https://socialtoai.com/zh/docs/projection/

## 小而有类型的值

item：id 加 title 或 text，可选来源链接、作者、published_at、指标、媒体和回复关系。

profile_card：id 和 name，可选简介、认证、粉丝、关注、作品数、所在地和来源链接。

leaderboard：原生排名和标题，可选热度、链接和查询词。

distribution 和 timeseries 是面向专项能力的额外结构。它们出现在 schema 里，不代表当前启用的核心接口会返回它们。

## 缺失即不可得

缺失的指标不等于 0。不要编造来源链接，也不要把热度指数当成浏览量。原始公开措辞和可用的来源标识都会保留；SocialToAI 不会悄悄用 AI 摘要替换正文。

平台特有的信息放在 platform_extra。只有含义和采集时间一致时才比较指标。社交样本不是总体层面的证据。

## 可追溯调用，但日志不留正文

Run 和 Cell 记录只保留运行与计费元数据，上游响应正文不写入运行日志。短期加密重放缓存用于幂等，到期后硬删除。

来源链接和媒体可能失效。fetched_at 记录采集时间，不保证永久副本。

[查看精确的字段 schema →](https://socialtoai.com/envelope.schema.json)