One Xiaohongshu note, read as an image-text note and returned as the platform answers it, in JSON: note_list (note ID, title, text, like / comment / save / share counts, topics, publish time, IP location, images) and user (the author). No video link or duration. Only an answer with data is charged; an empty answer or an error is not.
Typical uses: Tracking a single post or product: reach, engagement over time and archiving.
Price
$0.02536 / call$25.36 per 1k · fixed price
Billing
Charged only for successful, non-empty resultsthe charge is in meta.charged_usd
Scope
raw:xiaohongshuThe API key needs this scope
Rate cap
Account limit onlyYour per-minute limit
Parameters
Sent as query parameters
Only these parameters are accepted; any other one returns 400.
note_idstringRequired
Note ID (24 hex characters, the ID in xiaohongshu.com/explore/<ID>)
Pattern^[0-9a-f]{24}$
Example6a14846d000000000702d0d4
Response
A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.emptytrue, not charged, and data may be an empty structure or null.
This API key lacks the scope the endpoint requires.
endpoint_unavailable
503
Not charged
The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
invalid_params
400
Not charged
The parameters failed validation: a required one is missing, a type or format is wrong, an array has more items than allowed, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (item_id: …); a missing or unknown parameter starts with params: ….
rate_limitedRetryable
429
Not charged
Over the account's per-minute limit (sliding 60-second window); wait for Retry-After.
too_many_unbilledRetryable
429
Not charged
In the last 10 minutes at least 50 of your calls to data sources, and over 80% of them, came back empty, not found or rejected; slow down.
insufficient_balance
402
Not charged
The balance cannot pay for this call; top up first.
upstream_busyRetryable
503
Refunded
The data source is busy or cooling down; refunded. Retry after Retry-After.
upstream_timeout
504
Refunded
The data source timed out; refunded.
upstream_error
502 / 503
Refunded
The data source failed; refunded.
upstream_rejected
400
Refunded
The data source rejected these parameters (well-formed, but not accepted); refunded.
not_found
404
Refunded
The data source has no such item (deleted, or the ID does not exist); refunded.
reservation_expired
504
Refunded
The call took too long and was refunded automatically; no data is returned.
Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.