/v1/call/xiaohongshu.kol_performance小红书蒲公英博主数据表现接口
小红书独有的接口。
按蒲公英博主编号取这位小红书博主近 30 天或 90 天日常笔记的数据表现:笔记数,曝光、阅读、互动的中位数,互动率,完播率,点赞过百和过千的笔记占比,和超过了多少同类博主。小红书蒲公英博主数据表现 API(数据接口)每次调用 24 积分(约 $0.048–$0.08),失败不扣。用 HTTP 调用,或让 AI 客户端通过 MCP 调用。
最近更新:
调用小红书蒲公英博主数据表现,你会拿到什么。
取自一次录制的返回。
录制的一次调用返回了下面这个对象。名称和正文在示例里去掉了,数字是录制时的真实值。
给 AI 读更省:同一份录制数据(1 条),平台原始 JSON 约 3,378 token,这个接口返回约 382 token,少 88%(2026-11-06 实测)。 测量方法
| 字段 | 录制时的值 |
|---|---|
| title | null |
| url | null |
| rank | null |
| heat | null |
| fields.notes | 34 |
| fields.median_impressions | 3,535 |
| fields.median_reads | 533 |
| fields.median_engagements | 12 |
| fields.median_likes | 10 |
| fields.median_collects | 2 |
| fields.median_comments | 0 |
| fields.median_shares | 3 |
| fields.engagement_rate | 0.032 |
| fields.video_completion_rate | 0.321 |
| fields.image_3s_read_rate | 0.798 |
| fields.hundred_like_share | 0.088 |
| fields.thousand_like_share | 0 |
| fields.impressions_percentile | 0.523 |
| fields.reads_percentile | 0.476 |
| fields.engagements_percentile | 0.333 |
每次 24 积分(≈ $0.048–$0.08),$10 约够 125 次。
小红书蒲公英博主数据表现的请求与返回
curl https://api.socialtoai.com/v1/call/xiaohongshu.kol_performance \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "5c0017ef6b58b740c92463fb" }'import osimport uuidimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/call/xiaohongshu.kol_performance", headers={ "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}", # A new key for each request; the same one again retries it without paying twice. "Idempotency-Key": str(uuid.uuid4()), }, json={ "id": "5c0017ef6b58b740c92463fb", },)print(response.json())# 已经通过 MCP 接好了?直接用大白话问。用“小红书蒲公英博主数据表现”接口(xiaohongshu.kol_performance),参数是 id: 5c0017ef6b58b740c92463fb。# 你的 AI 会调用 call 工具,参数是:{ "id": "5c0017ef6b58b740c92463fb"}window{ "op": "xiaohongshu.kol_performance", "platform": "xiaohongshu", "status": "ok", "items": [ { "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "type": "entry", "entry_type": "pgy_creator_metrics", "title": null, "url": null, "rank": null, "heat": null, "fields": { "notes": 34, "median_impressions": 3535, "median_reads": 533, "median_engagements": 12, "median_likes": 10, "median_collects": 2, "median_comments": 0, "median_shares": 3, "engagement_rate": 0.032, "video_completion_rate": 0.321, "image_3s_read_rate": 0.798, "hundred_like_share": 0.088, "thousand_like_share": 0, "impressions_percentile": 0.523, "reads_percentile": 0.476, "engagements_percentile": 0.333 } } ], "unavailable": [], "cost_credits": 24}- entry_type
- pgy_creator_metrics
- notes
- 34
- median_impressions
- 3535
- median_reads
- 533
- median_engagements
- 12
- median_likes
- 10
- median_collects
- 2
示例里的名称和正文已去掉,数字是录制时的真实值。
小红书蒲公英博主数据表现的参数。
2 个,1 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 必填 | — | 蒲公英博主编号,24 位十六进制;从蒲公英博主搜索的结果里取 |
| window | string | 选填 | "30d" | 统计周期:近 30 天或近 90 天"30d""90d" |
这些值从哪里拿。
id蒲公英博主编号,24 位十六进制;从蒲公英博主搜索的结果里取(例如 5c0017ef6b58b740c92463fb)
这些接口返回的每一条都带 ref,原样填进来即可:
kol_search小红书蒲公英博主搜索接口
小红书蒲公英博主数据表现返回的字段。
小红书给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接;平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次,从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.notes | integer | 统计周期内的笔记数。 |
| items[].fields.median_impressions | integer | 单篇笔记曝光数的中位数。 |
| items[].fields.median_reads | integer | 单篇笔记阅读数的中位数。 |
| items[].fields.median_engagements | integer | 单篇笔记互动数的中位数。 |
| items[].fields.median_likes | integer | 单篇笔记点赞数的中位数。 |
| items[].fields.median_collects | integer | 单篇笔记收藏数的中位数。 |
| items[].fields.median_comments | integer | 单篇笔记评论数的中位数。 |
| items[].fields.median_shares | integer | 单篇笔记分享数的中位数。 |
| items[].fields.engagement_rate | number | 互动率,0 到 1。 |
| items[].fields.video_completion_rate | number | 视频笔记的完播率,0 到 1。 |
| items[].fields.image_3s_read_rate | number | 图文笔记的 3 秒阅读率,0 到 1。 |
| items[].fields.hundred_like_share | number | 点赞过百的笔记占比,0 到 1。 |
| items[].fields.thousand_like_share | number | 点赞过千的笔记占比,0 到 1。 |
| items[].fields.impressions_percentile | number | 曝光中位数超过同类博主的比例,0 到 1。 |
| items[].fields.reads_percentile | number | 阅读中位数超过同类博主的比例,0 到 1。 |
| items[].fields.engagements_percentile | number | 互动中位数超过同类博主的比例,0 到 1。 |
null小红书给不了的字段这个调用的字段小红书都给得出;单条内容缺某个值时,那个字段是 null。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
小红书蒲公英博主数据表现的翻页与计费。
每把 Key 每秒 5 次,购买后 20 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
接口上次实测:2026-10-30。每次调用从平台读取,返回里的 fetched_at 是读取时间;同一把 Key 5 分钟内重发完全相同的请求算重放(replayed: true),0 积分,返回第一次读到的结果。
接好 MCP 后,这样问就会用到小红书蒲公英博主数据表现。
按蒲公英博主编号取这位小红书博主近 30 天或 90 天日常笔记的数据表现:5c0017ef6b58b740c92463fb
24 积分call {"op":"xiaohongshu.kol_performance","id":"5c0017ef6b58b740c92463fb"}按蒲公英博主编号取这位小红书博主近 30 天或 90 天日常笔记的数据表现:5c0017ef6b58b740c92463fb,window 取 90d。
24 积分call {"op":"xiaohongshu.kol_performance","id":"5c0017ef6b58b740c92463fb","window":"90d"}按搜索词找蒲公英上的小红书博主(按博主写的内容匹配):咖啡,再对前 3 个结果:按蒲公英博主编号取这位小红书博主近 30 天或 90 天日常笔记的数据表现。
96 积分call {"op":"xiaohongshu.kol_search","query":"咖啡"}call {"op":"xiaohongshu.kol_performance","id":"<ref>"} × 3
交给你的 AI。
复制给 Claude 或 ChatGPT。
怎么接用 SocialToAI 的 MCP 服务(https://mcp.socialtoai.com/mcp)完成这件事:按蒲公英博主编号取这位小红书博主近 30 天或 90 天日常笔记的数据表现:5c0017ef6b58b740c92463fb调用 call 工具,参数是 {"op":"xiaohongshu.kol_performance","id":"5c0017ef6b58b740c92463fb"}。必填:id;可选:window(30d、90d)。要查多个就一个一个调用,每个 24 积分。开跑前先算出总共要多少积分,问我同意了再调用。拿到结果后,可以接着调:call xiaohongshu.kol_notes(蒲公英博主笔记),用返回的 ref 或 username。如果还没接上 SocialToAI,告诉我怎么接,不要让我把 Key 贴进对话。回答时附上你用到的每一条的链接,最后告诉我花了多少积分。接好 MCP 后把这段话贴进对话。里面没有 Key:在 Claude 和 ChatGPT 里登录授权,其他客户端把 Key 放在请求头里。
同名的接口,换个平台。
全部平台和价格/v1/call/xiaohongshu.kol_performance{ "id": "5c0017ef6b58b740c92463fb" }24 积分每次调用接着看。
官方能做什么、谁能申请、多少钱,带来源。
找达人、看资料、看粉丝画像,各平台能拿到什么。
让 ChatGPT 读小红书笔记和评论
让 Claude Code、Cursor 读小红书和抖音:不扫码、不用 Cookie,以及本地自建要付出什么
海外品牌用 AI 监测小红书、抖音和微博:英文输出、带原帖链接
蒲公英和星图的接口:两边的搜索怎么匹配、要什么编号、一份名单多少钱
让你的 AI 直接读小红书。