Xiaohongshu hub

Xiaohongshu Profile Notes API

List the notes a creator's profile shows, with their covers, likes and dates.

GET /v1/xiaohongshu/profiles/{profileId}/notes

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.