一、核心接口(2026 最新)
1)图文笔记详情(最常用)
- 接口名:
smallredbook.item_get - 方法:GET/POST
- 功能:图文笔记全量数据(标题 / 正文 / 9 图 / 标签 / 互动 / 作者 / 关联商品)
2)视频笔记详情(带货必备)
- 接口名:
smallredbook.item_get_video - 请求地址:
https://api-gw.onebound.cn/smallredbook/item_get_video - 功能:无水印视频直链 + 封面 + 文案 + 商品卡片
二、前置准备(30 秒搞定)
- 创建应用,拿到 key / secret(调用凭证)
- 提取小红书笔记 ID(num_iid):
- 链接示例:
https://www.xiaohongshu.com/explore/661234567890abcdef123456 - num_iid =
661234567890abcdef123456(链接末尾串)
- 链接示例:
三、直接调用(复制即用)
✅ 图文笔记(item_get)
http
POST https://api-gw.onebound.cn/smallredbook/item_get
Content-Type: application/json
{
"key": "你的OpenClaw Key",
"secret": "你的OpenClaw Secret",
"num_iid": "小红书笔记ID"
}
✅ 视频笔记(item_get_video)
http
POST https://api-gw.onebound.cn/smallredbook/item_get_video
Content-Type: application/json
{
"key": "你的OpenClaw Key",
"secret": "你的OpenClaw Secret",
"num_iid": "小红书视频笔记ID"
}
四、返回数据(全字段,直接用)
1)基础信息
- 标题、正文、发布时间、标签(话题)、定位
- 作者:昵称、头像、ID、粉丝数
- 互动:点赞、收藏、评论、转发数
2)多媒体
- 图文:9 张高清原图 URL(无水印)
- 视频:无水印直链、封面图、时长、分辨率
3)电商带货(关键)
- 关联商品:标题、价格、主图、购买链接、店铺名
- 优惠券、团购价、库存状态
4)示例 JSON(精简)
json
{
"status": 200,
"result": {
"title": "夏日防晒测评",
"content": "质地清爽不油腻...",
"images": ["url1", "url2", "..."],
"video_url": "https://xxx.mp4",
"likes": 12345,
"products": [{"title": "防晒霜", "price": "89"}]
}
}
五、Python 代码(直接运行)
python
运行
import requests
API_URL = "https://api-gw.onebound.cn/smallredbook/item_get"
KEY = "你的Key"
SECRET = "你的Secret"
NUM_IID = "661234567890abcdef123456" # 替换成你的笔记ID
data = {"key": KEY, "secret": SECRET, "num_iid": NUM_IID}
resp = requests.post(API_URL, json=data)
res = resp.json()
if res["status"] == 200:
item = res["result"]
print("标题:", item["title"])
print("正文:", item["content"][:100] + "...")
print("图片数:", len(item["images"]))
print("点赞:", item["likes"])
else:
print("错误:", res["message"])
六、优势(对比官方 / 爬虫)
- ✅ 免资质:无需小红书企业认证 / 开发者账号
- ✅ 免签名:不用处理复杂加密签名
- ✅ 全数据:图片 / 视频 / 文案 / 商品 / 互动一次拿到
- ✅ 稳定:高并发、防封禁、不限 IP
- ✅ 低成本:按调用量计费,有免费额度