Xiaohongshu profile
Profile + first-page note feed for a Xiaohongshu (小红书 / RED) user.
Pass the canonical 24-hex user_id (the id in
xiaohongshu.com/user/profile/<id>) OR a full profile url. Exactly one is
required. The note feed is read from the page's server-rendered state, so
only the first page is returned (no deep pagination, see endpoint docs).
A note page is addressed by a per-note token that is part of the note's own URL. Pass the full URL you were given rather than just the note id.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 5.8s.
Authorization
ApiKeyAuth Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/xiaohongshu-profile" \ -H "Content-Type: application/json" \ -d '{ "user_id": "59b6c38050c4b43659412862" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "notes": [ { "caption": "普通家庭，存钱真好。", "comment_count": null, "comments": [], "creator_handle": "hola5427", "hashtags": [], "is_pinned": false, "is_video": true, "like_count": 2178, "note_type": "video", "post_id": null, "post_url": null, "profile_picture_url": "https://sns-avatar-qc.xhscdn.com/avatar/61aa425e1e37340dbd1a8ecc.jpg", "save_count": null, "share_count": null, "thumbnail_height": 3033, "thumbnail_url": "https://sns-webpic-qc.xhscdn.com/202608232002/df57be1481a30ff142480f5c67450d53/spectrum/1040g34o3244oathd741049plan1o0a32vpn373o!nc_n_webp_mw_1", "thumbnail_width": 2274, "upload_timestamp": null, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": null, "xsec_token": "ABhu_Cqz8_LewlXka4tu0shXvdf2H8lDyODA4lyaWl9QU=" }, { "caption": "普通人最低成本的自我调节——出门", "comment_count": null, "comments": [], "creator_handle": "hola5427", "hashtags": [], "is_pinned": false, "is_video": true, "like_count": 1841, "note_type": "video", "post_id": null, "post_url": null, "profile_picture_url": "https://sns-avatar-qc.xhscdn.com/avatar/61aa425e1e37340dbd1a8ecc.jpg", "save_count": null, "share_count": null, "thumbnail_height": 3033, "thumbnail_url": "https://sns-webpic-qc.xhscdn.com/202608232002/a5a91163a193997e818a9b6085531fd8/spectrum/1040g34o323sms486n21049plan1o0a32d1nnn08!nc_n_webp_mw_1", "thumbnail_width": 2274, "upload_timestamp": null, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": null, "xsec_token": "ABhu_Cqz8_LewlXka4tu0shXvdf2H8lDyODA4lyaWl9QU=" }, "… 28 more items in the full response" ], "profile_info": { "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/61aa425e1e37340dbd1a8ecc.jpg?imageView2/2/w/540/format/webp", "avatar_url_small": "https://sns-avatar-qc.xhscdn.com/avatar/61aa425e1e37340dbd1a8ecc.jpg?imageView2/2/w/360/format/webp", "collection_board_count": 0, "collection_note_count": 0, "description": "一个36岁的普通人\n 女儿1岁\n分享我们的低成本生活\n 简单朴素的快乐🍜", "follower_count": 10000, "follower_count_display": "10K+", "following_count": 10, "following_count_display": "10+", "gender": 1, "gender_label": "female", "ip_location": "四川", "is_banned": false, "like_and_collect_count": 10000, "like_and_collect_count_display": "10K+", "nickname": "快乐李小抠", "notes_returned": 30, "profile_url": "https://www.xiaohongshu.com/user/profile/59b6c38050c4b43659412862", "red_id": "hola5427", "source": "ssr_user_page_data", "tags": [ "四川成都", "vlog博主", "… 1 more item in the full response" ], "user_id": "59b6c38050c4b43659412862", "xsec_token": "ABhu_Cqz8_LewlXka4tu0shXvdf2H8lDyODA4lyaWl9QU=" } }, "hasMore": false, "nextCursor": null }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "xiaohongshu-profile", "billable": true, "duration_ms": 5043 }}