logo
languageFRdown
menu

Xiaohongshu (RED) Account Profile

Give it a Xiaohongshu user ID and get back the account's public profile: display name, RED ID, bio, follower and following counts, likes-and-collects total, note count, verification status and location.

Source · en-USRevenir à la traduction

Aperçu

Need to size up a Xiaohongshu (RED) creator or brand account before you work with it? Give this app the account's user ID and it reads the public profile page for you, returning one tidy record: display name, RED ID, bio, profile and banner images, follower and following counts, the likes-and-collects total, note count, verification status, declared gender, location and the profile tag strip.

Profile figures on Xiaohongshu are the first thing a marketing, PR or business-development team checks, but they live inside an app that is awkward to query at scale. This app turns a profile page into a row of data you can drop into a spreadsheet, a CRM or an influencer database, with the same fields every time, so account vetting, KOL shortlisting and audience tracking stop being screenshot work.

Data notes

Each record is read directly from the account's public profile page at the time the task runs, so every number is a snapshot of that moment, not a daily average or a historical series. The likes-and-collects total is the single combined figure Xiaohongshu shows on the profile; a separate collects figure is only filled when the platform reports it, and is otherwise 0. The note count is the number of notes counted on the profile page, which can differ from the original-content count shown in the profile tags. The location is the region the account chooses to display, written in Chinese as it appears on the page, and may be empty. Only publicly visible profile information is covered: notes, comments, follower lists and anything that requires logging in or following the account are not included. Accounts that have been deleted, banned or made unavailable come back as a record flagged as no data with the other fields empty.

What a result looks like

Each record is one Xiaohongshu account:

Display nameRED IDFollowersLikes and collectsNote countVerified
优篮子Ulanzi老板Ulanzi2023380501778641080No
闹闹不是泡泡74166084983426111332421No

Other fields include User ID, Bio, Profile URL, Avatar URL, Banner URL, Following, Collects, Gender code, Location, Profile tags, Collected at and No data.

Use cases

  • When shortlisting creators for a campaign, rank candidates by "Followers" and "Likes and collects", then divide the two to get an engagement-per-follower ratio that separates genuinely active audiences from inflated follower counts.
  • When vetting a brand or partner account, read "Verified", "Bio", "Location" and "Profile tags" together to confirm the account is the official one, what it says it does and where it operates before you reach out.
  • When tracking an account you already work with, run the task on a regular schedule and compare "Followers", "Note count" and "Likes and collects" between runs to see whether posting cadence and audience growth are moving in the right direction.
  • When building an influencer database, store "User ID" as the stable key and "RED ID", "Display name" and "Avatar URL" as the human-friendly labels, since handles and nicknames can change while the user ID does not.

Périmètre et limites

One account per task and at most one record per task; public profile data only, no notes, comments or follower lists.

  • Adapté pour
  • When you have a Xiaohongshu user ID and need the account's current public profile figures (followers, following, likes and collects, note count) in one record
  • When vetting a creator or brand account before a collaboration and you need verification status, bio and location alongside the audience numbers
  • When tracking the same account over time by running the task periodically and comparing follower and interaction counts
  • À ne pas utiliser pour
  • When you need the account's notes, comments or follower lists rather than the profile summary
  • When you only have a RED ID (the handle shown on the profile page) or a nickname and not the 24-character user ID from the profile URL
  • When you need many accounts at once in a single call; this app handles one account per task, so submit one task per account

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par l'auteur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

  1. 1A completed task with an empty result or a record flagged as no data usually means the user ID does not exist, the account is deleted or banned, or the profile is otherwise unavailable; double-check the ID from the profile URL before retrying
  2. 2A task that ends in failure or expiry can be resubmitted as is; if it fails again, wait a few minutes before the next attempt
  3. 3Authentication and authorization errors are not retryable; they indicate a credential problem on the publisher side, so contact the publisher instead of retrying
  4. 4Rate-limit errors are retryable after a short pause; spread out large batches of tasks instead of submitting them all at once

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

ChampNom métierTypeRequisDéfautÉnum / ContraintesExempleDescription
account_idXiaohongshu user IDstringOui55c8ae2762a60c7e4bb45331The 24-character user ID of the Xiaohongshu account, taken from the end of its profile URL https://www.xiaohongshu.com/user/profile/<user ID>. This is not the RED ID shown on the profile page; an ID that does not exist yields an empty result.

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

