这批博主谁给竞品做过推广?怎么整理成联系前的核查名单?
要查候选名单里谁给竞品做过推广,用 xiaohongshu.pgy.get_blogger_notes 逐个查博主的合作案例,传入博主的 user_id 并设置 note_type:3。核对案例里返回的品牌名称,再列出匹配的博主、笔记和出处。邀约前打开入选笔记,判断做过的内容是否接近你的产品,并把档期和排他约定写进待确认清单。
只有一个竞品品牌名时,先用公开搜索找候选博主,再逐个核对合作案例。交付时注明查了哪些博主和哪些案例页。
最后拿到什么,怎么用来安排邀约?
最后得到两张表:一张列出样本中命中目标品牌的博主,一张列出对应笔记,供你回到博主主页核对原内容。表里给的是笔记 ID,不会自动生成可打开的分享链接。品牌未知和相互矛盾的记录单独保留,不挤进已确认名单。
下表用占位示例说明不同结果的解读方式(并非真实博主记录):
“合作过竞品”既可能意味着相关经验,也可能意味着需要确认排他条件,不是自动淘汰或优先合作的评分。表里没有合同金额、实际投放成本或转化效果;不要把当前报价当成上一单真实付款。
只有竞品品牌名,还没有候选博主怎么办?
先按笔记搜索指南用品牌名和已确认的别名搜索相关笔记,结合实际产品和内容筛掉同名干扰,把相关作者列为待核候选。搜索只能说明这些作者提到过品牌;要补充合作证据,再用本页流程核查每位作者的博主案例。
“先找相关作者,再查博主案例”这条路线适合建立研究起点。如果任务是统计搜索样本里报备商单的比例,或逐篇确认某篇笔记报备的品牌,目前还缺搜索合作标记和单篇报备品牌的固定返回,需要另外补核资料,不能用品牌关键词的命中率代替。
1. 先把这轮要查的人和品牌范围定下来
从已有候选库取博主的稳定 ID,不用昵称拼 ID。如果还没有名单,先走按内容和预算建立候选库,再回到这里核查选中的人。
保留原候选表里的所有人,手动增加“本轮状态、代表案例、内容适配、待问事项、是否联系”五列。这五列是你的邀约底稿,不是脚本生成的评分;后面的命中名单只用来补充原候选表,不能替换它。空页、未命中和查询失败的人也留在原表,分别标注“本轮未见匹配”或“待核实”。
为这轮写清三件事:要核查哪些博主、哪个竞品品牌、最多愿意看多少页。品牌的中文名、英文名和子品牌可能分别出现;只把你人工确认属于同一目标的返回标签合在一起,不能靠相似名字自动认定。
第一轮每人看一页,再给确实值得继续了解的人补页。示例请求按阅读排序,先看阅读较高的合作案例;如果目标是近期合作,改按最新排序,并在整轮保持一致。无论哪种排序,第一页都不是博主的全部历史。
2. 看合作案例,不先把所有资料都买一遍
用合作案例筛选,一次取一位已知博主的一页。先不要给每个人追加粉丝画像、详细报价或每篇结案数据:决定进一步接洽某位博主之后,再按具体问题补这些资料。
当前案例查询单价见价格页。20位候选、每人一页就是20次案例页查询;按需要再增加找人、详情、追加页或模型分析。已有案例原件直接复用,先看首批能否回答这轮邀约问题。
下方技术步骤提供完整请求和两个本地脚本。每次实际查询都保存响应和请求记录:博主 ID、筛选条件、页码和采集时间。请求记录里的博主 ID 只说明这次查询的是谁,平台并没有另外证明作者归属,所以复核时仍要打开对应笔记看作者。
3. 把品牌线索整理出来,再看具体内容
先对每一页运行 pgy_cases.py,查看案例中的品牌名;再把确认属于目标品牌的精确标签填入品牌清单,用 brand_roster.py 合并多位博主、多页的记录。同一笔记重复出现只计一次,两个品牌名冲突时,脚本不会替你选一个。
拿到结果后按这个顺序看:
- 先看有多少真正命中。
coverage.json分开列出命中、品牌未知、品牌冲突和其他品牌。零命中只表示这轮样本没有匹配,不能扩大成“品牌没投过”或“博主从没合作”。 - 再核对具体笔记。 在
brand-evidence.csv找到笔记 ID,再从单页cases.csv取标题和日期;到对应博主主页找到该内容,核对笔记 ID、作者和品牌。无法定位就填“待核实”,不自行拼一个缺访问令牌的链接,也不为找内容自动加买详情。品牌名是来源里的标签,不是合同或付款凭证。 - 最后整理要联系的人。
creator-roster.csv只列出命中的博主和对应笔记,不含空页或失败的候选。回到已有候选库,按同一个博主 ID 补上昵称和你的选人理由,再人工安排邀约顺序。不要按昵称连接不同账号。
原始数据和两张表的 JSON 版本都会保留,出现争议时可以回看。表格软件导入时把 ID 设为文本,避免长编号被改写。每条记录都要人工复核;脚本不联系博主,也不作合作承诺。
4. 联系之前,还要问清什么?
核对一两篇代表内容是否真的接近本次产品,而不只看“合作次数”。内容合适后,再确认档期、是否接受这类产品、是否有竞品排他、交付形式及当前报价。如果要比较案例效果,去读取已确认笔记的曝光和阅读,不要用品牌标签推算效果。
查不到品牌、数据冲突或某页报错时,在原候选表的“本轮状态”里填“待核实”,并写明卡在哪一步。失败页会让脚本停止,所以有没有输出行不能用来判断这个人是否值得合作;没有记录也不是负面结论。新增查询要针对具体待解的问题,不要对所有人把所有接口轮一遍。
技术步骤:采集一页合作案例
data:xiaohongshu.pgy.get_blogger_notes 用 note_type: 3 选择合作笔记。下面的示例用 order_type: 2 按阅读排序,用 advertise_switch: 1 保留全部流量口径。把 user_id 换成候选库里已核实的 ID,每位博主使用不同的文件名。
下面每个参数回答不同的问题,不要混用:
note_type 的 1/2/4 分别是图文/视频/全部,与 3 是单选关系,一个字段不能同时表示“仅合作视频”。content_tag、feature_tag 的取值参考实际博主详情里的标签,不要把示例当完整字典。翻页时条件和排序不变,遇到空页、重复整页、错误或预算上限就停止;不要自动切到输出结构不同的 V2 动作。
为每份实际响应保存一个 case-request.json。下面是格式示例,时间、ID 和页码要换成真实调用的值:
技术步骤:先整理单页,再合并品牌名单
把下面的脚本保存为 pgy_cases.py。输入是完整的 BeatAPI 响应,不是截断预览。响应中的合作案例列表位于 data.data.list[],笔记键为 noteId;pgy_cases.py 在本地按该结构校验已保存响应。
先看单页 cases.csv 与 review.json,确认实际品牌标签。readNum 是阅读,thirdReadUserNum 的说明是站外阅读人数,不能改叫保证进店人数。isAdvertise/isVideo 按原值和类型保留,不把任意字符串当布尔;矛盾标记必须人工查看。单页相同 ID 的证据冲突会在输出前停止。total 是该案例筛选下的匹配数,与找博主列表的分页上限不是同一口径。
再建立 brand-input.json:填写人工确认的精确品牌标签,并列出每份响应/请求记录。把下面的占位品牌名替换为人工确认的精确标签,文件路径相对于 brand-input.json:
保存下面的 brand_roster.py,与单页脚本放在一起:
brand_roster.py 只在本地运行,不产生收费请求。脚本拒绝混合条件和跨博主的同笔记归属冲突,保留原件、时间、请求 ID 和来源编号。同一笔记的不同品牌记录隔离为冲突;缺失品牌记为未知;别名只用你明确填写的标签,不自动归并。CSV 防公式注入,JSON 保留原值,已有输出目录不会被覆盖。原件哈希只关联本地资料,不认证平台来源。
把生成的文件当作待复核的工作底稿,不当作已证实的合同清单。关键不是把每一格填满,而是把准备联系的人、相关案例和还要问的问题对应起来。

