raw.xiaohongshu.user

Xiaohongshu (RedNote) user profile

LiveBeta

GEThttps://api.qovia.ai/v1/raw/xiaohongshu/user

A Xiaohongshu user's profile. data holds the platform's original profile fields, unrenamed, unfiltered and unconverted: userid, red_id (the Xiaohongshu ID), nickname, fans, follows, interactions, note_num_stat, gender, ip_location, desc, imageb and so on. A user that does not exist answers 404 and is not charged.

Typical uses: Vetting creators, monitoring accounts and benchmarking competitors' accounts.

Price: $0.005 / call$5 per 1k · fixed price
Billing: Charged only for successful, non-empty resultsthe charge is in meta.charged_usd
Scope: raw:xiaohongshuThe API key needs this scope
Rate limit: NoneNo per-account or per-endpoint request limit

Parameters

Sent as query parameters

Only these parameters are accepted; any other one returns 400.

user_idstringRequired

User ID (24 hex characters, the ID in xiaohongshu.com/user/profile/<ID>; not the Xiaohongshu ID)

Pattern^[0-9a-f]{24}$

Example60014bac0000000001009be4

curl 'https://api.qovia.ai/v1/raw/xiaohongshu/user?user_id=60014bac0000000001009be4' \
  -H "Authorization: Bearer $QOVIA_KEY"

Replace $QOVIA_KEY with your API key

