一、接口调用前提

1. 注册与认证
   • 需注册某书开放平台/第三方开放平台账号，创建应用并获取 access_token（授权令牌）。
   • 部分操作需通过企业认证并申请高级权限。
2. 接口限制
   • 调用频率受限（如每分钟100次），超限需申请提额。
   • 返回数据可能受用户隐私设置影响（如作者关闭公开权限则无法获取）。

二、接口调用方式

请求头

json{"Authorization": "Bearer {access_token}","Content-Type": "application/json"}

必填参数

可选参数

三、返回数据结构（JSON）

json{"code": 200,"message": "success","data": {"note_id": "649c46ab000000002702ad36","title": "春季美妆新品推荐","content": "<p>今天分享几款超火的美妆新品...</p>","images": ["https://example.com/image1.jpg","https://example.com/image2.jpg"],"videos": [{"type": "video","url": "https://example.com/video.mp4","cover": "https://example.com/cover.jpg"}],"tags": ["美妆", "新品"],"like_count": 1024,"comment_count": 256,"favorite_count": 512,"share_count": 128,"author": {"user_id": "987654321","nickname": "美妆达人","avatar": "https://example.com/avatar.jpg","follower_count": 100000},"publish_time": "2025-04-25T14:30:00Z","location": {"name": "上海","latitude": 31.2304,"longitude": 121.4737}}}

四、错误处理

常见错误码

排查步骤

1. 检查 access_token有效性及权限范围。
2. 确认 note_id格式正确（通常为24位字母数字组合）。
3. 使用Postman等工具测试接口连通性。
4. 查看返回的 message字段获取具体错误原因。

五、调用示例（Python）

pythonimport requestsdef get_note_details(note_id, access_token):url = f"https://api.xiaohongshu.com/v1/notes/{note_id}"headers = {"Authorization": f"Bearer {access_token}","Content-Type": "application/json"}try:response = requests.get(url, headers=headers)response.raise_for_status()data = response.json()if data.get("code") == 200:return data["data"]else:print(f"API错误: {data.get('message')}")except requests.exceptions.RequestException as e:print(f"请求失败: {e}")# 使用示例note_id = "649c46ab000000002702ad36"access_token = "YOUR_ACCESS_TOKEN"details = get_note_details(note_id, access_token)if details:print(f"标题: {details['title']}")print(f"点赞数: {details['like_count']}")print(f"作者: {details['author']['nickname']}")

六、注意事项

1. 合规性
   • 禁止爬取用户隐私数据（如手机号、地址）。
   • 需遵守《小红书开放平台协议》，禁止商业化滥用数据。
2. 数据解析
   • content字段可能包含HTML标签，需用 BeautifulSoup等库解析。
   • 图片URL需处理防盗链（部分链接需添加 Referer头）。
3. 扩展功能
   • 结合搜索API可实现批量获取笔记（需分页参数 page和 size）。
   • 通过 tags字段可构建内容分类标签体系。

如需更高级功能（如评论抓取），需联系小红书商务团队申请特殊权限。