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

> 在小红书官方达人广场蒲公英按内容搜达人，用粉丝数、笔记类型和报价筛选排序，再给入围名单拉完整资料：步骤、字段、代码和花费。

网页版：https://okdata.online/zh/guides/xiaohongshu-pgy-creator-rates/

两个接口：先用小红书蒲公英达人搜索，按内容、粉丝数和笔记类型筛达人，按报价、阅读或互动排序，再对入围的每位达人调小红书蒲公英达人详情。下面的示例一共 6 次调用，花费 $0.24；失败的调用不扣费。

更新于 2026-11-12

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

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

## 分步操作

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

调用[小红书蒲公英达人搜索](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/search/)，`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"`。

```bash
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 条结果，与其一直翻页，不如把筛选条件收紧。

### 第二步：拉完整资料

[小红书蒲公英达人详情](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/get/)接收达人 `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`）。

```bash
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，所以从[笔记搜索](https://okdata.online/zh/apis/xiaohongshu/notes/search/)里拿到的 `author.id` 也可以直接查详情，看看靠笔记发现的博主有没有入驻蒲公英。

### 第三步：用 Python 排序并导出

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

```python
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](https://okdata.online/zh/answers/xiaohongshu-pgy-creator-data-api/)。跨平台找达人的整体做法，见[达人发现](https://okdata.online/zh/solutions/creator-discovery/)。

## 示例花费

在蒲公英搜一次“敏感肌”达人，粉丝 1 万到 10 万、以视频笔记为主、报价从低到高，再拉其中 5 位的完整资料

| 接口 | 调用次数 | 单价 | 小计 |
|---|---|---|---|
| [小红书蒲公英达人搜索](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/search/) | 1 | $0.04 | $0.04 |
| [小红书蒲公英达人详情](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/get/) | 5 | $0.04 | $0.20 |
| 合计 | 6 |  | $0.24 |

按本页生成时的价格计算。失败的调用不扣费。

## 在你的 AI 里用（MCP）

先接好 MCP 服务，然后直接说你要什么。智能体会自己找到这些接口、看清价格，再用你的余额调用。

可以这样说：在小红书蒲公英搜“敏感肌”达人，粉丝 1 万到 10 万、以视频笔记为主、报价从低到高。算出视频笔记报价除以阅读中位数的千次阅读成本，挑最划算的 5 位拉蒲公英完整资料，整理成一张表。

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

MCP：`https://api.okdata.online/mcp`

## 本指南用到的接口

- [小红书蒲公英达人搜索](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/search/) `xiaohongshu.pgy.creators.search`：$0.04/次 · 每页约 20 位达人
- [小红书蒲公英达人详情](https://okdata.online/zh/apis/xiaohongshu/pgy/creators/get/) `xiaohongshu.pgy.creators.get`：$0.04/次

## 更多小红书内容

- [小红书 API](https://okdata.online/zh/apis/xiaohongshu/)
- [小红书 API Python 教程：笔记、博主和评论（2026）](https://okdata.online/zh/guides/xiaohongshu-api-python/)
- [怎么按关键词批量导出小红书评论](https://okdata.online/zh/guides/xiaohongshu-note-comments/)
- [怎么搜索小红书笔记并导出成 CSV 表格](https://okdata.online/zh/guides/xiaohongshu-search-export-notes/)
- [能让 AI 智能体帮我筛选小红书、抖音的达人吗？](https://okdata.online/zh/answers/ai-agent-creator-shortlist/)
- [小红书蒲公英达人的图文报价和视频报价是怎么给出的？](https://okdata.online/zh/answers/pgy-creator-price-image-video/)
- [怎么找某个领域的小红书博主，并拿到他们的粉丝数？](https://okdata.online/zh/answers/xiaohongshu-find-kol-creators/)
- [小红书蒲公英的达人数据和报价有 API 吗？](https://okdata.online/zh/answers/xiaohongshu-pgy-creator-data-api/)
- [抖音星图还是小红书蒲公英：我需要哪边的达人数据？](https://okdata.online/zh/answers/xingtu-vs-pgy-creator-data/)
- [怎么按粉丝区间和报价筛选抖音、小红书达人？](https://okdata.online/zh/answers/creator-shortlist-followers-price/)
- [自己爬还是按次调用数据接口：成本、维护和风险](https://okdata.online/zh/compare/scraping-vs-data-api/)
- [怎么选社交媒体数据 API（2026）](https://okdata.online/zh/compare/social-media-data-apis/)
- [社媒数据 MCP 服务器：自己部署还是用托管的](https://okdata.online/zh/compare/social-media-data-mcp-servers/)
- [小红书数据接口有哪些？官方开放平台、第三方 API、开源爬虫 4 类方案怎么选（2026）](https://okdata.online/zh/compare/xiaohongshu-data-apis/)