List Xiaohongshu profile notes
List the notes a Xiaohongshu creator's profile shows, about 30, with titles, covers, likes and dates.
Headers
Get your API keyAPI key (`sfk_...`)
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
Endpoint-specific response payload.
`not_found` when no account has this user id, or the account was deleted.
one of: found, not_found
The account; null when `not_found`.
Xiaohongshu user id, the same on every endpoint: pass it as `profileId` to the profile endpoints.
Display name.
Profile picture.
Profile page.
True when Xiaohongshu banned the account. It then shows no notes, so the list is empty.
The notes the profile shows logged out, newest first with pinned notes on top: about 30. `page.truncated` says whether the creator has more.
Note id. Xiaohongshu hides it in creator lists for logged-out visitors, so it is null on every row except the last, whose id the page carries. The list issues no `xsec_token` that opens its notes, so most of them open in the note endpoints only through their own share link.
Note page, when the id is known.
Title.
The site's English translation of the title, when it has one.
`image` for a photo note, `video` for a video note.
one of: image, video, null
When the note was posted, ISO 8601 UTC.
Cover image. A signed link that expires: download it, do not store it.
Cover width in pixels.
Cover height in pixels.
True when the creator pinned it to the top of the profile.
The one counter creator lists show.
Likes, as the site shows them (rounded from 10,000: `94.3K`).
The creator.
Xiaohongshu user id, the same on every endpoint: pass it as `profileId` to the profile endpoints.
Display name.
Profile picture.
Profile page.
Pagination state. Xiaohongshu shows logged-out visitors one page, so there is never a next page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
True when the item has more rows than the site shows logged out: the list stops here before its end.
How many rows the item has in all, as the site counts them.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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/notes" \
-H "x-api-key: YOUR_API_KEY"Responses
A Xiaohongshu creator's notes.