> 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.

# Instagram互动报表出现空值，怎样读对点赞、评论和播放数？

> 按实际详情动作读取指标，区分0和未提供，并用同一作品的两次观察解释计数变化。

Instagram 互动数按产生响应的详情动作去对应路径读取，未提供的值留空，不写成 0。先看已保存响应的 `action`：`instagram.v2.fetch_post_info` 的计数在 `data.data.metrics`；`instagram.v3.get_post_info` 先在 `data.items[]` 里找短码匹配的条目，再读该条目的计数。两次观察都返回同一项指标时，才计算这项指标的变化。

例如一条 Reel 的点赞从 120 变成 135，报表写净增 15，并标明两次采集时间。没有返回的播放数留空。

## 点赞、评论、播放分别从哪里读？

| 详情动作                                | 先定位帖子                        | 指标位置                                                              |
| ----------------------------------- | ---------------------------- | ----------------------------------------------------------------- |
| `data:instagram.v2.fetch_post_info` | `data.data`，核对 `code`        | `metrics.like_count`、`metrics.comment_count`、`metrics.play_count` |
| `data:instagram.v3.get_post_info`   | 在 `data.items[]` 精确匹配 `code` | 匹配项的 `like_count`、`comment_count`、`play_count`                    |

先核对 shortcode 和账号，确认两次观察比较的是同一条帖子。需要直接整理时，[快照指南](/zh/guides/instagram-post-snapshot)已经分别解析 `instagram.v2.fetch_post_info` 和 `instagram.v3.get_post_info` 的响应。

## 报表里的空值和0怎么填？

明确返回 0 就记 0，字段未提供就留空并标为不可用。图片帖没有播放数时，仍可以比较点赞和评论；不能拿第二次的播放数减去人为补出的 0。播放次数也不等于独立触达人数。

## 怎样写前后变化，读者才看得懂？

同时列出帖子、两次采集时间、前值、后值和净变化。**计算示例**：点赞 120 变 135，净变化是 +15；120 变 118，净变化是 −2。负值保留在报表里，便于回看。

需要增长率时，只有基线可得且大于 0 才计算 `(后值−前值)/前值×100`。基线为 0 或缺失时，报告差值和基线状态，不给百分比。互动率要另外写明分母和对应时点，增长率公式不能代替互动率。

## 发给同事前，保留哪些材料？

保留两次原始响应、CSV 和比较 JSON，并附实际观察时间。快照指南的比较器接收同一帖子、同一详情动作的两次有效快照，并回查源文件与计数；手改过的 CSV 与原件不一致时，先对照原始响应排查。

报告可以写：“在这两个观察时点之间，作品的已报告点赞净增 15，评论数未提供，因此未计算评论变化。”数字换成本次的实际记录。变化表回答发生了什么变化；要解释活动为什么有效，还需要活动与内容证据。

已保存响应的解析与比较在本地完成。新查询按[价格页](https://beatapi.io/zh/pricing)的当前价格计费。

[保存与比较快照](/zh/guides/instagram-post-snapshot) · [帖子链接与标识](/zh/faq/instagram-url-and-id)