三张搜索结果样式的卡片通过彩色连线连接到一叠页面卡片。

如果账号所有者的记录包含所需的日期和统计数,应优先使用这些记录。清单较短时,可以手动制作电子表格。如果需要获取已知帖子网址的当前公开统计数,Instagram Metrics Scraper 文档所列的输入适用于这一步采集。你仍需自行建立月度清单、核对返回的数据行,并制作报告。

读者的问题是如何导出指定月份的帖子。这个表述有两点需要明确:哪些帖子应纳入文件,以及统计数是在何时观测的。整个操作过程中,都要分清这两点。

1. 明确月份和统计数的观测时间

筛选帖子前,先写明发布月份、年份和时区。发布时间是帖子发布的时间。观测时间是采集其统计数的时间。

以当月开始的第一刻为起点,以下个月开始的第一刻为终点。包含起点,不包含终点。这样可以避免下个月刚开始时发布的帖子同时进入两个月的报告。

确定电子表格需要回答哪个问题:

  1. 所选月份发布的帖子,目前的公开统计数是多少?
  2. 所选月份内发生了多少互动?

本方法回答第一个问题。一篇九月发布的帖子,可以在10月25日采集统计数。九月的发布日期决定是否纳入这篇帖子。十月的观测时间说明这些统计数对应的时间。

如果需求是了解九月内发生的互动,就应在采集当前统计数之前,改为索取相应的证据。当前统计数无法证明九月30日的统计数。不要将十月的观测结果改称为九月月底的数据。

还要明确账号和来源清单。如果报告只涵盖部分帖子,就必须说明。可采用“九月已知帖子的当前观测”作为报告标题。在自己的报告中补上年份和实际观测日期。

2. 建立经核实的帖子清单

帖子清单是你计划纳入的帖子列表。先使用账号所有者已核实的发布登记表或现有导出文件。发布登记表记录发布了哪些帖子,以及各自的发布时间。

检查该来源是否涵盖所需的账号和月份。记录其覆盖范围。覆盖范围是指该来源能为所需帖子清单中的多少内容提供依据。不要因为导出文件行数很多,就认为它包含所有帖子。

如果没有账号所有者提供的清单,就手动整理一份已知公开帖子的网址清单。注明这只是一份有限清单。不要仅凭这些证据承诺涵盖该账号当月的所有帖子。

为每篇候选帖子保存请求采集的网址和发布证据。如有稳定的帖子 ID,就使用该 ID。帖子 ID 用于标识一条内容。URL 就是它的网址。

明确记录以下判断:

2. 建立经核实的帖子清单
发布证据月份归属判断所需操作
已核实的发布时间在当月内纳入将帖子保留在月度清单中
已核实的发布时间在当月之外排除在筛选记录中保留原因
发布时间未知待核查将该候选帖子保留为待定项
不同来源的发布信息相互冲突待核查先核查冲突,再确定月份归属

不要将发现帖子的日期作为发布日期。日期未知,也不能证明帖子不属于该月。

每条内容各占一行。如果两个网址对应同一个已核实的帖子 ID,请在来源记录中保留这两个请求网址,报告中只列一次该帖子。仅凭配文相同,无法证明两行数据对应同一篇帖子。

经核实的 Instagram 发帖清单指南解释了相关的日期范围和覆盖范围限制。本报告只需使用已核实的帖子标识和日期,无需采用其中的内容形式或发帖频率分析。

3. 检查一个已知的公开网址

Actor 是在托管平台上运行的数据采集程序。Instagram Metrics Scraper 的文档说明,它可以直接从已知的公开内容网址采集数据。经核查的公开输入文档支持将 `mode` 设为 `contentUrls`,在 `startUrls` 中提供列表,并通过可选的 `maxItems` 设置总行数上限。

上限是允许的最大数量,并非承诺返回的结果数量。文档所列的输入也支持从个人主页发现内容。本方法使用你已核实的内容清单,不依靠个人主页发现功能来建立完整的月度历史记录。参见公开构建版本的接口约定,核查于2026年10月25日;仅涉及输入和输出文档。

首次检查时,使用所提供的这份小规模输入:

json
{"maxItems":1,"mode":"contentUrls","startUrls":["https://www.instagram.com/reel/DIwcCZgxVZP/"]}
3. 检查一个已知的公开网址