Example response200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "avatar_handle_entry_list": [],
    "avatar_like_status": false,
    "avatar_pendant": {
      "current_user_pendant": false,
      "current_user_pet": false
    },
    "banner_info": {
      "bg_color": "a5938c",
      "image": "http://sns-avatar-qc.rednotecdn.com/user_banner/1040g2k030qvbq59th8005o019em096v4ca64f10?imageView2/2/w/540/format/jpg&ap=28&sc=USR_BG",
      "like_status": false
    },
    "block_view_from_user": false,
    "block_view_to_user": false,
    "blocked": false,
    "blocking": false,
    "brand_account_info": {
      "conversions": [
        {
          "icon": "https://picasso-static.xiaohongshu.com/fe-platform/c17fa18d287ca13418e1a6ae86270895a10c9d78.png",
          "id": "11",
          "is_red_shop": false,
          "is_shop": false,
          "link": "xhsdiscover://message/userPublicGroupList?user_id=60014bac0000000001009be4&username=TA",
          "name": "群聊",
          "sub_title": "查看详情"
        },
        {
          "icon": "https://picasso-static.xiaohongshu.com/fe-platform/abb79105a1ec9de13a055f2875607c4824263d89.png",
          "id": "13",
          "is_red_shop": false,
          "is_shop": false,
          "link": "xhsdiscover://live_goods_development_page?source=PROFILE&host_id=60014bac0000000001009be4&trailer_auto_subscribe=0",
          "name": "直播动态",
          "sub_title": "去预约 10.22 10:01"
        }
      ]
    },
    "collected": 8813,
    "collected_book_num": 0,
    "collected_brand_num": 0,
    "collected_movie_num": 0,
    "collected_notes_num": 0,
    "collected_poi_num": 0,
    "collected_product_num": 0,
    "collected_tags_num": 0,
    "college_info": {
      "college_name": "安徽农业大学",
      "enrollment_year": 2023
    },
    "community_rule_url": "https://www.xiaohongshu.com/user/community-rule",
    "default_collection_tab": "note",
    "desc": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点",
    "desc_at_users": [],
    "fans": 10512,
    "follows": 1,
    "fstatus": "none",
    "gender": 1,
    "hula_tabs": {
      "all_show_tab_config": [
        {
          "tab_id": "note",
          "tab_index_weight": 0,
          "tab_name": "笔记"
        },
        {
          "tab_id": "atMe",
          "tab_index_weight": 12,
          "tab_name": "标记"
        }
      ],
      "tab_id_selected": "note"
    },
    "identity_deeplink": "xhsdiscover://rn/app-settings/official/certification/details?type=2&user_id=60014bac0000000001009be4&is_mcn=false",
    "identity_label_migrated": false,
    "imageb": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo30pmiu3qp6k005o019em096v44mekl3g?imageView2/2/w/540/format/webp",
    "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo30pmiu3qp6k005o019em096v44mekl3g?imageView2/2/w/360/format/webp",
    "interactions": [
      {
        "count": 1,
        "is_private": true,
        "name": "关注",
        "toast": "该用户已设置关注列表不可见",
        "type": "follows"
      },
      {
        "count": 10512,
        "is_private": true,
        "name": "粉丝",
        "toast": "该用户已设置粉丝列表不可见",
        "type": "fans"
      },
      {
        "count": 27720,
        "is_private": false,
        "name": "获赞与收藏",
        "toast": "",
        "type": "interaction"
      }
    ],
    "ip_location": "天津",
    "is_login_user_pro_account": false,
    "is_recommend_level_illegal": false,
    "level": {
      "image_link": "",
      "number": 0
    },
    "liked": 18907,
    "location": "中国  天津  津南",
    "location_jump": true,
    "mute_view_to_user": false,
    "nboards": 0,
    "ndiscovery": 430,
    "nickname": "木***师",
    "note_num_stat": {
      "collected": 8813,
      "liked": 18907,
      "posted": 430
    },
    "real_name_deep_target": 1,
    "real_name_info": "",
    "recommend_info": "",
    "recommend_info_icon": "",
    "red_club_info": {
      "red_club": false,
      "red_club_level": 0,
      "red_club_url": "https://www.xiaohongshu.com/store/mc/landing",
      "redclubscore": 0
    },
    "red_id": "Bel***83",
    "red_official_verified": false,
    "red_official_verify_base_info": "",
    "red_official_verify_content": "",
    "red_official_verify_type": 0,
    "remark_name": "",
    "result": {
      "code": 0,
      "message": "success",
      "success": true
    },
    "sec_account_deeplink": "xhsdiscover://rn/accounts/account-detail?targetId=60014bac0000000001009be4&new_page_exp=1&rn_min_version=3.3.6",
    "seller_info": {
      "can_process_coupon": true,
      "display_modules": {
        "official": true
      },
      "is_tab_goods_first": true,
      "store_id": "625113963801e1000190ca26",
      "tab_code_names": [
        "TRADE_COMMODITY_TAB",
        "TRADE_SELLER_INFO"
      ],
      "tab_goods_api_version": 2,
      "tab_goods_name": "商品"
    },
    "share_info": {
      "content": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点",
      "store_link": "xhsdiscover://rn/lancer/shop-detail/625113963801e1000190ca26",
      "title": "木灵老师"
    },
    "share_info_v2": {
      "content": "粉丝: 1.1万\n获赞与收藏: 2.8万",
      "ecom_content": "快来木灵老师的店里逛逛！已有6262人买过了！",
      "ecom_share_link": "https://www.xiaohongshu.com/user/profile/60014bac0000000001009be4?tab=goods&channelType=share_outside",
      "ecom_title": "木灵老师的店铺",
      "title": "@木灵老师的个人主页"
    },
    "share_link": "https://www.xiaohongshu.com/user/profile/60014bac0000000001009be4?xsec_token=YBgvXArWi74H3r7dAuJ41l2ZuVsEBC6hparuUPvHH-v5E=&xsec_source=app_share",
    "show_extra_info_button": false,
    "tab_public": {
      "collection": false,
      "collection_board": true,
      "collection_note": true,
      "seed": true
    },
    "tab_visible": {
      "atme": true,
      "collect": false,
      "goods": false,
      "like": false,
      "note": true,
      "seed": true
    },
    "tags": [
      {
        "icon": "http://sns-i14-ae.rednotecdn.com/icons/user/gender-female-v1.png",
        "name": "天蝎座",
        "tag_type": "info"
      },
      {
        "name": "天津津南",
        "tag_type": "location"
      },
      {
        "name": "茶艺师",
        "tag_type": "profession"
      }
    ],
    "user_desc_info": {
      "desc": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点",
      "desc_at_users": [],
      "desc_keywords_switch": true,
      "desc_with_placeholder": "我是木灵\n线下茶艺老师\n直播课周一至周五\n上午10点-13点"
    },
    "user_role_type": 6,
    "user_widget_switch": false,
    "userid": "60014bac0000000001009be4",
    "zhong_tong_bar_info": {
      "conversions": [
        {
          "icon": "https://picasso-static.xiaohongshu.com/fe-platform/abb79105a1ec9de13a055f2875607c4824263d89.png",
          "id": "13",
          "link": "xhsdiscover://live_goods_development_page?source=PROFILE&host_id=60014bac0000000001009be4&trailer_auto_subscribe=0",
          "name": "直播动态",
          "sub_title": "去预约 10.22 10:01"
        },
        {
          "icon": "https://picasso-static.xiaohongshu.com/fe-platform/c17fa18d287ca13418e1a6ae86270895a10c9d78.png",
          "id": "11",
          "link": "xhsdiscover://message/userPublicGroupList?user_id=60014bac0000000001009be4&username=TA",
          "name": "群聊",
          "sub_title": "查看详情"
        }
      ]
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.005000",
    "balance_usd": "9.995000",
    "empty": false
  }
}

Catalog sample, not live data

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
code	HTTP	Billing	Description
`scope_denied`	403	Not charged	This API key lacks the scope the endpoint requires.
`endpoint_unavailable`	503	Not charged	The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
`invalid_params`	400	Not charged	The parameters failed validation: a required one is missing, a type or format is wrong, an array has more items than allowed, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (`item_id: …`); a missing or unknown parameter starts with `params: …`.
`insufficient_balance`	402	Not charged	The balance cannot pay for this call; top up first.
`upstream_busy`Retryable	503	Refunded	The data source is busy or cooling down; refunded. Retry after `Retry-After`.
`upstream_timeout`	504	Refunded	The data source timed out; refunded.
`upstream_error`	502 / 503	Refunded	The data source failed; refunded.
`upstream_rejected`	400	Refunded	The data source rejected these parameters (well-formed, but not accepted); refunded.
`not_found`	404	Refunded	The data source has no such item (deleted, or the ID does not exist); refunded.
`reservation_expired`	504	Refunded	The call took too long and was refunded automatically; no data is returned.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code

Call it from your browser

Needs an account with a balance; playground calls are billed like API calls.

Try in the playground Create an API key

Parameters

Response

Errors

More Xiaohongshu (RedNote) endpoints