POST
/v1/call/xiaohongshu.kol_notes小红书蒲公英博主笔记接口
小红书独有的接口。
按蒲公英博主编号取一页这位小红书博主的笔记，从新到旧，带蒲公英给的数据：阅读数、点赞数、收藏数、是否商业合作和合作品牌。小红书蒲公英博主笔记 API（数据接口）每次调用 24 积分（约 $0.048–$0.08），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。
24 积分每次调用约 ¥0.58（≈ $0.048–$0.08）
每页最多 8 条一次调用返回一页
969 B示例返回的体积（1 条）
最近更新：
读 1,000 条约 3,000 积分，约 ¥72（$10.00）。
每日监控：对你的 AI 说“每天帮我盯着”，这个调用每天自己跑，只把新内容发给你，一个月最多 744 积分，约 ¥18（$2.48）。 看怎么设
调用小红书蒲公英博主笔记，你会拿到什么。
取自一次录制的返回。
录制的一次调用返回了 8 条，下面是第一条的每个字段。名称和正文在示例里去掉了，数字是录制时的真实值。
| 字段 | 录制时的值 |
|---|---|
| title | 示例里已去掉 |
| url | null |
| rank | null |
| heat | null |
| fields.format | video |
| fields.published_at | 2026-10-09T16:00:00.000Z |
| fields.cover_url | 示例里已去掉 |
| fields.is_sponsored | false |
| fields.brand | null |
| fields.views | 75 |
| fields.likes | 5 |
| fields.collects | 1 |
每次 24 积分（≈ $0.048–$0.08），$10 约够 125 次。
小红书蒲公英博主笔记的请求与返回
curl https://api.socialtoai.com/v1/call/xiaohongshu.kol_notes \ -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_notes", 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_notes），参数是 id: 5c0017ef6b58b740c92463fb。# 你的 AI 会调用 call 工具，参数是：{ "id": "5c0017ef6b58b740c92463fb"}200 OK969 B24 积分
{ "op": "xiaohongshu.kol_notes", "platform": "xiaohongshu", "status": "ok", "items": [ { "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "type": "entry", "entry_type": "pgy_creator_post", "title": "…", "url": null, "rank": null, "heat": null, "fields": { "format": "video", "published_at": "2026-10-09T16:00:00.000Z", "cover_url": "https://example.com/…", "is_sponsored": false, "brand": null, "views": 75, "likes": 5, "collects": 1 } } ], "unavailable": [], "page": { "has_more": true, "cursor": "cur_…", "cursor_expires_at": "2026-10-12T22:23:52.000Z" }, "cost_credits": 24}- entry_type
- pgy_creator_post
- format
- video
- published_at
- 2026-10-09T16:00:00.000Z
- cover_url
- https://example.com/…
- is_sponsored
- false
- brand
null- views
- 75
示例里的名称和正文已去掉，数字是录制时的真实值。
示例数据录制的 8 条里的 1 条
小红书蒲公英博主笔记的参数。
2 个，1 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里，不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 必填 | — | 蒲公英博主编号，24 位十六进制；从蒲公英博主搜索的结果里取 |
| cursor | string | 选填 | — | 填上一次返回的 page.cursor，取下一页。 |
这些值从哪里拿。
id蒲公英博主编号，24 位十六进制；从蒲公英博主搜索的结果里取（例如 5c0017ef6b58b740c92463fb）
这些接口返回的每一条都带 ref，原样填进来即可：
kol_search小红书蒲公英博主搜索接口
小红书蒲公英博主笔记返回的字段。
小红书给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接；平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次，从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.format | string | image 是图文笔记，video 是视频笔记。 |
| items[].fields.published_at | string | 发布日期。平台只给到日，以北京时间当天零点表示。 |
| items[].fields.cover_url | string | 封面图地址。 |
| items[].fields.is_sponsored | boolean | 是否商业合作笔记。 |
| items[].fields.brand | string | 合作的品牌，用平台的原话；不是合作笔记时为 null。 |
| items[].fields.views | integer | 阅读数。 |
| items[].fields.likes | integer | 点赞数。 |
| items[].fields.collects | integer | 收藏数。 |
null小红书给不了的字段这个调用的字段小红书都给得出；单条内容缺某个值时，那个字段是 null。
每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。 返回格式
小红书蒲公英博主笔记的翻页与计费。
一次调用返回一页，最多 8 条；page.has_more 为 true 时把 page.cursor 填进 cursor 取下一页，每页 24 积分，cursor 30 分钟内有效。
正常执行但没有结果，算一次成功的调用：status 为 "empty"，items 为空，扣 24 积分。
小红书的这个接口分不清“笔记不存在”和“没有数据”：两种情况都返回 empty，并照常扣费。
每把 Key 每秒 5 次，购买后 20 次；超出不扣费。 频率限制
失败的调用 0 积分，不会自动重试。 错误码
接口上次实测：2026-10-30。每次调用从平台读取，返回里的 fetched_at 是读取时间；同一把 Key 5 分钟内重发完全相同的请求算重放（replayed: true），0 积分，返回第一次读到的结果。
接好 MCP 后，这样问就会用到小红书蒲公英博主笔记。
按蒲公英博主编号取一页这位小红书博主的笔记，从新到旧，带蒲公英给的数据：5c0017ef6b58b740c92463fb
24 积分call {"op":"xiaohongshu.kol_notes","id":"5c0017ef6b58b740c92463fb"}按搜索词找蒲公英上的小红书博主（按博主写的内容匹配）：咖啡，再对前 3 个结果：按蒲公英博主编号取一页这位小红书博主的笔记，从新到旧，带蒲公英给的数据。
96 积分call {"op":"xiaohongshu.kol_search","query":"咖啡"}call {"op":"xiaohongshu.kol_notes","id":"<ref>"} × 3
交给你的 AI。
复制给 Claude 或 ChatGPT。
怎么接用 SocialToAI 的 MCP 服务（https://mcp.socialtoai.com/mcp）完成这件事：按蒲公英博主编号取一页这位小红书博主的笔记，从新到旧，带蒲公英给的数据：5c0017ef6b58b740c92463fb调用 call 工具，参数是 {"op":"xiaohongshu.kol_notes","id":"5c0017ef6b58b740c92463fb"}。必填：id。要更多就把返回的 page.cursor 填进 cursor 再调一次，每页 24 积分。开跑前先算出总共要多少积分，问我同意了再调用。如果还没接上 SocialToAI，告诉我怎么接，不要让我把 Key 贴进对话。回答时附上你用到的每一条的链接，最后告诉我花了多少积分。接好 MCP 后把这段话贴进对话。里面没有 Key：在 Claude 和 ChatGPT 里登录授权，其他客户端把 Key 放在请求头里。
接着看。
小红书官方 API 的申请条件和价格
官方能做什么、谁能申请、多少钱，带来源。
各平台达人接口对比
找达人、看资料、看粉丝画像，各平台能拿到什么。
怎么让 ChatGPT 读小红书
让 ChatGPT 读小红书笔记和评论
让 Claude Code 和 Cursor 读小红书和抖音：不扫码、不用 Cookie、不牵连账号
让 Claude Code、Cursor 读小红书和抖音：不扫码、不用 Cookie，以及本地自建要付出什么
海外品牌怎么用 AI 监测小红书、抖音和微博
海外品牌用 AI 监测小红书、抖音和微博：英文输出、带原帖链接
小红书蒲公英、抖音星图怎么找达人
蒲公英和星图的接口：两边的搜索怎么匹配、要什么编号、一份名单多少钱
小红书 MCP 服务器
让你的 AI 直接读小红书。
关于小红书蒲公英博主笔记的常见问题。
简短回答。
全部小红书数据接口需要小红书账号，或者申请小红书官方的 API 吗？
不需要，只要一把 SocialToAI 的 Key。返回的是小红书上公开可见的内容和账号信息，你不用登录小红书，也不用在那边申请任何东西。
一次调用折合多少钱？
24 积分：按每美元 300 积分（$10 起的购买）是 $0.08，按每美元 500 积分（$200 起）是 $0.048。积分不过期，不订阅。注册送 100 积分，不用绑卡。
调用失败或没搜到，扣不扣积分？
失败的调用 0 积分，也不会自动重试。正常执行但没有结果的算一次成功的调用：status 为 "empty"，扣 24 积分。这个接口分不清“不存在”和“没有数据”，两种都按空结果扣费。
一次调用返回多少条？
一次调用返回一页，最多 8 条；page.has_more 为 true 时把 page.cursor 填进 cursor 取下一页，每页 24 积分，cursor 30 分钟内有效。
调用频率有限制吗？
每把 Key 每秒 5 次，第一次购买后每秒 20 次。超出的请求会告诉你等多久再试，不扣积分。
怎么在 Claude、ChatGPT 或 Cursor 里用？
可以。在 Claude 或 ChatGPT 里把 MCP 地址 https://mcp.socialtoai.com/mcp 加成自定义连接器，用邮箱验证码登录后点“允许”，不用贴 Key。Claude Code 运行一条命令后输入 /mcp、选 socialtoai、登录；Codex 和 Cursor 也是登录授权，步骤在接入页。接好后直接用大白话问，你的 AI 会替你调用 call。