xiaohongshu.com APIwww.xiaohongshu.com ↗
Access Xiaohongshu note content and user profiles via API. Returns post text, images, video, tags, engagement stats, follower counts, and bios.
curl -X GET 'https://api.parse.bot/scraper/112e2db4-437f-4511-96f5-f0f62d23a010/get_note_detail?note_id=%3Cnote_id%3E&xsec_token=%3Cxsec_token%3E' \ -H 'X-API-Key: $PARSE_API_KEY'
Get full note/post content by note ID. Returns title, description, images, video, tags, user info, and interaction stats (likes, collects, comments, shares). Requires both note_id and xsec_token. The xsec_token is a per-note security token that cannot be reused across different notes — each note requires its own token obtained from feed or share links for that specific note.
| Param | Type | Description |
|---|---|---|
| note_idrequired | string | The note/post ID (e.g., '<note_id>') |
| xsec_tokenrequired | string | Per-note security token that is unique to each note and cannot be reused across different notes. Obtained from feed data or share links for the specific note (e.g., '<xsec_token>'). |
{
"type": "object",
"fields": {
"tags": "array of {id, name, type}",
"time": "integer (timestamp ms)",
"type": "string (normal/video)",
"user": "object with user_id, nickname, avatar",
"title": "string",
"video": "object with duration, url, format, width, height (only for video notes)",
"images": "array of {url, width, height, file_id}",
"note_id": "string",
"description": "string",
"ip_location": "string",
"interact_info": "object with liked_count, collected_count, comment_count, share_count (all strings)",
"last_update_time": "integer (timestamp ms)"
},
"sample": {
"data": {
"tags": [],
"time": 1679484765000,
"type": "video",
"user": {
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/66bf6fd9abe1e6168f27f26e.jpg",
"user_id": "5bb08087e617cb0001a9b4a6",
"nickname": "郭嘉峰"
},
"title": "各地游客打卡be like",
"video": {
"url": "http://sns-video-zl.xhscdn.com/stream/110/258/01e41ae711b653ba01037003870919b806_258.mp4?sign=70524b715bd569fb09210c187da2c0a2&t=6a0118d2",
"width": 720,
"format": "h264",
"height": 1280,
"duration": 86
},
"images": [
{
"url": "http://sns-webpic-qc.xhscdn.com/202605071946/5af3c1cb90a5c0e6a996a5e0c0b7c8d6/spectrum/1000g0k027nrrnbkfs0004b81gm08fd56asess3o!nd_dft_wlteh_jpg_3",
"width": 1080,
"height": 1440,
"file_id": ""
}
],
"note_id": "641ae75d0000000013031c27",
"description": "",
"ip_location": "",
"interact_info": {
"liked_count": "3.5万",
"share_count": "1108",
"comment_count": "529",
"collected_count": "2227"
},
"last_update_time": 1679484766000
},
"status": "success"
}
}About the xiaohongshu.com API
The Xiaohongshu API provides two endpoints for retrieving public content from China's Little Red Book platform: get_note_detail and get_user_profile. A single note detail response surfaces 11 fields including title, description, images, video metadata, interaction stats (likes, collects, comments, shares), tags, and the author's location. The user profile endpoint returns follower and following counts, bio, avatar, gender, and profile tags.
Note Detail
The get_note_detail endpoint accepts two required parameters: note_id and xsec_token. The xsec_token is a per-note security token tied specifically to the note being requested — it is not reusable across different notes and must be obtained separately for each one. The response distinguishes between note types via the type field (normal or video). For video notes, a video object is included with duration, url, format, width, and height. Image notes return an images array of objects with url, width, height, and file_id. Both types include tags (each with id, name, and type), a time timestamp in milliseconds, and an ip_location string indicating the poster's reported region.
User Profile
The get_user_profile endpoint takes a user_id and returns a profile object containing nickname, description (bio), avatar URL, gender (0 for male, 1 for female), red_id (the platform's human-readable username), follows and fans counts as strings, ip_location, and a tags array of profile tags that may include type, name, and icon fields. Follower and following counts are returned as strings rather than integers, consistent with how the platform displays large numbers.
Coverage and Constraints
Both endpoints cover publicly accessible content. Search functionality and post creation are not available through this API. The xsec_token requirement for get_note_detail means callers must supply a valid token per note — tokens cannot be generated client-side or reused. Note IDs and their corresponding tokens are typically found in note URLs shared from the platform.
- Tracking engagement metrics (likes, collects, comments) on specific Xiaohongshu notes over time
- Extracting product-related tags and descriptions from Little Red Book posts for market research
- Building creator profiles by combining follower counts, bio text, and avatar from get_user_profile
- Aggregating image and video assets from notes by type for content analysis
- Monitoring ip_location fields to map regional content distribution across notes
- Enriching influencer databases with Xiaohongshu fan counts, follows, and profile tags
- Identifying trending topic tags on notes by collecting the tags array across multiple note IDs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Xiaohongshu have an official developer API?+
What does get_note_detail return for video posts versus image posts?+
video object with duration, url, format, width, and height. For standard image notes (type: 'normal'), that object is absent and the images array contains one or more objects with url, width, height, and file_id. Both types return the same core fields: title, description, tags, time, user, ip_location, and interaction stats.Why does get_note_detail require an xsec_token in addition to the note_id?+
xsec_token paired with each note_id; a mismatched or reused token will not return data.Does the API return comment content or a list of commenters on a note?+
get_note_detail endpoint returns a comment count as part of the interaction stats, but individual comment text and commenter details are not included in the response. The API covers note-level content and aggregate counts. You can fork it on Parse and revise to add a comment-listing endpoint if that data is needed.Is search — finding notes by keyword or hashtag — available through this API?+
get_note_detail and profile lookup by ID via get_user_profile. You can fork it on Parse and revise to add a search endpoint that accepts keyword or tag inputs.