Xiaohongshu

Get Xiaohongshu profile

Get a Xiaohongshu creator by profile id, with their bio, tags, verification, note count, likes and saves.

GET/v1/xiaohongshu/profiles/{profileId}
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
profileIdstringrequiredpath

The creator's profile id (Xiaohongshu's user id), the 24 characters after `/user/profile/` in a profile link, for example `5c4a8f94000000001003f8c1`. A whole profile link, or the app's `xhslink.com` share link, also works.

min 1 chars · max 512 chars

Response fields
33

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no account has this user id, or the account was deleted.

one of: found, not_found

The account when `lookupStatus` is `found`; otherwise null.

dataprofileid
string

Xiaohongshu user id (the `profileId` the profile endpoints take), as in xiaohongshu.com/user/profile/{id}.

dataprofileredId
stringnullable

The account number the profile shows (its Xiaohongshu number). It does not open the profile: use `id`.

dataprofileurl
string

Profile page.

dataprofiledisplayName
stringnullable

Display name.

dataprofilebio
stringnullable

Bio as plain text.

dataprofilebioTranslation
stringnullable

The site's English translation of the bio, when it has one.

dataprofilegender
stringnullable

Gender, when the creator shows one.

one of: male, female, null

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofilebannerUrl
stringnullable

Profile background image, when it has one.

dataprofileipLocation
stringnullable

The region the site shows for the account, when it shows one.

The tags under the bio.

dataprofiletags[]type
stringnullable

The kind of tag: `info` (such as a star sign), `location`, `profession` and so on.

dataprofiletags[]name
string

What the tag says.

dataprofileisVerified
booleannullable

True when Xiaohongshu verified the account.

dataprofileverifiedLabel
stringnullable

What the verification says, when it says something.

dataprofileisBanned
booleannullable

True when Xiaohongshu banned the account. It then shows no notes, so `stats` is null.

The site's counters; null for a banned account (`isBanned`). Logged out, the site shows followers only as a rounded band.

dataprofilestatsnotes
integernullable

Notes the creator has posted.

dataprofilestatslikes
integernullable

Likes the creator's notes received, exact.

dataprofilestatssaves
integernullable

Saves the creator's notes received, exact.

dataprofilestatsfollowersAtLeast
integernullable

Followers, as the lower bound the site shows logged out (`10K+` reads 10000).

dataprofilestatsfollowersLabel
stringnullable

Followers as the site writes them, such as `10K+`.

dataprofilestatsfollowingAtLeast
integernullable

Accounts it follows, as the lower bound the site shows logged out.

dataprofilestatsfollowingLabel
stringnullable

Accounts it follows as the site writes them, such as `10+`.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/xiaohongshu/profiles/5c4a8f94000000001003f8c1" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Xiaohongshu creator profile.