小红书 API 使用手册
调用优先级
App V2（推荐） > App V1（兜底） > Web V3（第三备选）
⚠️ Web V2 和 Web 旧版系列已不推荐使用，请勿在新项目中调用，已有项目请尽快迁移。
- API 文档（Swagger UI）：https://api.tikhub.io/#/Xiaohongshu-App-V2-API
- API 文档（Apifox）：https://docs.tikhub.io/420136391e0
注意：请前往 TikHub 用户后台编辑您的 API Key 权限，App V2 的 scope 为
/api/v1/xiaohongshu/app_v2/，Web V3 的 scope 为/api/v1/xiaohongshu/web_v3/。
系列说明
| 系列 | 状态 | 说明 |
|---|---|---|
| App V2 | ✅ 推荐 | 最新版本，最为稳定，功能最全，优先使用 |
| App V1 | ✅ 可用 | App V2 不可用时的兜底方案 |
| Web V3 | ✅ 可用 | 第三备选方案，App V1 不可用时使用 |
| Web V2 / Web 旧版 | ❌ 已弃用 | 稳定性不再保证，请勿使用 |
功能接口速查
1. 笔记详情
App V2（首选）
| 接口 | Endpoint |
|---|---|
| 获取图文笔记详情 | GET /api/v1/xiaohongshu/app_v2/get_image_note_detail |
| 获取视频笔记详情 | GET /api/v1/xiaohongshu/app_v2/get_video_note_detail |
App V1（兜底）
| 接口 | Endpoint |
|---|---|
| 获取笔记信息 | GET /api/v1/xiaohongshu/app/get_note_info |
| 获取视频笔记信息 | GET /api/v1/xiaohongshu/app/get_video_note_info |
Web V3（第三备选）
| 接口 | Endpoint |
|---|---|
| 获取笔记详情 | GET /api/v1/xiaohongshu/web_v3/fetch_note_detail |
2. 笔记评论
App V2（首选）
| 接口 | Endpoint |
|---|---|
| 获取笔记评论 | GET /api/v1/xiaohongshu/app_v2/get_note_comments |
| 获取笔记子评论 | GET /api/v1/xiaohongshu/app_v2/get_note_sub_comments |
App V1（兜底）
| 接口 | Endpoint |
|---|---|
| 获取笔记评论 | GET /api/v1/xiaohongshu/app/get_note_comments |
| 获取子评论 | GET /api/v1/xiaohongshu/app/get_sub_comments |
Web V3（第三备选）
| 接口 | Endpoint |
|---|---|
| 获取笔记评论 | GET /api/v1/xiaohongshu/web_v3/fetch_note_comments |
| 获取子评论 | GET /api/v1/xiaohongshu/web_v3/fetch_sub_comments |
3. 用户信息
App V2（首选）
| 接口 | Endpoint |
|---|---|
| 获取用户信息 | GET /api/v1/xiaohongshu/app_v2/get_user_info |
App V1（兜底）
| 接口 | Endpoint |
|---|---|
| 获取用户信息 | GET /api/v1/xiaohongshu/app/get_user_info |
Web V3（第三备选）
| 接口 | Endpoint |
|---|---|
| 获取用户信息 | GET /api/v1/xiaohongshu/web_v3/fetch_user_info |
4. 用户笔记列表
App V2（首选）
| 接口 | Endpoint |
|---|---|
| 获取用户发布笔记 | GET /api/v1/xiaohongshu/app_v2/get_user_posted_notes |
| 获取用户收藏笔记 | GET /api/v1/xiaohongshu/app_v2/get_user_faved_notes |
App V1（兜底）
| 接口 | Endpoint |
|---|---|
| 获取用户笔记 | GET /api/v1/xiaohongshu/app/get_user_notes |
Web V3（第三备选）
| 接口 | Endpoint |
|---|---|
| 获取用户笔记列表 | GET /api/v1/xiaohongshu/web_v3/fetch_user_notes |
5. 搜索
App V2（首选）
| 接口 | Endpoint |
|---|---|
| 搜索笔记 | GET /api/v1/xiaohongshu/app_v2/search_notes |
| 搜索用户 | GET /api/v1/xiaohongshu/app_v2/search_users |
| 搜索图片 | GET /api/v1/xiaohongshu/app_v2/search_images |
| 搜索商品 | GET /api/v1/xiaohongshu/app_v2/search_products |
| 搜索群组 | GET /api/v1/xiaohongshu/app_v2/search_groups |
App V1（兜底）
| 接口 | Endpoint |
|---|---|
| 搜索笔记 | GET /api/v1/xiaohongshu/app/search_notes |
| 搜索笔记 V2 | GET /api/v1/xiaohongshu/app/search_notes_v2 |
| 搜索用户 | GET /api/v1/xiaohongshu/app/search_users |
Web V3（第三备选）
| 接口 | Endpoint |
|---|---|
| 搜索笔记 | GET /api/v1/xiaohongshu/web_v3/fetch_search_notes |
| 搜索用户 | GET /api/v1/xiaohongshu/web_v3/fetch_search_users |
| 获取搜索联想词 | GET /api/v1/xiaohongshu/web_v3/fetch_search_suggest |
| 获取热搜词 | GET /api/v1/xiaohongshu/web_v3/fetch_trending |
6. 首页 Feed
Web V3（可用）
| 接口 | Endpoint |
|---|---|
| 获取首页推荐 | GET /api/v1/xiaohongshu/web_v3/fetch_homefeed |
| 获取首页分类列表 | GET /api/v1/xiaohongshu/web_v3/fetch_homefeed_categories |
7. 话题
**Ap