Xiaohongshu API User Manual
Call priority
App V2 (recommended) > App V1 (all in all) > Web V3 (third alternative)
⚠️ Web V2 and the old Web series are no longer recommended. Please do not call them in new projects. Please migrate existing projects as soon as possible.
- API documentation (Swagger UI): https://api.tikhub.io/#/Xiaohongshu-App-V2-API
- API documentation (Apifox): https://docs.tikhub.io/420136391e0
Note: Please go to the TikHub user backend to edit your API Key permissions. The scope of App V2 is
/api/v1/xiaohongshu/app_v2/, and the scope of Web V3 is/api/v1/xiaohongshu/web_v3/.
Series Description
| Series | Status | Description |
|---|---|---|
| App V2 | ✅ Recommended | The latest version, the most stable, the most complete functions, priority use |
| App V1 | ✅ Available | A fallback solution when App V2 is unavailable |
| Web V3 | ✅ Available | Third alternative, used when App V1 is not available |
| Web V2 / Web Old Version | ❌ Deprecated | Stability is no longer guaranteed, please do not use |
Function interface quick check
1. Note details
App V2 (preferred)
| Interface | Endpoint |
|---|---|
| Get graphic note details | GET /api/v1/xiaohongshu/app_v2/get_image_note_detail |
| Get video note details | GET /api/v1/xiaohongshu/app_v2/get_video_note_detail |
App V1 (all in all)
| Interface | Endpoint |
|---|---|
| Get note information | GET /api/v1/xiaohongshu/app/get_note_info |
| Get video note information | GET /api/v1/xiaohongshu/app/get_video_note_info |
Web V3 (Third Alternative)
| Interface | Endpoint |
|---|---|
| Get note details | GET /api/v1/xiaohongshu/web_v3/fetch_note_detail |
2. Note comments
App V2 (preferred)
| Interface | Endpoint |
|---|---|
| Get note comments | GET /api/v1/xiaohongshu/app_v2/get_note_comments |
| Get note sub-comments | GET /api/v1/xiaohongshu/app_v2/get_note_sub_comments |
App V1 (all in all)
| Interface | Endpoint |
|---|---|
| Get note comments | GET /api/v1/xiaohongshu/app/get_note_comments |
| Get child comments | GET /api/v1/xiaohongshu/app/get_sub_comments |
Web V3 (Third Alternative)
| Interface | Endpoint |
|---|---|
| Get note comments | GET /api/v1/xiaohongshu/web_v3/fetch_note_comments |
| Get child comments | GET /api/v1/xiaohongshu/web_v3/fetch_sub_comments |
3. User information
App V2 (preferred)
| Interface | Endpoint |
|---|---|
| Get user information | GET /api/v1/xiaohongshu/app_v2/get_user_info |
App V1 (all in all)
| Interface | Endpoint |
|---|---|
| Get user information | GET /api/v1/xiaohongshu/app/get_user_info |
Web V3 (Third Alternative)
| Interface | Endpoint |
|---|---|
| Get user information | GET /api/v1/xiaohongshu/web_v3/fetch_user_info |
4. User note list
App V2 (preferred)
| Interface | Endpoint |
|---|---|
| Get user published notes | GET /api/v1/xiaohongshu/app_v2/get_user_posted_notes |
| Get user collection notes | GET /api/v1/xiaohongshu/app_v2/get_user_faved_notes |
App V1 (all in all)
| Interface | Endpoint |
|---|---|
| Get user notes | GET /api/v1/xiaohongshu/app/get_user_notes |
Web V3 (Third Alternative)
| Interface | Endpoint |
|---|---|
| Get user note list | GET /api/v1/xiaohongshu/web_v3/fetch_user_notes |
5. Search
App V2 (preferred)
| Interface | Endpoint |
|---|---|
| Search notes | GET /api/v1/xiaohongshu/app_v2/search_notes |
| Search for users | GET /api/v1/xiaohongshu/app_v2/search_users |
| Search for images | GET /api/v1/xiaohongshu/app_v2/search_images |
| Search for products | GET /api/v1/xiaohongshu/app_v2/search_products |
| Search Group | GET /api/v1/xiaohongshu/app_v2/search_groups |
App V1 (all in all)
| Interface | Endpoint |
|---|---|
| Search notes | GET /api/v1/xiaohongshu/app/search_notes |
| Search Notes V2 | GET /api/v1/xiaohongshu/app/search_notes_v2 |
| Search for users | GET /api/v1/xiaohongshu/app/search_users |
Web V3 (Third Alternative)
| Interface | Endpoint |
|---|---|
| Search notes | GET /api/v1/xiaohongshu/web_v3/fetch_search_notes |
| Search for users | GET /api/v1/xiaohongshu/web_v3/fetch_search_users |
| Get search association words | GET /api/v1/xiaohongshu/web_v3/fetch_search_suggest |
| Get hot search words | GET /api/v1/xiaohongshu/web_v3/fetch_trending |
6. Home Feed
Web V3 (available)
| Interface | Endpoint |
|---|---|
| Get homepage recommendations | GET /api/v1/xiaohongshu/web_v3/fetch_homefeed |
| Get the homepage category list | GET /api/v1/xiaohongshu/web_v3/fetch_homefeed_categories |
7. Topic
**Ap