API referenceXiaohongshu
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.
Authorization
ApiKeyAuth X-API-Key<token>
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 }}