
这篇把公众号数据接口返回的字段逐个拆开:字段名、类型、含义、示例值、是否可能为空、以及取值的统计口径。字段口径是排查数据对不上的关键——同一个 read_count,写清它是不是展示值、会不会受限返回空,比只列字段名有用得多。本页与〔公众号更新日志链接〕联动,字段若有调整以更新日志为准。
通用返回结构
所有接口外层结构一致,先看它再往下看具体业务字段:

账号信息字段

文章与互动字段

read_count 为什么会有值、有时为空:是否原创声明(is_original)、账号是否公开阅读数据、文章发布时间过久导致历史互动不再回传,三种情况任一命中都可能让 read_count 为空。把这几条写进你侧的空值判断分支,比事后猜数据丢了要稳。
字段延迟与空值场景
· 互动数据存在采集延迟,多数为 T+1 口径,当天刚发的文章互动数会偏低甚至为 0,别当成掉数据告警。
· 历史久远或已删除的文章,互动字段可能整段返回空。
· 隐私设置或原创限制会让 read_count 可得性变化,与 is_original 强相关。
当前文章无评论,是时候发表评论了