运行前:

  1. 将示例网址替换为清单中一篇已知公开帖子或 Reel 的网址。Reel 是 Instagram 上的视频帖子。
  2. 保持 `mode` 为 `contentUrls`。
  3. 此次只检查一条内容,保持 `maxItems` 为 `1`。
  4. 将返回的帖子标识、日期、统计数和状态与请求采集的帖子逐项核对。

所提供输入的结构符合文档要求。本指南未实际运行该输入。示例网址不能作为你月度报告的证据。

如果已核实的清单较长,请用计划采集的网址替换示例列表。设置足以容纳这些内容的上限。然后将每篇请求采集的帖子与返回数据逐一匹配。提高上限并不能保证每篇帖子都有可用的统计数。

公开的 Instagram Brand Campaign Metrics Task,核查于2026年10月25日;仅确认页面存在,可以作为一个起始页面。Task 是已保存的输入预设。其保存设置未通过已登录账号核查,也未实际运行。使用前请自行检查输入。

4. 保留用于说明各项统计数的字段

保留统计字段,以及解读这些字段所需的证据。文档所列的输出包含以下字段。接口约定列出了这些字段,并不表示每个返回行都会包含所有字段值。

4. 保留用于说明各项统计数的字段
字段保留原因
`inputUrl`将返回行与请求采集的网址匹配
`postId`在有值时,用于标识该条内容
`postUrl`保留返回的公开帖子网址
`publishedAt`记录可获取的发布时间
`likes`存储可获取的公开点赞数
`comments`存储可获取的公开评论数
`postMetricStatus`说明各项公开统计数的状态和精度
`status`记录返回行的状态
`statusReason`保留该状态所注明的原因
`scrapedAt`记录该返回行的采集时间

精度说明统计数有多精确。根据文档,`postMetricStatus` 可以区分精确值、取整值、精度不可获取和精度未知。它也会记录某项指标是已有数据、无法获取,还是未尝试采集。

分别查看点赞和评论的记录。同一行中,一项统计数可能可用,另一项却缺失。因此,仅有返回行,并不能证明两项统计数都可用。

缺失的统计数应留空。只有来源确实提供零值时,才能填零。空单元格表示你没有该值。零表示观测到的统计数为零。

取整值应保留取整标记。不要将取整值相加得出的总数称为精确值。如果只需汇总精确值,请筛选出精度记录明确标为精确的行,并说明这一规则。

在报告中自行添加月份归属判断、发布证据和覆盖范围备注等列。这些核查由你完成。不要将其描述为 Actor 生成的分析。

公开点赞数和评论数是次数,并非去重人数。本方法不提供非公开的触达人数、收藏数、分享数,也不区分付费与自然流量。自然流量是指未归因于付费广告的互动。如果需求涉及仅账号所有者可获取的记录,请索取适当的所有者数据来源,不要用公开统计数填充这些列。

5. 将每篇请求采集的帖子与输出匹配

逐项核对是指将请求采集的清单与返回行进行匹配。以帖子清单为起点,才能让缺失的结果保持可见。

对每篇请求采集的帖子:

  1. 查找匹配的 `inputUrl`、已核实的 `postId` 或返回的 `postUrl`。
  2. 如有返回行,读取 `status` 和 `statusReason`。
  3. 根据已核实的证据确认月份归属判断。
  4. 分别检查点赞数和评论数,包括各自的指标状态。
  5. 保留实际的 `scrapedAt` 值。
  6. 即使没有返回可用的统计数,也要在报告中保留该行。

如果某篇帖子没有返回行,请保留清单中请求采集时的帖子标识。不要编造 Actor 状态或采集时间戳。在自己的报告备注中记录结果缺失。

5. 将每篇请求采集的帖子与输出匹配
情况电子表格中的处理方式
点赞数和评论数都可用保留两个数值及各自的数据质量证据
点赞数可用,评论数缺失保留点赞数,将评论数留空
统计数无法获取保留帖子行及所注明的原因
未返回匹配行保留请求采集的帖子,并标记结果缺失
发布日期仍未知将该候选帖子保留为待核查项
帖子标识重复或结果冲突先确定匹配关系,再将帖子计入统计

上限过小,可能导致部分请求内容未被处理。即使上限足够大,也不能证明所有统计数都可获取。应读取返回的证据,不要将输出行数视为采集成功的证明。

解决冲突时,保留来源数据行。交付文件中,每篇帖子应只有一行统计数,并保留足以解释各项判断的证据。

6. 导出并检查电子表格