ChampNom métierTypeExempleDescription
account_idUser IDstring55c8ae2762a60c7e4bb45331The account's 24-character Xiaohongshu user ID, the same value that was submitted.
account_nameDisplay namestring优篮子Ulanzi老板The nickname the account currently shows on its profile page.
screen_nameRED IDstringUlanzi2023The public handle shown as the RED ID on the profile page; it can be changed by the account owner.
account_urlProfile URLstringhttps://www.xiaohongshu.com/user/profile/55c8ae2762a60c7e4bb45331?xsec_token=YBq9XViMxpUwYTUk2SHYqkJWilTF4Gaj_2lo2e6ujLst0=&xsec_source=app_shareLink to the account's profile page on Xiaohongshu.
avatar_urlAvatar URLstringhttps://sns-avatar-qc.xhscdn.com/avatar/1040g2jo30trs1q3l4u004129jvn2ekphu59c720?imageView2/2/w/540/format/webpLink to the account's current profile picture.
banner_image_urlBanner URLstringhttps://sns-avatar-qc.xhscdn.com/user_banner/1040g2k031is9321s1e004129jvn2ekphghlha7g?imageView2/2/w/540/format/jpg&ap=28&sc=USR_BGLink to the background banner image at the top of the profile page.
bioBiostring@优篮子Ulanzi 主理人 欢迎大家提建议 投资 纳贤 听劝 创业孵化 都可以✉️我The self-introduction text on the profile page, with original line breaks preserved.
is_verifiedVerifiedbooleanfalseWhether the account carries a Xiaohongshu verification badge.
follower_countFollowersinteger38050Number of followers shown on the profile page at collection time.
following_countFollowinginteger2684Number of accounts this account follows, as shown on the profile page at collection time.
interaction_countLikes and collectsinteger177864Combined total of likes and collects the account's notes have received, as shown on the profile page.
note_countNote countinteger1080Number of notes counted on the account's profile page at collection time.
collected_countCollectsinteger0Number of collects reported separately for the account; 0 when Xiaohongshu only reports the combined likes-and-collects total.
gender_codeGender codeinteger0Gender declared on the profile: 0 = male, 1 = female, 2 = not specified.
locationLocationstring广东The region shown on the profile page, usually a province or city name in Chinese; empty when the account does not display one.
profile_tagsProfile tagsstring[{"icon": "http://ci.xiaohongshu.com/icons/user/gender-male-v1.png", "iconSize": null, "link": null, "name": null, "tagType": "info"}, {"icon": null, "iconSize": null, "link": null, "name": "广东", "tagType": "location"}, {"icon": null, "iconSize": null, "link": null, "name": "摄影博主", "tagType": "profession"}, {"icon": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31793qa0d3u5g5nqphi3g97c59l4tvvg?imageView2/2/w/80/format/jpg", "iconSize": 12, "link": "xhsdiscover://user/5f598c870000000001009d85?tab=goods", "name": "优篮子Ulanzi•品牌创始人", "tagType": "brandManager"}, {"icon": null, "iconSize": null, "link": null, "name": "290条原创内容", "tagType": "original"}]The tag strip under the bio (profession, location, brand role, original-content count and similar) as one JSON-encoded text; parse it if you need individual tags.
crawl_timeCollected atstring2026-08-27T14:15:48Date and time the profile was read, in the form 2026-08-27T14:15:48.
no_dataNo databooleanfalseTrue when the profile could not be read for the submitted ID; the other fields are then empty.

Schema de l'enregistrement

La sortie est renvoyée enregistrement par enregistrement. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "title": "User ID",
      "description": "The account's 24-character Xiaohongshu user ID, the same value that was submitted.",
      "prefill": "55c8ae2762a60c7e4bb45331"
    },
    "account_name": {
      "type": "string",
      "title": "Display name",
      "description": "The nickname the account currently shows on its profile page.",
      "prefill": "优篮子Ulanzi老板"
    },
    "screen_name": {
      "type": "string",
      "title": "RED ID",
      "description": "The public handle shown as the RED ID on the profile page; it can be changed by the account owner.",
      "prefill": "Ulanzi2023"
    },
    "account_url": {
      "type": "string",
      "title": "Profile URL",
      "description": "Link to the account's profile page on Xiaohongshu.",
      "prefill": "https://www.xiaohongshu.com/user/profile/55c8ae2762a60c7e4bb45331?xsec_token=YBq9XViMxpUwYTUk2SHYqkJWilTF4Gaj_2lo2e6ujLst0=&xsec_source=app_share"
    },
    "avatar_url": {
      "type": "string",
      "title": "Avatar URL",
      "description": "Link to the account's current profile picture.",
      "prefill": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo30trs1q3l4u004129jvn2ekphu59c720?imageView2/2/w/540/format/webp"
    },
    "banner_image_url": {
      "type": "string",
      "title": "Banner URL",
      "description": "Link to the background banner image at the top of the profile page.",
      "prefill": "https://sns-avatar-qc.xhscdn.com/user_banner/1040g2k031is9321s1e004129jvn2ekphghlha7g?imageView2/2/w/540/format/jpg&ap=28&sc=USR_BG"
    },
    "bio": {
      "type": "string",
      "title": "Bio",
      "description": "The self-introduction text on the profile page, with original line breaks preserved.",
      "prefill": "@优篮子Ulanzi 主理人 欢迎大家提建议\n投资 纳贤 听劝 创业孵化 都可以✉️我"
    },
    "is_verified": {
      "type": "boolean",
      "title": "Verified",
      "description": "Whether the account carries a Xiaohongshu verification badge.",
      "prefill": false
    },
    "follower_count": {
      "type": "integer",
      "title": "Followers",
      "description": "Number of followers shown on the profile page at collection time.",
      "prefill": 38050
    },
    "following_count": {
      "type": "integer",
      "title": "Following",
      "description": "Number of accounts this account follows, as shown on the profile page at collection time.",
      "prefill": 2684
    },
    "interaction_count": {
      "type": "integer",
      "title": "Likes and collects",
      "description": "Combined total of likes and collects the account's notes have received, as shown on the profile page.",
      "prefill": 177864
    },
    "note_count": {
      "type": "integer",
      "title": "Note count",
      "description": "Number of notes counted on the account's profile page at collection time.",
      "prefill": 1080
    },
    "collected_count": {
      "type": "integer",
      "title": "Collects",
      "description": "Number of collects reported separately for the account; 0 when Xiaohongshu only reports the combined likes-and-collects total.",
      "prefill": 0
    },
    "gender_code": {
      "type": "integer",
      "title": "Gender code",
      "description": "Gender declared on the profile: 0 = male, 1 = female, 2 = not specified.",
      "prefill": 0
    },
    "location": {
      "type": "string",
      "title": "Location",
      "description": "The region shown on the profile page, usually a province or city name in Chinese; empty when the account does not display one.",
      "prefill": "广东"
    },
    "profile_tags": {
      "type": "string",
      "title": "Profile tags",
      "description": "The tag strip under the bio (profession, location, brand role, original-content count and similar) as one JSON-encoded text; parse it if you need individual tags.",
      "prefill": "[{\"icon\": \"http://ci.xiaohongshu.com/icons/user/gender-male-v1.png\", \"iconSize\": null, \"link\": null, \"name\": null, \"tagType\": \"info\"}, {\"icon\": null, \"iconSize\": null, \"link\": null, \"name\": \"广东\", \"tagType\": \"location\"}, {\"icon\": null, \"iconSize\": null, \"link\": null, \"name\": \"摄影博主\", \"tagType\": \"profession\"}, {\"icon\": \"https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31793qa0d3u5g5nqphi3g97c59l4tvvg?imageView2/2/w/80/format/jpg\", \"iconSize\": 12, \"link\": \"xhsdiscover://user/5f598c870000000001009d85?tab=goods\", \"name\": \"优篮子Ulanzi•品牌创始人\", \"tagType\": \"brandManager\"}, {\"icon\": null, \"iconSize\": null, \"link\": null, \"name\": \"290条原创内容\", \"tagType\": \"original\"}]"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collected at",
      "description": "Date and time the profile was read, in the form 2026-08-27T14:15:48.",
      "prefill": "2026-08-27T14:15:48"
    },
    "no_data": {
      "type": "boolean",
      "title": "No data",
      "description": "True when the profile could not be read for the submitted ID; the other fields are then empty.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Open Platform) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

mcpServers config
{
  "mcpServers": {
    "5vvv22tx__xiaohongshu-account-info": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=5vvv22tx/xiaohongshu-account-info",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Le prompt demande à l'IA de vous réclamer votre API Key, afin que les identifiants ne finissent jamais dans l'historique de conversation ni dans des configs partagées.)

detail.access.mcp.composeHint

Tarifs

One account lookup

Facturé une fois par tâche soumise, quel que soit le nombre d'enregistrements renvoyés.

0,05 $US/ exécution

Plusieurs événements de facturation se cumulent indépendamment — voir chaque élément pour les détails. Les tâches échouées ne sont pas facturées.

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple
Les paramètres sont validés par rapport à l'input.schema avant la soumission
Veuillez d'abord renseigner les paramètres requis
0,05 $US / exécution