小红书合作投完了,怎么回收这批笔记的数据并向客户复盘?
给客户复盘一批已发布的小红书合作笔记时,先固定约定的笔记名单,在约定时间用 data:xiaohongshu.app_v2.get_image_note_detail 或 data:xiaohongshu.app_v2.get_video_note_detail 观察同一批笔记,再交一张能回到来源的变化表。变化表回答三件事:哪些内容还在积累互动、哪些需要补查、哪些数据还不能支持结论。临时搜来的热门笔记不能替代实际合作名单。
本流程回收公开点赞、收藏、评论、分享,保存每轮快照并比较两轮净变化。阅读和曝光有独立口径,最后的蒲公英小节只导出已有文档说明的蒲公英字段;成交、获客、归因涨粉和完整结案仍需对应的订单和后台证据。
先跟客户对齐:这轮要回答哪个问题?
只有几篇作品时,一次人工记录也能完成;需要多篇、多轮回收并保留来源时,再用本页的脚本。取数前先写清名单、观察窗口、所需指标和允许花费,避免取完一大包数据才发现客户要的是另一种报表。
拿到变化表,先看缺口,再看增量
下表是虚构读表示例,只演示判断方法,不是采集结果:
比较不同作品时,从每篇各自的发布时间起算,优先对齐发布后第 1 天和第 7 天。比如甲笔记是第 7 天,乙笔记已经发布 30 天,就把乙笔记的本轮数字放进长周期观察。复盘表里每项增量都附前后两次查询时间。
怎么安排一轮回收?
- 固定合作名单:保存笔记 ID、图文/视频类型、合作批次与原始链接;不要为取得已有 ID 再做一次搜索。比较脚本的
roster.json只放约定的 ID 字符串,作者和批次等信息另外留在合作工作表。 - 约定观察轮次:例如发布后 1、7、30 天。计划时间和实际查询时间分开记录;本页不创建定时采集任务,导出时间也不是采集时间。
- 按正确类型保存原响应:图文笔记用图文详情动作,视频笔记用视频详情动作。类型未知时先核对,不轮流试两个收费动作;每篇每轮单独保存文件。
- 先核对名单覆盖:成功项进入本轮导出清单,失败或未采集项另记日志。导出脚本遇到失败输入会停止,不悄悄补零。需要重查时先确认预算,只补已批准的失败项。
- 比较同一名单的两轮:先确认 baseline 确实是较早的一轮,再离线生成变化表。先解释缺口,再解释可以比较的数字,最后列出要问博主或客户的事项。
交给客户的是快照 CSV、两轮变化 CSV 和一份简短说明:本轮计划多少篇、实际覆盖多少篇、缺哪几篇及原因、哪些变化可比较、哪些结论还缺证据。原始响应和清单作为内部核对依据留存;工作表里的内容评价与后续建议由人工填写,脚本不给博主打分。
先估成本,已有数据先复用
每轮预算为“图文条数×图文详情当前单价+视频条数×视频详情当前单价”,再按批准轮次合计;执行前分别免费 Inspect。另取蒲公英字段、评论或模型分析另算。失败和业务错误也可能计费,竞品“失败免费”的承诺不适用。
改表、重新比较已保存的文件不需要再次取数。只在确实需要新观察时才发起新请求;本页的 Python 脚本都在本地处理文件,不会自动购买数据或上传客户报表。
先按第 1–6 步完成公开互动回收;确需曝光或阅读时,再用最后的蒲公英小节。两部分的动作、字段和费用分开,不混用。
1. 根据笔记类型核对合同
图文笔记用 data:xiaohongshu.app_v2.get_image_note_detail,视频笔记用 data:xiaohongshu.app_v2.get_video_note_detail。只 Inspect 需要的动作,确认当前价格与业务错误说明。
不要为试探笔记类型自动连续调用两个动作;类型未知时先核对笔记来源。错误 ID 或链接解析失败可能返回正常的业务错误响应,并且计费。
2. 获取一篇并保存原始文件
视频笔记改用视频详情动作,输入同样使用已确认的 ID。不同笔记或不同采集时间用不同文件名,不覆盖历史响应。记录每次请求的时间;导出时刻不是平台查询时刻。
3. 建立本地输入清单
创建自己的 targets.json,用实际 ID、响应文件名和当次查询时间替换示例中的占位值。targets.json 是本地导出清单,不是 BeatAPI 接口参数。
图文笔记在 data.data[].note_list[],视频笔记在 data.data[]。同一响应可能带有其他笔记,所以必须按目标 ID 匹配,不能直接取第一条记录。
4. 离线导出 CSV
在清单和响应所在的目录运行下面的导出脚本。遇到失败、未知动作或找不到目标时,脚本停止运行,不生成一行全零的假成功。缺失指标写空,真实的 0 保留;所有记录校验完后才替换 CSV。
5. 比较快照,而不是伪造归因
保留每轮的 CSV 与原始 JSON,用 note_id 对齐同一篇笔记。总量相减只是两次观察之间的净变化,不能证明变化由投放带来,也不保证期间没有计数修订。没有 view_count 不补零,没有曝光字段就不算曝光成本。
在表格软件里导入 note_id 时选文本类型,避免长标识被改写。代码处理了公式前缀、换行和引号,但没有统一各动作的全部可选字段,也没有归一化指标的时间口径。
把投后回收做成可复核的变化表
手上是一批合作笔记时,不要每轮重新搜索来替换原名单。先固定笔记 ID、类型和约定回收时间;按同一名单回收首次与后续快照,保留每次的原始文件。某篇请求失败只补查那一篇,不重跑已成功的名单。笔记删除、不可见或本轮遗漏,都记为缺失,不按互动归零处理。
把两轮导出的文件分别复制为 baseline.csv、followup.csv,在同一目录运行下面的代码。交付文件 note-metric-changes.csv 每篇一行,包含两次采集时间、来源文件、各指标的前值/后值/净变化。两轮都出现才标为 matched;只出现一次标为 new_only 或 baseline_only,不会被悄悄丢弃。任何一侧缺少某个指标,就不计算该指标的差值。负差值照实保留,表示计数下调,不是代码错误。
比较前另建 roster.json,内容为约定的笔记 ID 字符串数组,例如 ["<note_id_1>","<note_id_2>"]。roster.json 独立于两轮成功结果,不能从 CSV 反推,否则两轮都漏采的笔记会消失。输出 missing_both 表示两轮都没有该笔记;CSV 出现名单外的 ID 时,脚本停止检查。
本流程完成的是已保存响应的固定名单复核,不是自动批量采集。第一段导出脚本仍对失败响应立即停止,避免把错误计为有效记录。先把失败请求单独记录在 failures.json 里(笔记 ID、轮次、请求时间、错误、原始文件);只把已验证成功的响应放进该轮的 targets.json,再导出成功快照。结果缺失本身分辨不出删除、请求失败还是漏采,必须对照 failures.json。整轮没有成功结果时,先处理失败再比较,不要用旧 CSV 冒充新一轮。
验收时先筛出非 matched 行检查漏采,再按 likes_delta、saves_delta、comments_delta 看这批笔记公开互动的变化。不同笔记的采集时间不完全一致,差值表不能包装成平台统一时间窗的归因报告。脚本按文件角色比较,不自动推断先后;开始前确认 baseline 是较早的一次。
可交给 AI 的明确任务
按我提供的固定笔记名单与类型,核对相应详情接口,保存本轮原始响应和真实查询时间;将首次与本轮快照按笔记 ID 对齐,导出前值、后值、净变化及缺失名单。不要重新搜索替换样本,不把缺失指标填零,不补造曝光或归因数据。先报告预计调用次数与当前价格,取得本次采集授权后再执行;已保存文件的对比只在本地运行。
6. 费用与验收
N 篇笔记各查一次是 N 次详情调用;用已有原始文件导出 CSV 不增加平台调用。每次刷新都是新查询,金额以当前 Inspect 为准,各动作的错误计费边界分别核对。
依据:离线图文/视频样例,检查了两种路径、精确 ID 匹配、空值和零、公式前缀、失败时不覆盖旧 CSV;没有付费采集或实际投放效果测试。完整报告中未验证的字段见结案报告边界。
把已明确的蒲公英曝光、阅读字段做成结案表
结案名单需要曝光与阅读时,已核对的蒲公英详情说明列出了具体字段。BeatAPI 渲染器保留两层信封,路径为 data.data.noteId 以及同层的 impNum(曝光)、readNum(阅读)、likeNum、favNum、cmtNum。不要套用竞品的归一化字段;归因涨粉、分享、品牌和组件点击字段还没有被蒲公英说明证实。依据:官方说明、网关渲染器和合成样本测试,没有新增收费蒲公英实测。
先冻结一轮的笔记名单。2026-11-16 免费 Inspect 核价为每次 $0.06;30 篇就是 30 次,按该价格为 $1.80,不含发现与重查,执行前重新核价。只查名单内的笔记,失败也留档,不因 null 自动重买。请求体如下,其中的 ID 仅为示意,不能直接执行:
每份实际完整响应对应一条清单记录,时间填真实采集时间,每轮使用新目录。转换脚本不联网:
把下面的脚本保存为 pgy_report.py。pgy_report.py 要求已核实的 24 位笔记 ID,核对返回的笔记身份和显式的内部业务成功,失败的名单行不丢弃。计数接受非负整数和纯数字字符串,缺值留空;无法解释的格式化数值会报错供核查,不擅自转换。
运行 python3 pgy_report.py pgy-manifest.json pgy-round-1。先看 coverage.json 再排序 CSV:网关失败、内部业务失败、空数据、部分指标、可用指标分别计数;原始响应保留错误细节和字段的原始表示,与清单一起保存。
read_to_impression_ratio 是脚本计算的阅读/曝光,不是平台直接给出的转化率或去重读者指标。缺输入时留空;曝光为零时留空并记 zero_denominator;阅读超过曝光时保留计算结果并标 review_gt_one,不强行压到 100%。对比前核对采集时间与指标口径。蒲公英字段表不冒充完整归因报表。目标目录必须不存在;写入中断时先检查半成品,再换新目录名。
清单记录实际 HTTP 状态和 action/params。HTTP 失败从 error.code 与 error.request_id 读取,不构造假的顶层 failed 响应;curl 非零退出时也要保留响应正文。没有 JSON 响应的网络失败另写采集日志,转换脚本不能替这类失败编造 HTTP 结果。
获准采集真实笔记时,把实际请求体保存为 pgy-request.json,再用新的文件名执行一次下面的命令。把 pgy-http-status.txt 里的真实状态抄进该笔记的清单记录,不覆盖已有轮次。这一步是另行授权的收费采集,不属于本地转换。

