How do I get a Xiaohongshu creator's follower count, likes and note count by API?

An agency sends you a shortlist of 50 Xiaohongshu creators as a pile of links, and you need follower counts and engagement in one table before the Friday call. Opening each profile and typing numbers takes an afternoon. Scraper "creator mode" tends to fail on exactly this step, with empty profiles or parse errors after a page change. One profile call per creator, straight from the link, returns those numbers.

One call per creator

Xiaohongshu account profile takes either url (a xiaohongshu.com/user/profile/... link or an xhslink.com share link copied from the app) or id (the 24-character user ID). It returns:

• followers and following
• likes: Xiaohongshu shows likes and saves as one combined number, and that is what you get
• posts: how many notes the account has published
• name, username (the Xiaohongshu ID shown on the profile), bio, verified, avatar_url
• with view=full, the IP location shown on the profile under ext

Cost

Creators	Calls	Cost
1	1	$0.02
50	50	$1.00
500	500	$10.00

To judge recent performance too, add the first page of their notes, about 20 notes with like, save and comment counts: profile plus one page for 50 creators is {{cost:xiaohongshu.users.get50+xiaohongshu.users.notes.list50}}.

Example

curl -G "https://api.okdata.online/v1/xiaohongshu/users/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'url=https://www.xiaohongshu.com/user/profile/5f1234567890abcdef123456' \
  --data-urlencode 'fields=id,name,followers,likes,posts,verified'

fields keeps the response to the columns you want in the sheet.

Follower growth

There is no history endpoint. Xiaohongshu shows only today's number. If growth matters, look each creator up on a schedule, weekly is usually enough, and store the result with the meta.fetched_at time. Ten creators every week for a year is 520 calls, $10.40.

Limits

• Public profiles only. Private or banned accounts return not_found, which is free.
• No audience demographics, rates or campaign data. Those live in Xiaohongshu's creator marketplace (蒲公英 / PGY) and need a brand account there.
• Search and comment results do not include follower counts; this endpoint is where they come from.

Alternatives

For a handful of creators, reading the profile in the app is quicker. If you buy campaigns through PGY, its creator pages carry rates and audience data that no public endpoint has. For public numbers at scale, the creator discovery page shows how to go from a keyword to a ranked creator list.