如何筛选小红书合作博主,并核对受众和近期案例?
要做小红书合作名单,先用 data:xiaohongshu.pgy.get_blogger_list 按内容、地区和报价筛一页蒲公英博主列表。再用候选返回的 userId,按第 4、5 步给入选博主补画像与合作案例。最后交一张名单,每行说明博主为什么入选、证据在哪、还有什么要确认。
例如你要在上海做线下咖啡机体验,先看每位博主是否能到场、是否有图文教程经验、报价是否在预算内。内容合适但粉丝地区还没核对的候选,先标「待补画像」。两位报价相近时,再看谁的历史案例更接近真实使用场景。档期、最终报价和使用权到蒲公英的合作流程确认。 蒲公英官方站
合作名单的每一列从哪里取?
预算里分别记录数据请求、博主合作付款和推广费用。本页的请求次数只用于估算取数费用。
1. 明确条件和调用范围
先定内容类型、地区、粉丝范围和报价范围。博主所在地不等于粉丝所在地,内容分类也不等于近期合作行业。第一次可以只取一页候选,再选一位博主查看详情、画像和一页案例;首轮范围用来控制花费,不是质量阈值。
2. 免费 Inspect,再取一页候选
先在 Inspect 结果里确认嵌套筛选与价格,批准后再执行收费请求。下面的请求按笔记关键词检索“咖啡”相关博主,粉丝区间只是示例:
search_type 1 按笔记关键词找博主,不是昵称精确匹配;按昵称查询时改成 0。要叠加地区和报价条件,见筛选条件;已有种子账号时,可以从相似发现开始。
3. 检查原始结果后保存候选
公开目录没有发布完整输出 schema,但响应结构已明确列表路径为 data.data.kols、博主键为 userId,第 7 节提供按固定路径导出已存页面的脚本。用真实 userId 去重,保留输入条件、排序、页次、采集时间和 request_id。只有昵称的记录不凭空拼 ID,缺失指标留空。
继续分页时,保持条件与排序不变,page_num 从 1 递增,page_size 不超过 20。最多允许 250 页、可见前 5000 条,不代表整个达人库。遇到重复整页、错误或达到批准页数就停止。
4. 只核对选中账号的详情和受众
扩展前,分别免费 Inspect data:xiaohongshu.pgy.get_blogger_detail 与 data:xiaohongshu.pgy.get_blogger_fans_profile。确认价格后,用候选结果里实际核对过的 user_id 调用两个动作:
详情和画像请求与列表导出分开进行。受众 FAQ 列出了画像已明确的分布字段,不保证每位创作者都返回每个字段。实际响应带有估计值时,保留估计含义;受众画像不等于真假粉鉴定。
5. 检查合作案例,而不只看账号总数
免费 Inspect data:xiaohongshu.pgy.get_blogger_notes,确认后取一页合作笔记:
note_type 3 表示合作笔记,默认 advertise_switch 1 含全部流量。要评估自然内容表现时,另外指定自然流量口径,不把商单与推广流量混为一谈。保留原始案例,人工检查内容相关性;未取得的来源或指标不让 AI 补写。
如果同一项目还要在抖音找人,另外走星图和抖音合作资料。总表用「平台 + 达人 ID」定位候选,分别保存两个平台的图文或视频报价、受众口径和作品来源。同一个人跨平台出现时可以关联,合作条件仍按平台分别核对。
6. 交付名单并记录成本
本地表建议列:user_id、入选条件、实际返回的资料、案例来源、受众证据、缺失/待确认事项。谈判前必须再次确认报价,不让一个预估分数掩盖缺失证据。
一页候选加一位博主的详情、画像和一页案例,共 4 次平台调用;按价格页的现价逐项相加。对 M 位博主都执行后三步是 1 + 3M 次,后续翻页与模型分析另计。候选页每页 20 人只是一次调用,不等于核对了 20 人的全部信息。
第 7 节的导出脚本自动导出已核对路径的字段,画像扩展与内容相关性仍需分别人工审核。错误页不能当空候选;失败后先检查本地已保存的响应,避免无目的重查。
7. 已保存候选页如何直接导出达人库?
BeatAPI 直接保留蒲公英响应信封,博主列表位于 data.data.kols[],按 userId 去重。pgy_candidates.py 使用已明确的 name、redId、location、粉丝数、图文/视频报价、阅读/互动中位数和图文预估 CPM,不套用第三方归一化字段。该请求合同不需要 view=full。数值原样保留,不改写成保效果承诺或最终商谈价。
以上面的咖啡筛选为例,筛选和排序保持不变,pgy_candidates.py 最多接受五页。单价见价格页。五页最多返回 100 个位置,扣除过滤和重复后不保证 100 位博主。遇到失败、重复或空页先停下,核查已保存的结果;空页不证明整个目录没有候选。total 的文档定义是翻页上限,不是命中数。
为实际保存的完整响应建立清单,只添加确实请求过的连续页,填真实 HTTP 状态和带时区的采集时间。下面的条目只示范格式,不是实测记录:
把下面的脚本保存为 pgy_candidates.py。pgy_candidates.py 不联网,限制本轮最多五页且筛选保持一致,保留真实的网关 error 信封和蒲公英内部失败,按 userId 去重,并另存每次原始观察,报价变化不会被悄悄丢弃。依据:xiaohongshu.pgy.get_blogger_list 的公开响应字段结构。
运行 python3 pgy_candidates.py creator-manifest.json creator-library-1。先看 coverage.json:逐页状态、哈希、请求 ID、返回次数和唯一博主数都在 coverage.json 里。失败页不当作成功的空页;没有 JSON 的网络失败另写采集日志,不伪造结果行。pgy_candidates.py 拒绝覆盖已有输出目录。
再打开 creators.csv,核对内容相关性后填写 review_decision 和 fit_evidence。字段保持返回时的表示:嵌套值保存成 JSON 文本,缺值留空。CSV 以首次观察为基准,observation_count 与 observations.jsonl 保留重复和后续变化;没验证单位和格式前,不把文本报价当数字排序。只有真正入围的 ID 才再查画像和案例;导出不联系创作者,也不承诺合作预算。多个关键词分别保存证据包,保留每次搜索条件后再按 userId 合并。
怎样一起看报价、受众和近期案例?
为上海咖啡活动找图文合作时,先选确实写过到店体验的博主,再看候选表中的 picturePrice。考虑视频方案时另列 videoPrice。每行记录博主 ID、合作形式、报价原值、已确认的币种和单位、取得时间和案例。只比较口径相同的报价,资料不齐时标出要补的条件。
对入围博主按第 4 节补画像。围绕活动需要,记录实际返回的地区或兴趣分组、原值和可确认的数据日期。城市分布和兴趣分布各自描述不同的人群。需要判断“上海且对咖啡感兴趣”的联合人群时,等拿到对应资料再判断。读法见受众画像问答。
例如一位博主有到店案例、可比较的图文价和相关地域证据,可以保留。另一位博主作品也合适,但只有视频价格,就在图文方案里写“待补图文价”。把入选理由、来源和要补的条件一起交给团队。
8. 只给人工入围的 ID 补数据表现证据
审阅候选 CSV 后,在入围行的 review_decision 填精确值 shortlist,其他行不动。join_pgy_performance.py 读取 shortlist 选择,但不请求接口,也不修改原名单。已获准查表现时,调用 xiaohongshu.pgy.get_blogger_notes_rate,显式传 business/date_type/note_type/advertise_switch;同一对比组的全部候选使用同一口径。
数据表现原文已明确 data.data.impMedian、readMedian、interactionMedian、impMedianBeyondRate。原值保留;同行百分位不是受众占比;原文没有命名的完播率、互动率字段,导出脚本不虚构。每位入围博主多一次表现请求,单价见价格页。
把每份真实请求与响应的对应关系存进 performance-manifest.json,填真实 HTTP 状态和时间。下面的条目只示范格式,不是实测证据:
把下面的脚本保存为 join_pgy_performance.py。脚本生成以 userId 为键的配套表现表,入围但还没查询、或已保存请求失败的博主都保留;脚本拒绝未入围的 ID 和混合口径,缺指标留空,并记录原始证据的哈希。每位博主绑定到实际请求清单,脚本不假设未声明的返回身份字段。
运行 python3 join_pgy_performance.py creator-library-1/creators.csv performance-manifest.json creator-performance-review-1。把原名单、请求清单和原响应与 performance.csv、evidence.json 一起留存。空清单会把全部入围博主标为 not_requested,not_requested 不代表“没有表现”;缺结果的博主仍在审核分母里。
示例口径是合作内容、近 30 天、图文 + 视频、仅自然流量,不与默认的日常内容/全部流量记录直接混排。阅读中位数不是投放总触达,同行百分位不保证适合你的产品,缺字段不是零。核对内容适配、档期和商业条件后,再另行决定是否联系。依据:xiaohongshu.pgy.get_blogger_notes_rate 的公开输出合同;join_pgy_performance.py 仅在本地运行,不发起表现查询,也不联系博主。
达人页的资料按什么顺序核对?
选合作候选时,先看候选表中可确认的 picturePrice、videoPrice 和案例。入围后用同一博主的 user_id 取详情和粉丝画像,按第 8 节保留表现数据的日期、内容类型和推广条件。页面上的成长、服务或成本模块先列成待核列,实际响应有同口径值时才填。例如合作要求受众在本地,就先确认地域证据和近期案例,再补其他材料。