将所选列导出为 CSV,或使用平台的电子表格导出功能。CSV 指逗号分隔值文件。它是一种按行和列存储数据的文本文件。

将帖子 ID 作为文本导入。它们用于标识帖子,不是用于计算的数量。保留时间戳的时区。设置日期单元格格式时,不要删除时区。

计算前,检查导入的文件:

  1. 检查首行和末行,确认各列对齐。
  2. 将每个请求采集的帖子标识与交付的数据行逐一核对。
  3. 确认无法获取统计数的帖子仍在文件中。
  4. 检查空白统计单元格是否被改成了零。
  5. 检查 ID 是否仍为文本,时间戳是否仍可读取。
  6. 确认导出后仍保留指标质量信息。

如果将 `postMetricStatus` 放在一个电子表格单元格中不便阅读,可以分别建立点赞质量列和评论质量列。将文档所列的状态和精度复制到对应列中。保留来源值,以便其他读者核查你的汇总。

明确哪些行可以参与每项计算。这些行称为符合条件的行。分母是计算平均值时用来除总数的数值。平均值等于总数除以符合条件的行数。

分别报告点赞数可用的帖子数量和评论数可用的帖子数量。如果这两个数量不同,计算平均值时就需要使用不同的分母。如果没有任何行符合条件,应将结果标为无法获取,而不是零。

7. 计算示例:原创虚构内容

本示例为原创虚构内容。P1、P2 和 P3 是为读者编造的记录,并非 Actor 的输出。

虚构清单包含三篇经核实的九月帖子。统计数的观测日期是10月25日。示例未提供各帖子的发布时间戳、观测的具体时刻、时区或指标精度记录。它用于讲解缺失行的处理和算术计算,并非一份已完全验收、可供实际使用的文件。

7. 计算示例:原创虚构内容
帖子发布月份归属观测日期点赞数评论数统计数状态
P1已核实为九月发布的帖子10月25日10010可用
P2已核实为九月发布的帖子10月25日20020可用
P3已核实为九月发布的帖子10月25日`""``""`无法获取

在交付的 CSV 中保留全部三行。P3 的空单元格表示统计数无法获取,并不表示点赞数或评论数为零。

这些虚构的可用数据行,计算如下:

  1. 点赞数可用的覆盖情况:请求采集的3篇帖子中,有2篇可用。
  2. 观测到的点赞总数:100次点赞 + 200次点赞 = 300次点赞,来自2篇数据可用的帖子。
  3. 观测到的平均点赞数:300次点赞 / 2篇数据可用的帖子 = 每篇数据可用的帖子150次点赞。
  4. 评论数可用的覆盖情况:请求采集的3篇帖子中,有2篇可用。
  5. 观测到的评论总数:10条评论 + 20条评论 = 30条评论,来自2篇数据可用的帖子。
  6. 观测到的平均评论数:30条评论 / 2篇数据可用的帖子 = 每篇数据可用的帖子15条评论。

报告备注可以写为:“10月25日观测到,两行可用数据合计有300次点赞和30条评论。清单共含三篇帖子,其中一行的统计数无法获取。”

不要将300次点赞称为九月的全部点赞。它不包含 P3 的未知值。而且,这是十月对九月所发帖子的观测。不要称其为九月月底总数。

不要用300除以3来报告三篇帖子的平均值。这样计算会将缺失的统计数当作零。有依据的平均值只使用两行可用数据。

8. 验收报告并说明其限制

当每篇纳入的帖子都有已核实的标识、明确的月份归属判断、返回统计数的已知观测时间,以及清楚的统计数状态时,才可验收文件。尚未确定的候选帖子应保持可见,直到能核实其月份归属。

报告备注必须写明来源清单及其覆盖范围。还必须说明统计数的观测时间、每项指标的可用行数,以及计算总数或平均值时采用的规则。不要将部分已知帖子的清单描述为账号的完整历史记录。

如果需求改为统计月初至月底期间的互动,就需要使用不同的证据。已保存的月份边界观测指南说明了这一单独需求。标注发布月份,不能将当前统计数变成历史观测数据。

这是根据已核查的公开文档提出的操作流程。所提供的证据不包含付费运行记录,也不包含实测可靠性结果。它能支持文档所述功能适用于该采集步骤,但不能据此声称 Actor 会替你完成报告或验证报告。

来源和延伸阅读

作者 Chronometrica · 更新日期

返回顶部 ↑