> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 评估小红书合作笔记，阅读和曝光能查多少？缺数据怎么比较？

> 通过 xiaohongshu.pgy.get_note_detail 读取小红书笔记的阅读（data.data.readNum）与曝光（data.data.impNum），与公开详情的 view_count 分列保存，并正确区分缺失、数值 0 与查询失败。

要查别人小红书笔记的阅读和曝光，用已核对的笔记 ID 调用蒲公英 `xiaohongshu.pgy.get_note_detail`。返回 `data.data.readNum` 时记为阅读，返回 `data.data.impNum` 时记为曝光。公开的图文详情 `xiaohongshu.app_v2.get_image_note_detail` 和视频详情 `xiaohongshu.app_v2.get_video_note_detail` 有时返回 `view_count`，报表上按 `view_count` 原名记录。

例如 A 篇取得阅读数，B 篇只取得收藏数。把 B 的阅读列标为待补，先比较两篇都有且口径一致的指标。

## 先决定你要核对哪件事

| 当前任务          | 先怎么做                    | 结果怎么用                    |
| ------------- | ----------------------- | ------------------------ |
| 了解合作作品目前的公开互动 | 看已保存的点赞、收藏、评论、分享及实际采集时间 | 可作内容复盘线索；缺阅读不影响保留已知互动。   |
| 客户明确要求曝光和阅读   | 查已有蒲公英子集或向有权限后台补对应材料    | 核对笔记、定义、观察窗口；不拿公开字段替代曝光。 |
| 比较几个博主的内容表现   | 先检查对象、作品年龄、采集窗口及可比较字段   | 不只挑有数据的作品，也不把缺值作品排到最后。   |
| 想算投放获客或销售回报   | 另找订单成本与归因证据             | 阅读、曝光和互动都不是成交数。          |

## 遇到空值、零或查询失败，分别怎么办？

* 成功响应里字段缺失或null：记“本次未提供”，保留其他已知字段，不推断为0。
* 实际返回数值0：保留0，同时保留来源与时间；数值 0 也不证明没有人接触过内容。
* 整条请求失败：列为“未成功取得”，查失败记录；不能与成功但缺某个字段混在一起。
* 两篇都有数但来源、时间或定义不同：先标“待对齐”，不要直接比较高低或计算同一比率。

例如，**假设**A有阅读而B只有收藏，不能写“A阅读更多”。先比较两篇都有的同口径指标，把B的阅读列为待补；是否值得再查，由这次复盘的问题决定，不为填满表格反复调用收费动作。

## 最后交一张怎样的比较表？

每篇保留笔记ID、指标来源、实际采集时间、真实数值，以及“已返回/本次未提供/查询失败/待对齐”之一的状态说明。上面这几列是人工工作表的建议，下面的导出器不会自动生成所有判断列。名单里的全部作品都保留，写清能比较什么、缺什么、下一步由谁核对。

已保存的数据直接走[投后快照与比较流程](/zh/guides/xiaohongshu-note-metrics)，改表不需要再次查询。客户要求更完整的结案材料时，用[结案取证清单](/zh/faq/xiaohongshu-report-availability)。下面的字段路径供执行和核对请求时使用。

例如同事给你一条公开笔记快照和一份蒲公英报告。表里给公开浏览、报告阅读和报告曝光各开一列。只有公开快照的那一行，阅读与曝光先留空。回答投后阅读之前，核对蒲公英报告对应的笔记和原链接是同一条。

## 去哪里找实际字段？

下面的路径针对 `/v1/social-data/call` 的原始响应，不是 MCP preview 的 `items` 包装。

| 详情 action                                  | 笔记位置                      |
| ------------------------------------------ | ------------------------- |
| `xiaohongshu.app_v2.get_image_note_detail` | `data.data[].note_list[]` |
| `xiaohongshu.app_v2.get_video_note_detail` | `data.data[]`             |

在对应的笔记对象上读 `view_count`。同一对象还可能有 `liked_count`、`collected_count`、`comments_count`、`shared_count`，这四个字段分别代表不同互动，不能替代曝光。`xiaohongshu.app_v2.get_video_note_detail` 的响应可能包含多条笔记，按目标 `id` 匹配，不要直接取第一条。

## 没有 view_count，能补 0 或用点赞推算吗？

不能。字段缺失表示这次结果没有提供该指标；响应真实返回数字 0 时才记为 0。本合同没有给出点赞、收藏与阅读之间的固定换算率，也没有推算曝光的公式。

本页核对的两个 App 详情输出都没有承诺曝光字段。这个限制只针对 `xiaohongshu.app_v2.get_image_note_detail` 和 `xiaohongshu.app_v2.get_video_note_detail`，不代表其他小红书能力都不提供；做投放报告时，另行核对对应的报表动作和适用笔记。

## 做笔记对比表时怎么记录？

保留 `note_id`、详情动作、采集时间、真实互动值，另加一列“`view_count` 是否返回”。缺失值留空，避免表格公式把空值当成零；不同时间取到的计数也不是同一时刻的横截面。查询失败的笔记和成功但缺少字段的笔记分开记录。

[从链接选择详情动作](/zh/faq/xiaohongshu-share-links) · [搜索并筛选笔记](/zh/guides/xiaohongshu-notes-research)

依据：`data:xiaohongshu.app_v2.get_image_note_detail` 与 `data:xiaohongshu.app_v2.get_video_note_detail` 的免费 Inspect 合同。

## 哪个动作已经明确提供曝光字段？

`xiaohongshu.pgy.get_note_detail` 在响应结构中明确 `data.data.impNum` 为曝光、`data.data.readNum` 为阅读。`xiaohongshu.pgy.get_note_detail` 与 App 详情是两个独立请求，字段路径也不同。[结案子集转换器](/zh/guides/xiaohongshu-note-metrics)先验证笔记身份和内部业务结果，再保留缺值和失败覆盖。字段有文档依据，不等于每条笔记都能返回；`null` 也不是零。归因等尚未核实的字段见[结案报告边界](/zh/faq/xiaohongshu-report-availability)。