Xiaohongshu

List Xiaohongshu profile notes

List the notes a Xiaohongshu creator's profile shows, about 30, with titles, covers, likes and dates.

GET/v1/xiaohongshu/profiles/{profileId}/notes
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
profileIdstringrequiredpath

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

Response fields
37

Endpoint-specific response payload.

datalookupStatus
string

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

dataprofileid
string

Xiaohongshu user id, the same on every endpoint: pass it as `profileId` to the profile endpoints.

dataprofiledisplayName
stringnullable

Display name.

dataprofileavatarUrl
stringnullable

Profile picture.

dataprofileurl
string

Profile page.

dataprofileisBanned
booleannullable

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.

datanotes[]id
stringnullable

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.

datanotes[]url
stringnullable

Note page, when the id is known.

datanotes[]title
stringnullable

Title.

datanotes[]titleTranslation
stringnullable

The site's English translation of the title, when it has one.

datanotes[]type
stringnullable

`image` for a photo note, `video` for a video note.

one of: image, video, null

datanotes[]createdAt
stringnullable

When the note was posted, ISO 8601 UTC.

datanotes[]coverUrl
stringnullable

Cover image. A signed link that expires: download it, do not store it.

datanotes[]coverWidth
integernullable

Cover width in pixels.

datanotes[]coverHeight
integernullable

Cover height in pixels.

datanotes[]isPinned
booleannullable

True when the creator pinned it to the top of the profile.

The one counter creator lists show.

datanotes[]statslikes
integernullable

Likes, as the site shows them (rounded from 10,000: `94.3K`).

The creator.

datanotes[]authorid
string

Xiaohongshu user id, the same on every endpoint: pass it as `profileId` to the profile endpoints.

datanotes[]authordisplayName
stringnullable

Display name.

datanotes[]authoravatarUrl
stringnullable

Profile picture.

datanotes[]authorurl
string

Profile page.

Pagination state. Xiaohongshu shows logged-out visitors one page, so there is never a next page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the item has more rows than the site shows logged out: the list stops here before its end.

datapagetotal
integernullable

How many rows the item has in all, as the site counts them.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.