Xiaohongshu Profile API
Look up any public Xiaohongshu creator by profile id and get the profile and its totals.
GET /v1/xiaohongshu/profiles/{profileId}1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/xiaohongshu/profiles/5c4a8f94000000001003f8c1 returns data.profile with id, redId, url, displayName, bio and bioTranslation, gender, avatarUrl, bannerUrl, ipLocation, tags, isVerified and verifiedLabel, isBanned and stats (notes, likes and saves received, and the follower and following bands).
The profile id is the 24 characters after /user/profile/ in a profile link; the whole link works too. An unknown or deleted account returns lookupStatus: not_found with profile: null.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Xiaohongshu Profile API FAQ
Which id do I pass?
The 24-character profile id from the profile link (xiaohongshu.com/user/profile/5c4a8f94000000001003f8c1), or the whole link. The account number shown on the profile (redId) does not open it.
Why are followers a range?
Visitors who are not signed in see followers only as a band, such as 10K+. stats.followersAtLeast is the band's lower bound and stats.followersLabel the band as written. Likes and saves are exact.
What happens with an id that does not exist?
The request completes with lookupStatus: not_found and profile: null, and it is billed like any completed lookup.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.