按内容关键词批量找小红书蒲公英达人，导出报价、粉丝数、阅读和互动中位数到 CSV，再给单个达人出一份带粉丝画像的报告。不用蒲公英账号，不用 Cookie，不用爬虫，投放前筛达人用得上。
一个脚本，不用装依赖，Python 3.9 以上就能跑。
git clone https://github.com/data-x-api/pugongying-api
cd pugongying-api
python3 pgy.py search 咖啡 --yes # 找达人，存成 creators-咖啡.csv
python3 pgy.py report 达人编号 --yes # 一位达人的报告，存成 report-编号.md不加 --yes 只打印最多花多少，不调用。真跑需要一个 DataXAPI 的 Key：注册（可免费试用，最多 333 次），然后 export DATAXAPI_API_KEY=dx_...。
search：一次一页，一页 20 位，每一位都有：
| 达人编号 | 昵称 | 所在地 | 类目 | 粉丝 | 图文报价（元） | 视频报价（元） | 商单笔记数 | 阅读中位数 | 互动中位数 |
|---|---|---|---|---|---|---|---|---|---|
| 5c28…（已遮） | e** | 浙江 | 美食、出行旅游 | 52,087 | 3,000 | 3,500 | 96 | 2,225 | 403 |
| 556e…（已遮） | L** | 四川 | 美食、出行旅游 | 8,289 | 1,200 | 2,000 | 138 | 699 | 208 |
| 54e5…（已遮） | 萌** | 北京 | 美食、出行旅游 | 4,670 | 2,000 | 2,500 | 66 | 811 | 164 |
上表是 2026-11-05 搜“咖啡”的真实结果，这里遮掉了昵称和编号，你跑出来的是完整的。
report：最近 30 或 90 天的表现和粉丝画像，真实样子见 sample/report.md（同样遮掉了昵称）：
- 笔记数：32
- 阅读中位数：1673
- 互动率：18.4%
- 百赞笔记占比：93.8%
- 性别：女 74.0%，男 26.0%
- 年龄：25-34 51.8%，35-44 18.4%，18-24 15.1%，>44 13.0%，<18 1.7%
- 城市：长沙 17.0%，宁波 9.8%，镇江 4.9%，深圳 3.8%，广州 3.5%
每次调用 $0.04，失败不扣费。
| 做什么 | 调用次数 | 花费 |
|---|---|---|
search 一页（20 位达人） |
1 | $0.04 |
report 一位达人（资料、表现、画像） |
3 | $0.12 |
先用 search 按报价和互动筛，只给留下的达人跑 report，20 位里挑 3 位细看一共 $0.40。
2026-11-05（北京时间）：
$ python3 pgy.py search 咖啡 --yes
最多花 $0.04：1 次调用，每次 $0.04；失败不扣费
“咖啡”找到 20 位达人 → creators-咖啡.csv
调用 1 次，其中失败 0 次（不扣费），实际扣费 $0.0400
$ python3 pgy.py report 达人编号 --yes
最多花 $0.12：3 次调用，每次 $0.04；失败不扣费
调用 3 次，其中失败 0 次（不扣费），实际扣费 $0.1200
| 命令 | 参数 | 默认 | 说明 |
|---|---|---|---|
search |
--pages N |
1 | 翻几页 |
search |
--out 文件 |
creators-搜索词.csv |
CSV 文件，Excel 能直接打开 |
report |
--window |
30d |
看最近 30 天（30d）或 90 天（90d） |
report |
--out 文件 |
report-编号.md |
Markdown 文件 |
搜索词是按达人写的内容匹配的；没有完全对得上的词时，也会返回沾边的达人。
- 这是 DataXAPI 的示例项目，不是小红书或蒲公英的官方项目。脚本里只有调用接口的代码，没有爬虫。接口说明见蒲公英达人搜索。
- 报价和数据是取数时平台上的数字，实际合作价以和达人谈定的为准。请遵守法律和平台规则，不要用于骚扰他人。
- 问题和建议提 issue，或写信到 support@dataxapi.com。MIT 许可证。
Search Xiaohongshu (RedNote) PGY (Pugongying) creators by topic and export rate cards, followers, median reads and median engagements to CSV; get one creator's report with audience breakdown as Markdown. No PGY account, no cookies, no scraper. One Python 3.9+ script with no dependencies. $0.04 a call, failed calls free; it prints the most a run can cost and calls nothing until you add --yes. Needs a DataXAPI key in DATAXAPI_API_KEY. Unofficial.