公众号阅读数接口字段说明：read_num、like_num、old_like_num 全解释

接口调通之后，真正影响报表准确性的往往不是请求能不能发出去，而是字段口径有没有对齐。同一篇文章的阅读数、在看数、点赞数、评论数，在不同接口版本和服务商文档中可能使用相同字段名却表达不同含义。本文对应支柱页第一节“这个接口返回什么”，把公众号阅读数接口最常见的返回字段逐一拆开，并说明哪些差异需要在入库前处理。

一、核心计数字段对照

公众号文章阅读数实时接口通常以文章链接为输入，返回的 data 对象中包含以下字段：

其中最容易误判的是 like_num 与 old_like_num。有的接口把 like_num 标为“在看数”、old_like_num标为“点赞数”；另一些接口则反过来使用。接入时必须以目标接口的实际返回示例和字段文档为准，不要跨文档按字段名直接推断。如果你还没有完成请求参数和调用链路确认，建议先回到公众号文章阅读数实时接口完整指南查看第一节与第二节。

二、字段为空、为 0 与字段缺失的区别

字段为空、字段值为 0、字段根本不存在，是三种不同状态：

字段缺失：当前接口版本不返回该字段，例如部分接口不提供 share_num。

字段为 0：接口正常返回，但该文章当前计数为 0，常见于刚发布或互动量极低的文章。

字段为空值：可能是频控状态下返回空数据，也可能是文章链接失效或权限不足。

如果连续多篇文章都返回空值，不应继续加大并发，而应先检查是否已经进入频控状态。这一类排查逻辑在阅读数接口返回异常值的常见原因中有更完整的错误码与排查顺序。

三、入库前的字段清洗建议

在把接口返回写入数据库或表格之前，建议至少做三件事：统一 like_num / old_like_num 的业务命名；为每个字段保留原始返回值和清洗后值两列；记录采集时间戳，避免把不同时间点的计数混在同一张趋势表里。字段清洗完成后，如果需要把数据落到飞书多维表格，可参考公众号数据导出到飞书多维表格中的字段映射方式。

FAQ

like_num 到底是在看数还是点赞数？
不同服务商命名不同，以你实际接入接口的返回示例为准。不要仅凭字段名判断。

read_num 和公众号后台显示不一致，是接口不准吗？
不一定。接口数据与后台“图文分析”可能存在口径差异，频控状态下也可能返回空值而不报错。先排除限流与配额因素，再对比同一时间点的返回结果。

字段缺失需要报错吗？
不需要一律报错。对于接口版本不返回的字段，应在解析层做可选字段处理，而不是让整条记录失败。