/v1/call/xiaohongshu.kol_costs小红书蒲公英博主合作成本和数据概览接口
小红书独有的接口。
按蒲公英博主编号取这位小红书博主的合作成本。小红书蒲公英博主合作成本和数据概览 API(数据接口)每次调用 24 积分(约 $0.048–$0.08),失败不扣。用 HTTP 调用,或让 AI 客户端通过 MCP 调用。
最近更新:
调用小红书蒲公英博主合作成本和数据概览,你会拿到什么。
取自一次录制的返回。
录制的一次调用返回了下面这个对象。名称和正文在示例里去掉了,数字是录制时的真实值。
| 字段 | 录制时的值 |
|---|---|
| title | null |
| url | null |
| rank | null |
| heat | null |
| fields.date | 2026-11-09T00:00:00Z |
| fields.currency | 示例里已去掉 |
| fields.image_cpm | 1202.709 |
| fields.image_cpm_percentile | 0.1 |
| fields.video_cpm | 11556.0641 |
| fields.video_cpm_percentile | 0.019 |
| fields.image_cpe | 572.2222 |
| fields.image_cpe_percentile | 0.023 |
| fields.video_cpe | 214.5833 |
| fields.video_cpe_percentile | 0.041 |
| fields.image_read_cost | 25.2377 |
| fields.image_read_cost_percentile | 0.745 |
| fields.video_read_cost | 76.313 |
| fields.video_read_cost_percentile | 0.767 |
| fields.image_shop_visit_cost | null |
| fields.image_shop_visit_cost_percentile | null |
每次 24 积分(≈ $0.048–$0.08),$10 约够 125 次。
小红书蒲公英博主合作成本和数据概览的请求与返回
curl https://socialtoai.app/v1/call/xiaohongshu.kol_costs \ -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://socialtoai.app/v1/call/xiaohongshu.kol_costs", 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_costs),参数是 id: 5c0017ef6b58b740c92463fb。# 你的 AI 会调用 call 工具,参数是:{ "id": "5c0017ef6b58b740c92463fb"}tab{ "op": "xiaohongshu.kol_costs", "platform": "xiaohongshu", "status": "ok", "items": [ { "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "entry", "entry_type": "pgy_creator_costs", "title": null, "url": null, "rank": null, "heat": null, "fields": { "date": "2026-11-09T00:00:00Z", "currency": "…", "image_cpm": "1202.709", "image_cpm_percentile": 0.0998, "video_cpm": "11556.0641", "video_cpm_percentile": 0.0188, "image_cpe": "572.2222", "image_cpe_percentile": 0.0227, "video_cpe": "214.5833", "video_cpe_percentile": 0.0411, "image_read_cost": "25.2377", "image_read_cost_percentile": 0.7452, "video_read_cost": "76.313", "video_read_cost_percentile": 0.7667, "image_shop_visit_cost": null, "image_shop_visit_cost_percentile": null, "video_shop_visit_cost": null, "video_shop_visit_cost_percentile": null, "median_impressions": 2200, "median_impressions_percentile": 0.4551, "median_reads": 302, "median_reads_percentile": 0.4167, "median_engagements": 22, "median_engagements_percentile": 0.4319, "median_shop_visits": 0, "median_shop_visits_percentile": 0, "follower_growth": 0.001, "follower_growth_percentile": 0.683, "invite_reply_rate": 0.375, "easy_to_reach": false, "active_days_7d": 7, "is_active": true, "notes_30d": 38, "highlight": "…", "highlight_reason": "…", "content_mix": [ { "category": "…", "share": 0.395 }, { "category": "…", "share": 0.395 } ], "industries": [] } } ], "unavailable": [], "cost_credits": 24}- entry_type
- pgy_creator_costs
- date
- 2026-11-09T00:00:00Z
- currency
- …
- image_cpm
- 1202.709
- image_cpm_percentile
- 0.0998
- video_cpm
- 11556.0641
- video_cpm_percentile
- 0.0188
示例里的名称和正文已去掉,数字是录制时的真实值。
小红书蒲公英博主合作成本和数据概览的参数。
2 个,1 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 必填 | — | 蒲公英博主编号,24 位十六进制;从蒲公英博主搜索的结果里取 |
| tab | string | 选填 | "everyday" | 看哪一类笔记的数:everyday 是日常笔记,sponsored 是合作笔记(商单);默认 everyday,和蒲公英博主页上的两个分栏一样"everyday""sponsored" |
这些值从哪里拿。
id蒲公英博主编号,24 位十六进制;从蒲公英博主搜索的结果里取(例如 5c0017ef6b58b740c92463fb)
这些接口返回的每一条都带 ref,原样填进来即可:
kol_search小红书蒲公英博主搜索接口kol_similar小红书蒲公英相似博主接口
小红书蒲公英博主合作成本和数据概览返回的字段。
小红书给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].extra | object | 平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。 |
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接;平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次,从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.date | string | 数据算到哪一天:北京时间的一个自然日,写成这个日期的 UTC 零点。 |
| items[].fields.currency | string | 各项花费的货币。 |
| items[].fields.image_cpm | string | 图文笔记的预估 CPM;蒲公英没有估出来时为 null。 |
| items[].fields.image_cpm_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.video_cpm | string | 视频笔记的预估 CPM;蒲公英没有估出来时为 null。 |
| items[].fields.video_cpm_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.image_cpe | string | 图文笔记的预估互动单价;蒲公英没有估出来时为 null。 |
| items[].fields.image_cpe_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.video_cpe | string | 视频笔记的预估互动单价;蒲公英没有估出来时为 null。 |
| items[].fields.video_cpe_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.image_read_cost | string | 图文笔记的预估阅读单价;蒲公英没有估出来时为 null。 |
| items[].fields.image_read_cost_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.video_read_cost | string | 视频笔记的预估阅读单价;蒲公英没有估出来时为 null。 |
| items[].fields.video_read_cost_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.image_shop_visit_cost | string | 图文笔记的预估外溢进店单价;蒲公英没有估出来时为 null。 |
| items[].fields.image_shop_visit_cost_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.video_shop_visit_cost | string | 视频笔记的预估外溢进店单价;蒲公英没有估出来时为 null。 |
| items[].fields.video_shop_visit_cost_percentile | number | 低于多少同类博主(蒲公英的“优于同行”),0 到 1。 |
| items[].fields.median_impressions | integer | 单篇笔记曝光数的中位数。 |
| items[].fields.median_impressions_percentile | number | 超过了多少同类博主,0 到 1。 |
| items[].fields.median_reads | integer | 单篇笔记阅读数的中位数。 |
| items[].fields.median_reads_percentile | number | 超过了多少同类博主,0 到 1。 |
| items[].fields.median_engagements | integer | 单篇笔记互动数的中位数。 |
| items[].fields.median_engagements_percentile | number | 超过了多少同类博主,0 到 1。 |
| items[].fields.median_shop_visits | integer | 单篇笔记带来的外溢进店人数的中位数。 |
| items[].fields.median_shop_visits_percentile | number | 超过了多少同类博主,0 到 1。 |
| items[].fields.follower_growth | number | 近 30 天粉丝增长率:0.037 是涨了 3.7%,掉粉时为负。 |
| items[].fields.follower_growth_percentile | number | 超过了多少同类博主,0 到 1。 |
| items[].fields.invite_reply_rate | number | 合作邀约在 48 小时内回复的比例,0 到 1。 |
| items[].fields.easy_to_reach | boolean | 蒲公英是否标了“好联系”。 |
| items[].fields.active_days_7d | integer | 近 7 天里活跃的天数。 |
| items[].fields.is_active | boolean | 蒲公英是否标了“活跃”。 |
| items[].fields.notes_30d | integer | 近 30 天发布的笔记数,日常和合作笔记都算。 |
| items[].fields.highlight | string | 蒲公英标的优势,平台的原话;没有时为 null。 |
| items[].fields.highlight_reason | string | 这个优势的说明,平台的原话。 |
| items[].fields.content_mix | array | 内容类型占比,占比高的在前:category、share。 |
| items[].fields.industries | string[] | 合作过的行业,平台的原话。 |
null小红书给不了的字段这个调用的字段小红书都给得出;单条内容缺某个值时,那个字段是 null。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
小红书蒲公英博主合作成本和数据概览的翻页与计费。
每把 Key 每秒 5 次,购买后 20 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
接口上次实测:2026-11-20。每次调用从平台读取,返回里的 fetched_at 是读取时间;同一把 Key 5 分钟内重发完全相同的请求算重放(replayed: true),0 积分,返回第一次读到的结果。
接好 MCP 后,这样问就会用到小红书蒲公英博主合作成本和数据概览。
按蒲公英博主编号取这位小红书博主的合作成本:5c0017ef6b58b740c92463fb
24 积分call {"op":"xiaohongshu.kol_costs","id":"5c0017ef6b58b740c92463fb"}按蒲公英博主编号取这位小红书博主的合作成本:5c0017ef6b58b740c92463fb,tab 取 sponsored。
24 积分call {"op":"xiaohongshu.kol_costs","id":"5c0017ef6b58b740c92463fb","tab":"sponsored"}按搜索词找蒲公英上的小红书博主(按博主写的内容匹配),再对前 3 个结果:按蒲公英博主编号取这位小红书博主的合作成本。
96 积分call {"op":"xiaohongshu.kol_search"}call {"op":"xiaohongshu.kol_costs","id":"<ref>"} × 3
交给你的 AI。
复制给 Claude 或 ChatGPT。
怎么接用 SocialToAI 的 MCP 服务(https://socialtoai.app/mcp)完成这件事:按蒲公英博主编号取这位小红书博主的合作成本:5c0017ef6b58b740c92463fb调用 call 工具,参数是 {"op":"xiaohongshu.kol_costs","id":"5c0017ef6b58b740c92463fb"}。必填:id;可选:tab(everyday、sponsored)。要查多个就一个一个调用,每个 24 积分。开跑前先算出总共要多少积分,问我同意了再调用。拿到结果后,可以接着调:call xiaohongshu.kol_notes(蒲公英博主笔记)、call xiaohongshu.kol_similar(蒲公英相似博主),用返回的 ref 或 username。如果还没接上 SocialToAI,告诉我怎么接,不要让我把 Key 贴进对话。回答时附上你用到的每一条的链接,最后告诉我花了多少积分。接好 MCP 后把这段话贴进对话。里面没有 Key:在 Claude 和 ChatGPT 里登录授权,其他客户端把 Key 放在请求头里。
接着看。
官方能做什么、谁能申请、多少钱,带来源。
找达人、看资料、看粉丝画像,各平台能拿到什么。
让 ChatGPT 读小红书笔记和评论
让 Claude Code、Cursor 读小红书和抖音:不扫码、不用 Cookie,以及本地自建要付出什么
海外品牌用 AI 监测小红书、抖音和微博:英文输出、带原帖链接
蒲公英和星图的接口:两边的搜索怎么匹配、要什么编号、一份名单多少钱
让你的 AI 直接读小红书。