怎么在小红书蒲公英按报价和阅读量筛达人

要做的事：一个护肤品牌有 10 篇合作笔记的预算，想找内容对口、粉丝量在预算范围内、笔记真的有人看的达人。蒲公英是小红书官方的达人广场，品牌在这里下单合作，每个达人的主页都标着图文笔记和视频笔记的报价，以及日常笔记的阅读和互动中位数。做法是在蒲公英按内容搜索并加筛选，算出一篇笔记折合每千次阅读多少钱，再把要谈的 5 位的完整资料拉下来。最后得到一张能直接贴进 brief 的表。

不需要蒲公英品牌账号。用 API key 读的是蒲公英展示给广告主的数据，真正下单还是在蒲公英里完成。

分步操作

第一步：带筛选条件搜蒲公英

调用小红书蒲公英达人搜索，query 填关键词。决定结果的几个参数：

• search_by：notes（默认）拿关键词匹配达人笔记的内容；name 按昵称匹配。
• followers_min、followers_max：粉丝数区间。
• type：all（默认）、image 或 video，分别对应以图文为主或以视频为主的达人。
• sort：relevance（默认）、most_followers、most_engagements、most_reads、lowest_rate 或 highest_rate。

一次调用最多返回 20 位达人，每次 $0.04。每位有 id（24 位十六进制，和小红书用户 ID 相同）、name、username（小红书号）、location、gender、followers、categories、median_views（日常笔记阅读中位数）和 median_engagements。rates 是达人的报价（元）：image_note（图文笔记）和 video_note（视频笔记），各有 price 和 currency: "CNY"。

curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=敏感肌' \
  --data-urlencode 'followers_min=10000' \
  --data-urlencode 'followers_max=100000' \
  --data-urlencode 'type=video' \
  --data-urlencode 'sort=lowest_rate'

median_views 这个字段要重视。小红书公开笔记不显示浏览量，蒲公英给广告主看的阅读中位数，是能拿到的最接近“触达”的数字。这里的 engagement_rate 永远是 null：蒲公英不公布互动率，meta.unavailable 里有说明。想要的话自己用 median_engagements 除以 median_views。

要更多达人，就把 page.next_cursor 原样作为 cursor 传回去。蒲公英一次搜索最多只能翻到前 5000 条结果，与其一直翻页，不如把筛选条件收紧。

第二步：拉完整资料

小红书蒲公英达人详情接收达人 id，返回他当前的蒲公英资料，每次 $0.04。核心字段和搜索结果一样，但是最新的，并且每项报价都带 available，表示达人现在是否接这类单。加上 view=full，ext 里还有蒲公英自己的数据（展示的话）：获赞与收藏总数（ext.likes_and_saves）、特色标签（ext.feature_tags）、蒲公英预估的视频笔记 CPM（ext.cpm_video）、近 30 天合作笔记数（ext.sponsored_notes_30d），以及 48 小时内回复邀约的比例（ext.invite_reply_48h_pct）。

curl -G "https://api.okdata.online/v1/xiaohongshu/pgy/creators/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=5e8b2c41000000000100a7d3' \
  --data-urlencode 'view=full'

蒲公英达人 ID 就是小红书用户 ID，所以从笔记搜索里拿到的 author.id 也可以直接查详情，看看靠笔记发现的博主有没有入驻蒲公英。

第三步：用 Python 排序并导出

下面的脚本搜索一次，按“视频笔记报价 ÷ 阅读中位数 × 1000”给达人打分，取最划算的 5 位拉详情，写成 CSV。

import csv
import os
import requests

API = "https://api.okdata.online"
HEADERS = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
SHORTLIST = 5  # 拉几位的详情；每位一次调用


def get(path, **params):
    body = requests.get(API + path, headers=HEADERS, params=params, timeout=60).json()
    if body["code"] != "ok":
        raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})")
    return body["data"]


def rate(creator, kind):
    return next((r for r in creator["rates"] or [] if r["type"] == kind), None)


def per_1k_reads(creator):
    video = rate(creator, "video_note")
    reads = creator["median_views"]
    return video["price"] / reads * 1000 if video and video["price"] and reads else float("inf")


found = get("/v1/xiaohongshu/pgy/creators/search", query="敏感肌", followers_min=10000,
            followers_max=100000, type="video", sort="lowest_rate")["items"]
shortlist = sorted(found, key=per_1k_reads)[:SHORTLIST]

with open("pgy_shortlist.csv", "w", newline="", encoding="utf-8-sig") as f:
    out = csv.writer(f)
    out.writerow(["name", "pgy_id", "followers", "median_reads", "median_engagements",
                  "image_note_cny", "image_open", "video_note_cny", "video_open", "cny_per_1k_reads"])
    for c in shortlist:
        p = get("/v1/xiaohongshu/pgy/creators/get", id=c["id"])["item"]
        image, video = rate(p, "image_note") or {}, rate(p, "video_note") or {}
        score = per_1k_reads(p)
        out.writerow([p["name"], p["id"], p["followers"], p["median_views"], p["median_engagements"],
                      image.get("price"), image.get("available"), video.get("price"), video.get("available"),
                      round(score, 1) if score != float("inf") else ""])

如果入围 30 位而不是 5 位，详情部分是 $1.20。

注意事项

• 这是挂牌价，不是成交价。 蒲公英显示的是达人挂出的价格，平台服务费和谈下来的折扣要在蒲公英下单时才确定。
• 暂停接单。 available: false 表示达人挂着这种笔记的报价，但现在不接。联系之前先看一眼。
• 只有入驻蒲公英的达人才有资料。 没入驻的达人查详情会返回 not_found，不扣费。
• 有些数据只在蒲公英后台。 粉丝画像和达人过往的合作笔记不在这些字段里，签约前去蒲公英后台核对。
• 重试不会重复扣费。 每次调用带一个 Idempotency-Key 请求头。24 小时内同样的请求配同样的 key，会直接拿回上次的结果，meta.replayed 为 true，不再扣费。
• 下单前再刷新一次。 报价和中位数每投一轮都可能变，发 brief 的当天再拉一次详情。

蒲公英官方给开发者提供了什么、和这种方式有什么区别，见小红书蒲公英达人数据 API。跨平台找达人的整体做法，见达人发现。

{
  "endpoint": "xiaohongshu.pgy.creators.search",
  "params": {
    "query": "户外"
  },
  "idempotency_key": "<新的 UUID>"
}