Skip to main content

GET /v1/xiaohongshu/user/user_v3

Xiaohongshu User Profile API (V3)

stable · 16 credits per success

Retrieve a Xiaohongshu (RedNote) user profile by user ID or a supported profile URL. Use it for creator discovery, account research and reviewing a known profile before related content analysis.

Sign up for 500 credits and run with your own API key. Sign up free

Request

curl
curl -s 'https://api.wellbyte.net/v1/xiaohongshu/user/user_v3?userId=demo' \
  -H "Authorization: Bearer dg_live_…"

Response

Sample captured 2026-09-23

data{
code:0
data{
desc:"专业 让生活更简单"
fans:54059
tags[ 0 items ]
level{ 3 items }
liked:108556
gender:2
imageb:
"https://sns-avatar-qc-ae.rednotecdn.com/avatar/65c34f43412e1900018eaefd.jpg?imag..."
images:
"https://sns-avatar-qc-ae.rednotecdn.com/avatar/65c34f43412e1900018eaefd.jpg?imag..."
red_id:""
result{ 3 items }
userid:"5d1778df00000000160339d1"
blocked:false
follows:12
fstatus:"none"
nboards:0
blocking:false
location:""
nickname:"中国平安"
collected:33390
hula_tabs{ 4 items }
ndiscovery:589
share_info{ 2 items }
share_link:
"https://www.xiaohongshu.com/user/profile/5d1778df00000000160339d1?xsec_token=YBb..."
tab_public{ 4 items }
banner_info{ 3 items }
ip_location:"广东"
remark_name:""
seller_info{ 3 items }
tab_visible{ 6 items }
interactions[ 2 items ]
desc_at_users[ 0 items ]
location_jump:false
note_num_stat{ 3 items }
red_club_info{ 1 item }
share_info_v2{ 2 items }
atme_notes_num:1
avatar_pendant{ 2 items }
recommend_info:""
user_desc_info{ 4 items }
user_role_type:4
collected_poi_num:0
identity_deeplink:
"xhsdiscover://rn/accounts/account-detail?targetId=5d1778df00000000160339d1&new_p..."
mute_view_to_user:false
avatar_like_status:false
block_view_to_user:false
brand_account_info{ 4 items }
collected_book_num:0
collected_tags_num:0
community_rule_url:"https://www.xiaohongshu.com/user/community-rule"
user_widget_switch:false
collected_brand_num:0
collected_movie_num:0
collected_notes_num:0
recommend_info_icon:""
block_view_from_user:false
sec_account_deeplink:
"xhsdiscover://rn/accounts/account-detail?targetId=5d1778df00000000160339d1&new_p..."
collected_product_num:0
real_name_deep_target:1
red_official_verified:false
default_collection_tab:"note"
red_official_full_name:"中国平安保险(集团)股份有限公司"
show_extra_info_button:false
identity_label_migrated:false
avatar_handle_entry_list[ 0 items ]
red_official_verify_type:2
is_login_user_pro_account:false
red_official_verify_arrow:0
is_recommend_level_illegal:false
red_official_verify_content:"保险"
show_red_official_verify_icon:false
}
meta{
endpoint:"xiaohongshu.user.user_v3"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

No calls yet. Get one green run first, then switch to your own data.

    Request parameters

    NameTypeInRequiredDescriptionExample
    userIdstringqueryyes小红书用户ID或包含 /user/profile/ 的个人资料URL。demo

    Response fields

    Field dictionary coming soon — the executable panel shows the live shape.

    Errors

    codeHTTPMeaningBilled
    40001400Invalid parametersno
    40102401Invalid or revoked API Keyno
    40201402Insufficient creditsno
    40402404Resource not foundno
    42201422Quality gate failedno
    42901429Rate limit exceededno
    50401504Upstream timeoutno
    50201502Upstream errorno

    Billing

    Success costs 16 credits. Any failure — including a 200 that fails the quality gate — costs 0.

    All Xiaohongshu endpoints →

    Search

    Search endpoints and docs