Xiaohongshu

List Xiaohongshu note comments

List the top comments on a Xiaohongshu note with their first replies and the note's comment totals.

GET/v1/xiaohongshu/notes/{noteId}/comments
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
noteIdstringrequiredpath

The note id, the 24 characters after `/explore/` or `/discovery/item/` in a note link, for example `68ad9c4b000000001b0339a6`. Most notes open only with the `xsec_token` of the link they were shared or listed with, so pass the whole note link (its token is read from it), the app's `xhslink.com` share link, or the id with `xsecToken`.

min 1 chars · max 1024 chars

xsecTokenstringoptionalquery

The `xsec_token` from the note's link (the value after `xsec_token=`). Needed for most notes: without it Xiaohongshu shows logged-out visitors only notes it currently promotes. Read from the link when you pass a whole note link as `noteId`.

pattern: ^[A-Za-z0-9_\-+/=]{16,256}$

Response fields
48

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Xiaohongshu refuses a note requested with an `xsec_token` (from the link or `xsecToken`): deleted, hidden or unknown. Without a token, a note Xiaohongshu will not show answers 400 `bad_request`, with no charge.

one of: found, not_found

datanoteId
string

The note the comments belong to.

datacommentCount
integernullable

Comments on the note in all, replies included.

The top comments the note shows logged out (up to 5), each with its first replies. `page.total` counts every top-level comment.

datacomments[]id
string

Comment id.

datacomments[]text
stringnullable

The comment as plain text.

datacomments[]textTranslation
stringnullable

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

datacomments[]language
stringnullable

The language the site detected, such as `zh_cn`.

datacomments[]createdAt
stringnullable

When it was posted, ISO 8601 UTC.

datacomments[]ipLocation
stringnullable

The region the site shows it was posted from, when shown.

datacomments[]likes
integernullable

Likes, as the site shows them.

Pictures or stickers posted with the comment.

datacomments[]imageUrls[]
stringoptional
datacomments[]replyToCommentId
stringnullable

The comment this one answers, for a reply.

Who wrote it.

datacomments[]authorid
string

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

datacomments[]authordisplayName
stringnullable

Display name.

datacomments[]authoravatarUrl
stringnullable

Profile picture.

datacomments[]authorurl
string

Profile page.

datacomments[]replyCount
integernullable

How many replies the comment has in all.

The first replies, as the site shows them logged out (up to 3). `replyCount` says how many there are.

datacomments[]replies[]id
string

Comment id.

datacomments[]replies[]text
stringnullable

The comment as plain text.

datacomments[]replies[]textTranslation
stringnullable

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

datacomments[]replies[]language
stringnullable

The language the site detected, such as `zh_cn`.

datacomments[]replies[]createdAt
stringnullable

When it was posted, ISO 8601 UTC.

datacomments[]replies[]ipLocation
stringnullable

The region the site shows it was posted from, when shown.

datacomments[]replies[]likes
integernullable

Likes, as the site shows them.

Pictures or stickers posted with the comment.

datacomments[]replies[]imageUrls[]
stringoptional
datacomments[]replies[]replyToCommentId
stringnullable

The comment this one answers, for a reply.

Who wrote it.

datacomments[]replies[]authorid
string

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

datacomments[]replies[]authordisplayName
stringnullable

Display name.

datacomments[]replies[]authoravatarUrl
stringnullable

Profile picture.

datacomments[]replies[]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/notes/68ad9c4b000000001b0339a6/comments" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Comments on a Xiaohongshu note.