给 AI
看 Markdown 版在 ChatGPT 里打开在 Claude 里打开

小红书笔记详情 API

按笔记编号或链接取一篇小红书笔记：标题、正文、作者、互动数、图片。每次取一个对象；$0.0200 一次。出错、超时、对象不存在都不收费。

GEThttps://api.dataxapi.com/v1/xiaohongshu/notes/get
也叫笔记内容小红书帖子英文名：Xiaohongshu note detail API
id 就在链接里：xiaohongshu.com/explore/<id>。也可以把整条链接传给 url。
价格$0.0200约 ¥0.14/ 次 · 出错和超时不收费
返回1 个对象一个内容对象
数据源出错时自动重试同一条线路再试，有备用线路就切过去；不收费
状态当前状态每天用真实调用检测 · 已记录 4 天

试一次

改一个值，右边的请求跟着变。
运行 · $0.0200

登录后运行，用你自己的余额。 这个接口新用户可免费试用 5 次。

以前用的是 POST /v2/xiaohongshu/notes/detail？已经换成这个地址。 旧接口改了什么

2026-10-10 12:46 UTC 录下的真实返回，这里是前 8 行。
字段值
typeimage
langzh-Hans
published_at2026-10-09 01:00 UTC
metrics.likes927
metrics.comments122
metrics.shares256
metrics.favorites59
is_pinnedfalse
curl -G "https://api.dataxapi.com/v1/xiaohongshu/notes/get" \
  --data-urlencode "id=6ac76250000000000a021233" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
{
  "code": "ok",
  "request_id": "f71a940b-5096-4ae5-8062-eb8542c0840d",
  "data": {
    "item": {
      "id": "64e3473100000000d2df6d97",
      "url": "https://www.xiaohongshu.com/explore/64e3473100000000d2df6d97",
      "type": "image",
      "title": "周末露营装备清单，新手照着买就行",
      "text": "周末露营｜第一次尝试就爱上了，清单放评论区",
      "lang": "zh-Hans",
      "published_at": "2026-10-09T01:00:34.000Z",
      "author": {
        "id": "61a2711e000000007b58eefa",
        "username": "aya_living",
        "name": "认真生活的阿雅",
        "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/61177eaf00000000f2be6e0c.jpg"
      },
      "metrics": {
        "likes": 927,
        "comments": 122,
        "shares": 256,
        "favorites": 59
      },
      "images": [
        "https://sns-webpic-qc.xhscdn.com/20261013/beb7fc7264c0ffc27302!nd_dft_wlteh_webp_3",
        "https://sns-webpic-qc.xhscdn.com/20261012/355cf1169dfdc76d1395!nd_dft_wlteh_webp_3",
        // … 另有 7 条
      ],
      "hashtags": [
        "户外生活",
        "好物分享",
        // … 另有 3 条
      ],
      "mentions": [],
      "is_pinned": false
    }
  },
  "warnings": [],
  "meta": {
    "capability": "xiaohongshu.notes.get",
    "result_status": "complete",
    "fetched_at": "2026-10-10T12:46:15.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "metrics.views": "platform",
      "metrics.reposts": "platform",
      "author.verified": "capability",
      "author.followers": "capability",
      "mentions.username": "platform",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

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

返回大小：标准档 3.6 KB（精简 1.4 KB，完整 3.6 KB）。

这份示例的 JSON 文件

curl -G "https://api.dataxapi.com/v1/xiaohongshu/notes/get" \
  --data-urlencode "id=6ac76250000000000a021233" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.xiaohongshu.notes.get(id="6ac76250000000000a021233")
print(result["data"]["item"])
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.xiaohongshu.notes.get({ id: "6ac76250000000000a021233" });
console.log(result.data.item);
dataxapi call xiaohongshu.notes.get id=6ac76250000000000a021233
{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

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

参数

id文本id、url 里给且只给一个

笔记编号，24 位十六进制。手里只有链接或分享文案时，填到 url。示例：6ac76250000000000a021233。

url文本id、url 里给且只给一个

笔记链接，原样粘贴即可：浏览器地址栏里的 https://www.xiaohongshu.com/explore/…、网页版分享出的 https://www.xiaohongshu.com/discovery/item/…（后面带 xsec_token 等参数也行）、含这类链接的整段分享文案，或 App 复制出来的 xhslink.com 短链接（连同分享文案一起贴也行）。短链接由我们打开一次，看它跳到哪篇笔记；打不开时请贴完整的笔记链接或笔记编号。示例：https://www.xiaohongshu.com/explore/6ac76250000000000a021233?xsec_token=ABx1y2z3。长链接：https://www.xiaohongshu.com/explore/6ac76250000000000a021233?xsec_token=ABx1y2z3。带链接的分享文案：周末咖啡探店合集 https://www.xiaohongshu.com/discovery/item/6ac76250000000000a021233?xsec_token=ABx1y2z3 复制这段文字，打开小红书查看。

view文本

返回档位。三档价格相同。取值：compact、standard（默认）、full。

fields文本列表

只要这些字段。按路径写，例如 author.name。

已知限制

返回字段

data.item 是一个内容对象。稳定：字段只增不改。

id文本compact

编号，可原样传给取详情的接口

url链接compact

能直接打开的链接

type文本compact

内容形态videoimagetextarticle

title文本compact

标题

text文本compact

正文

长文本：精简档只保留前 500 个字符，并在 warnings 里写明。

lang文本standard

正文的语言

展开全部 35 个字段 →
published_at时间compact

发布时间

author对象compact

作者

author.id文本compact

作者的账号编号

author.username文本compact

作者的账号名

author.name文本compact

作者的显示名

author.avatar_url链接standard

作者头像

author.verified是否standard这个接口不提供

作者是否认证

author.followers整数standard这个接口不提供

作者的粉丝数

metrics对象compact

互动数

metrics.likes整数compact

点赞数

metrics.comments整数compact

评论数

metrics.shares整数compact

分享数

metrics.favorites整数compact

收藏数

metrics.views整数compact平台没有

播放或阅读数

metrics.reposts整数compact平台没有

转发数

images链接列表standard

图片地址

hashtags文本列表standard

话题标签，不带 #

mentions对象列表standard

正文里提及的账号

mentions[].id文本standard

账号编号

mentions[].username文本standard平台没有

账号名

mentions[].name文本standard

显示名

is_pinned是否standard

是否被作者置顶

post_id文本compact平台没有

它回复的那条内容所在的主帖编号；不是回复则为 null

parent_id文本compact平台没有

它直接回复的那一条的编号；不是回复则为 null

root_id文本compact平台没有

所在回复串里第一层那一条的编号

ext.ip_location文本full

平台显示的 IP 属地

approximate对象列表compact

这一条里哪些数是约数或下限；都是准确值时不出现

approximate[].field文本compact

字段的路径，如 metrics.views

approximate[].kind文本compact

约数，还是下限approximatelower_bound

每条数据的典型体积：compact 903 B、standard 3.0 KB、full 3.1 KB（按 2026-10-10 12:46 UTC 录下的那次返回量的）。

这个接口给不了的

author.verified这个接口不提供
author.followers这个接口不提供
metrics.views平台没有
metrics.reposts平台没有
mentions[].username平台没有
post_id平台没有
parent_id平台没有
root_id平台没有

什么时候收费

返回了数据$0.0200，每次调用收一次
对象不存在（404）不收费
参数不合法、我们或数据来源出错、超时不收费
情况收费
单次最高扣费$0.0200 (带 X-Max-Price 可以设自己的上限，超过就不执行)

价格读取于 2026-10-21 09:10 UTC，按价目版本 2，2026-10-17 11:00 UTC 起生效；在 Playground 里运行前会再读一次当前价格。

对象不存在时

返回 404 not_found，不收费。reason 写明是哪一种：not_found（不存在）或 private_or_deleted（私密或已删除）。

常见报错

这个接口会返回的错误码；所有接口共有的见完整列表。

状态码代码含义是否扣费
400invalid_params参数不合法能否重试：改了再试未扣费
402insufficient_balance余额不足能否重试：改了再试未扣费
404not_found对象不存在、私密或已删除能否重试：不能未扣费
502upstream_failed数据来源出错能否重试：能未扣费
504timeout没有在时限内取到数据，可以用同一个幂等键重试能否重试：能未扣费

全部错误码 →

常见问题

小红书笔记详情 API 多少钱？

$0.0200 一次。单次最高扣费 $0.0200。

什么情况下不收费？

出错、超时、对象不存在都不收费。

对象不存在会怎样？

返回 404 not_found，不收费。reason 写明是哪一种：not_found（不存在）或 private_or_deleted（私密或已删除）。

同一件事的其他平台

B站视频详情$0.0020抖音视频详情$0.0020快手作品详情$0.0020Telegram 单条消息$0.0020X 帖子详情$0.0003Facebook 帖子详情$0.0020LinkedIn 帖子详情$0.0020Threads 帖子详情$0.0020Instagram 帖子详情$0.0020TikTok 视频详情$0.0020微博详情$0.0020YouTube 视频详情$0.0020微信视频号作品详情$0.0200微信公众号文章详情$0.0200Reddit 帖子详情$0.0020知乎回答详情$0.0020知乎文章详情$0.0020知乎想法详情$0.0020知乎问题详情$0.0020Pinterest 图钉详情$0.0020

小红书的全部 21 个接口

小红书的接口
小红书图片搜索$0.0200小红书笔记详情$0.0200小红书评论回复$0.0200小红书笔记评论$0.0200小红书笔记搜索$0.0200小红书话题笔记$0.0200小红书话题详情$0.0200小红书热点$0.0200小红书用户资料$0.0200小红书用户笔记$0.0200小红书用户搜索$0.0200
小红书蒲公英的接口
小红书蒲公英关键词逐日搜索指数$0.0400小红书蒲公英关联词$0.0400小红书蒲公英博主搜索$0.0400小红书蒲公英博主详情$0.0400小红书蒲公英博主粉丝画像$0.0400小红书蒲公英博主数据表现$0.0400小红书蒲公英博主笔记$0.0400
小红书商城的接口
小红书商品详情$0.0200小红书商品评价$0.0200小红书商品搜索$0.0200

在你的 AI 里用它

复制这段提示词

你的 API Key 已经写在里面，不用再配置什么。

读 https://dataxapi.com/agents.md，在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_…，之后所有 DataXAPI 的调用都用它。
登录后带着你的 Key 复制

还没有账户？注册只要一个邮箱，不用绑卡，失败的调用不收费。

然后粘贴

贴给你的 agent

它会去读提示词指向的那一页，自己接好。

你的 agent
读 https://dataxapi.com/agents.md，在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_••••，之后所有 DataXAPI 的调用都用它。
DataXAPI 已连接 · 5 个工具可用
现在试试

现在问点什么

用下面任意一句，或者用自己的话问。

读一下 https://dataxapi.com/zh/apis/xiaohongshu/notes/get.md，然后帮我用 DataXAPI 的接口 xiaohongshu.notes.get（小红书笔记详情）。
想自己手动配置？
dataxapi setup给这台电脑上的 AI 代理（Claude Code、Codex、Cursor）装好 DataXAPI 的 MCP 服务和基础技能。Key 从环境变量 DATAXAPI_API_KEY 读，不写进任何文件。MCP 服务地址：https://api.dataxapi.com/mcp。你的客户端要填的配置在本页请求示例的“MCP”页签里；接好后让你的 AI 调用 xiaohongshu.notes.get。其他客户端 →
带着这页去问会把 Markdown 版带过去
在 ChatGPT 里打开在 Claude 里打开其他客户端 →
给 AI 的说明调用它要知道的全部，纯文本
展开全文
使用 DataXAPI 的接口 xiaohongshu.notes.get（小红书笔记详情）。按笔记编号或链接取一篇小红书笔记：标题、正文、作者、互动数、图片。
用 GET 请求 https://api.dataxapi.com/v1/xiaohongshu/notes/get，带请求头 "Authorization: Bearer $DATAXAPI_API_KEY"。Key 从环境变量 DATAXAPI_API_KEY 读，不要写进代码。
参数：
- id：笔记编号，24 位十六进制。手里只有链接或分享文案时，填到 url。示例：6ac76250000000000a021233。
- url：笔记链接，原样粘贴即可：浏览器地址栏里的 https://www.xiaohongshu.com/explore/…、网页版分享出的 https://www.xiaohongshu.com/discovery/item/…（后面带 xsec_token 等参数也行）、含这类链接的整段分享文案，或 App 复制出来的 xhslink.com 短链接（连同分享文案一起贴也行）。短链接由我们打开一次，看它跳到哪篇笔记；打不开时请贴完整的笔记链接或笔记编号。示例：https://www.xiaohongshu.com/explore/6ac76250000000000a021233?xsec_token=ABx1y2z3。长链接：https://www.xiaohongshu.com/explore/6ac76250000000000a021233?xsec_token=ABx1y2z3。带链接的分享文案：周末咖啡探店合集 https://www.xiaohongshu.com/discovery/item/6ac76250000000000a021233?xsec_token=ABx1y2z3 复制这段文字，打开小红书查看。
- view：返回档位。三档价格相同。取值：compact、standard（默认）、full。
- fields：只要这些字段。按路径写，例如 author.name。
价格：$0.0200 一次。出错、超时、对象不存在都不收费。
返回 JSON：data.item 是内容；meta.billing.amount 是这次调用的扣费。
示例：
curl -G "https://api.dataxapi.com/v1/xiaohongshu/notes/get" \
  --data-urlencode "id=6ac76250000000000a021233" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
完整说明（Markdown）：https://dataxapi.com/zh/apis/xiaohongshu/notes/get.md

名称和编号

英文名
Xiaohongshu note detail API
接口编号
xiaohongshu.notes.get
地址
GET /v1/xiaohongshu/notes/get
最后核对于 2026-10-21 09:10 UTC。查看 Markdown 版openapi.jsonllms.txt

一把 Key，开始用。

21 个平台 207 个接口，一次 $0.0003 起。出错和超时不收费。

免费开始