电商达人

小红书 API

也叫Xiaohongshu (RedNote)小红薯

21 个接口读小红书:笔记、图片、话题、用户、评论、热榜、蒲公英、小红书商城。一次 $0.0200 起。不用登录小红书,不用 Cookie;失败不收费。

接口21 个接口分 8 组,同一种返回格式
价格$0.0200 起约 ¥0.14一次。失败不收费
近 30 天可用99.9% 在线 · 接口在接调用的时间占比
数据当场取榜单是 10 分钟一次的快照

调一次,拿回来的样子

录下来的真实返回,字段已经整理好,直接给 AI 或表格用。
真实返回
GET/v1/xiaohongshu/notes/search$0.0200
字段值
typeimage
published_at2026-05-17 05:25 UTC
author.verifiedfalse
metrics.likes48
metrics.comments21
metrics.shares5
metrics.favorites10

2026-10-12 18:43 UTC 录下的真实返回,这里是前 7 行。

在 Playground 里跑一次 · $0.0200
录制的返回
{
  "code": "ok",
  "request_id": "d2403177-e4f6-4d04-99eb-afce599b4c31",
  "data": {
    "items": [
      {
        "id": "67d5e2be00000000d803d22d",
        "url": "https://www.xiaohongshu.com/explore/67d5e2be00000000d803d22d",
        "type": "image",
        "title": "实测一个月咖啡,结论有点意外",
        "text": "把咖啡从头到尾讲清楚,看完少走弯路",
        "published_at": "2026-05-17T05:25:25.000Z",
        "author": {
          "id": "6130783200000000883b2a1e",
          "username": "coffee_lab_sh",
          "name": "山野咖啡馆",
          "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/610f17040000000049dd4887.jpg",
          "verified": false
        },
        "metrics": {
          "likes": 48,
          "comments": 21,
          "shares": 5,
          "favorites": 10
        },
        "images": [
          "https://sns-webpic-qc.xhscdn.com/20261010/2d7c7c32da67d3c3d839!nd_dft_wlteh_webp_3"
        ]
      },
      // … 另有 14 条
    ]
  },
  "page": {
    "next_cursor": "c1.Ip12-f4dS4HmSDpdPex7WuLPBr1zJAbdhL_Wj8K0",
    "cursor_expires_at": "2026-10-12T19:43:26.000Z",
    "has_more": true,
    "returned": 15
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.notes.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T18:43:26.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "author.followers": "capability",
      "hashtags": "capability",
      "mentions": "capability",
      "is_pinned": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

取自 2026-10-12 18:43 UTC 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。

能拿到什么

每一行是一个接口:返回什么,一次多少钱。

接口路径返回价格
笔记3
小红书笔记搜索GET/v1/xiaohongshu/notes/search内容列表$0.0200
小红书笔记详情GET/v1/xiaohongshu/notes/get内容$0.0200
小红书笔记评论GET/v1/xiaohongshu/notes/comments/list评论列表$0.0200
图片1
小红书图片搜索GET/v1/xiaohongshu/images/search内容列表$0.0200
话题2
小红书话题详情GET/v1/xiaohongshu/topics/get话题$0.0200
小红书话题笔记GET/v1/xiaohongshu/topics/notes/list内容列表$0.0200
用户3
小红书用户搜索GET/v1/xiaohongshu/users/search账号列表$0.0200
小红书用户资料GET/v1/xiaohongshu/users/get账号$0.0200
小红书用户笔记GET/v1/xiaohongshu/users/notes/list内容列表$0.0200
评论1
小红书评论回复GET/v1/xiaohongshu/comments/replies/list评论列表$0.0200
小红书热点GET/v1/xiaohongshu/trends/list热点列表$0.0200
小红书蒲公英博主搜索GET/v1/xiaohongshu/pgy/creators/search达人列表$0.0400
小红书蒲公英博主粉丝画像GET/v1/xiaohongshu/pgy/creators/audience/get粉丝画像$0.0400
小红书蒲公英博主详情GET/v1/xiaohongshu/pgy/creators/get达人$0.0400
小红书蒲公英博主数据表现GET/v1/xiaohongshu/pgy/creators/metrics蒲公英博主数据表现$0.0400
小红书蒲公英博主笔记GET/v1/xiaohongshu/pgy/creators/notes/list蒲公英博主笔记列表$0.0400
小红书蒲公英关键词逐日搜索指数GET/v1/xiaohongshu/pgy/keywords/history关键词指数历史$0.0400
小红书蒲公英关联词GET/v1/xiaohongshu/pgy/keywords/related关联词列表$0.0400
小红书商品搜索GET/v1/xiaohongshu/shop/products/search商品列表$0.0200
小红书商品详情GET/v1/xiaohongshu/shop/products/get商品$0.0200
小红书商品评价GET/v1/xiaohongshu/shop/products/reviews/list评价列表$0.0200
价格是现行价格。失败和结果不确定的调用不收费。小红书 API 价格 →在 AI 里用小红书数据 →看实时状态 →

只有小红书有的数据

蒲公英、小红书商城:原本要登录小红书自己的后台才看得到的数据,在这里各是一次 GET。

小红书蒲公英 API →

博主搜索、报价、粉丝画像、数据表现、关键词搜索指数

小红书官方的博主合作平台:博主搜索、报价、粉丝画像和数据表现,以及关键词搜索指数。

一个关键词 2026-07-13 的数据 · 关键词已遮住真实返回
搜索指数8,876
笔记数33,361
曝光25,229,649
阅读4,523,846
互动188,216
GET /v1/xiaohongshu/pgy/creators/metrics$0.04007 个接口 · $0.0400 起 →
小红书商城 API →

商品搜索、商品详情、买家评价

小红书商城的公开商品数据:商品搜索、商品详情和买家评价。

GET /v1/xiaohongshu/shop/products/search$0.02003 个接口 · $0.0200 起 →
小红书热点灵感 →

现在小红书在看什么

调用那一刻平台自己的榜单,带热度值。免费榜单页上有完整的一份。

前 5 条 · 读取于 2026 年 11 月 2 日 08:04(北京时间)真实返回
1 孟子义谈尚公主遗憾2065.21万
2 金智秀新歌Addicted引热议1956.3万
3 大二工科生焊芯片翻车1940.63万
4 孟子义谈尚公主留有遗憾1918.36万
5 未成年人怎么坐火车1884.22万
GET /v1/xiaohongshu/trends/list$0.0200

大家拿它做什么

你的 AI 现在就能用小红书数据跑的现成任务。每个任务是几次调用,带花费上限。

在 Claude、Cursor 里直接问小红书

加上 DataXAPI 的 MCP,AI 会自己找到合适的小红书接口去调,回答里带原始链接。花多少钱按调了哪些接口算。

https://api.dataxapi.com/mcp

三步开始

这里演示的是小红书笔记搜索。小红书的其他接口都是同样的调法,返回同样的格式。

拿一把 Key

用邮箱验证码或 Google 登录。可免费试用,不用绑卡。

自己调,或者让你的 AI 调

代码里一次 GET。或者把下面这段话带着你的 Key 贴给你的 agent:它自己接好,然后能自己找到并调用这些接口。

读 https://dataxapi.com/agents.md,在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_live_…,之后所有 DataXAPI 的调用都用它。

登录后复制,带上你的 Key

每次读到的都是同一种格式

数据在 data.items(单个对象在 data.item),下一页在 page.next_cursor,扣了多少在 meta.billing.amount。失败不扣费。

看快速开始 →
curl -G "https://api.dataxapi.com/v1/xiaohongshu/notes/search" \
  --data-urlencode "query=咖啡" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
# pip install dataxapi
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.notes.search(query="咖啡")
print(result["data"]["items"])
// npm i @dataxapi/sdk
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.notes.search({ query: "咖啡" });
console.log(result.data.items);
dataxapi call xiaohongshu.notes.search 'query=咖啡'
{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

把这段加进你的 MCP 客户端,然后让你的 AI 调用 xiaohongshu.notes.search。

边界情况

小红书这些接口在边界上怎么表现,以及调用结果不对时先看哪里。

每页条数
列表每页 5 到 120 条,各接口不同。13 个列表里有 10 个能翻页:把 page.next_cursor 作为 cursor 传回,每一页是一次单独的调用。其余只有一页。
给不了的字段
21 个接口里有 17 个填不满它返回的对象。每个接口的页面列出了给不了哪些,每次返回也在 meta.unavailable 里再写一遍:缺的字段不会被悄悄写成 0。
对象不存在时读起来像空结果
小红书评论回复、小红书蒲公英关联词、小红书话题笔记、小红书商品评价、小红书蒲公英博主笔记:对象不存在和对象下面没有东西分不出来,所以返回空结果而不是 404,并按空结果计费。
预览结构
有 11 个接口返回的是预览结构,字段还可能调整;其余返回统一的结构,所有平台都一样。
快照
小红书热点:榜单是每 10 分钟刷新一次的快照,meta.fetched_at 写明是什么时候取的。
编号都是 24 位
笔记、用户、话题、商品的编号都是 24 位十六进制。笔记链接最后一段就是编号(/explore/编号 或 /discovery/item/编号);短链和分享口令不收。
搜索结果只是摘录
搜索返回的是结果卡片,不是笔记本身:正文是摘录,标题里的表情被去掉了。用户笔记列表只给正文前 100 个字。要全文,用笔记详情。
能打开的链接
搜索结果里的链接带着网页要的访问令牌,能直接打开。用户笔记列表不给链接,拿笔记编号取一次详情就有了。
没有浏览量
笔记不带浏览量,平台本身不给。
蒲公英博主编号
蒲公英的接口用蒲公英博主编号,从蒲公英博主搜索里取。这个搜索按博主写的内容匹配,没有博主对得上的词,也会给出沾边的博主,不返回空。

关于小红书 API 的常见问题

回答从简,细节在各接口的页面。

小红书 API 怎么收费?

按次收费,没有订阅。一次 $0.0200 到 $0.0400,每个接口的页面写明自己的价格。拿到数据才扣费,失败不收。

需要小红书账号或 Cookie 吗?

不需要。你只拿一把 DataXAPI 的 Key:不用登录小红书,不用 Cookie,也不用养设备。接口只返回公开可见的数据。

数据是实时的吗?

每次调用都当场去小红书取,meta.fetched_at 写明取到的时间。小红书热点:榜单是每 10 分钟刷新一次的快照。结果保留 24 小时,带同一个 Idempotency-Key 重试不会再扣一次。

空结果收费吗?

列表返回空结果时照价收费:搜索已经执行了。读单个对象而对象不存在时返回 not_found,收不收费看接口页。

小红书改版了怎么办?

调用失败不管什么原因都不扣费。被暂停的接口返回 capability_paused,同样不扣费;GET /v1/catalog/status 写着现在哪些能用。

相关

一把 Key 调小红书。

免费试用:按 $0.0200 一次,最多可调 5 次,不用绑卡。 不用登录小红书,不用 Cookie,没有订阅。失败不收费。

免费开始