Xiaohongshu hub

Xiaohongshu Note Comments API

Read the top comments on a note, with their first replies and the true totals.

GET /v1/xiaohongshu/notes/{noteId}/comments

1 credit Failed requests are free Found, empty and not-found answers are all charged

About this endpoint

GET /v1/xiaohongshu/notes/68ad9c4b000000001b0339a6/comments returns data.comments, the top comments the note shows (up to 5), each with text, textTranslation, createdAt, likes, imageUrls, author, replyCount and its first replies (up to 3).

page.total counts the note's top-level comments and data.commentCount every comment with replies; page.truncated is true when there are more than the list holds. A deleted, hidden or unknown note returns lookupStatus: not_found.

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 Note Comments API FAQ

How many comments does it return?

The top comments the note shows to visitors who are not signed in, up to 5, each with up to 3 replies. page.total and commentCount give the true totals, and page.truncated says whether there are more.

What is replyCount?

How many replies the comment has in all. replies holds the first ones.

Does a note without comments cost a credit?

Yes. It is a completed lookup: lookupStatus is found, comments is empty and page.total is 0.

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.