Xiaohongshu hub

Xiaohongshu Note API

Open any public Xiaohongshu note with its text, media and counts.

GET /v1/xiaohongshu/notes/{noteId}

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

About this endpoint

GET /v1/xiaohongshu/notes/68ad9c4b000000001b0339a6 returns data.note with id, url, type, title, description, their English translations, language, createdAt, updatedAt, topics, mentions, coverUrl, images, video (file, length, size and bitrate), stats (likes, saves, comments, shares) and author.

Pass the note id or the whole link from xiaohongshu.com or rednote.com. A deleted, hidden or unknown note returns lookupStatus: not_found with note: null.

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

Can I pass a share link?

Yes. A link with /explore/ or /discovery/item/ on xiaohongshu.com or rednote.com works, with or without its query string.

Are the counts exact?

Below 10,000 they are. From 10,000 Xiaohongshu rounds them (94.3K, 9.4万) and the API returns the number the label names.

Can I keep the video and image links?

No. They are signed and expire. Download the files if you need them.

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.