Xiaohongshu Profile Notes API
List the notes a creator's profile shows, with their covers, likes and dates.
GET /v1/xiaohongshu/profiles/{profileId}/notes1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/xiaohongshu/profiles/5c4a8f94000000001003f8c1/notes returns data.notes, the notes the profile shows (about 30, pinned first, then newest), each with title, titleTranslation, type, createdAt, coverUrl, isPinned, stats.likes and author, plus data.profile and data.page.
page.total is how many notes the creator has; page.truncated is true when that is more than the list holds. Xiaohongshu hides note ids in this list from visitors who are not signed in, so id is null except on the last note.
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 Notes API FAQ
How many notes does it return?
The notes the profile shows, about 30. page.total is the creator's note count, and page.truncated is true when the creator has more.
Why is a note's id null?
Xiaohongshu hides note ids in creator lists from visitors who are not signed in. The last note carries its id. Open a note by its link with the note route to get everything about it.
What does a list of fewer notes than page.total mean?
Either the creator has more than one page shows, or some notes are hidden from the public. Both are marked page.truncated: true.
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.