Search Xiaohongshu notes by keyword, returned as the platform answers, in JSON: items (each with a note card: title, author, interaction counts, cover and images) and more. Only the first page (about 20 notes) is returned and there is no paging parameter. Sort by relevance, newest, most liked, most commented or most saved; filter by note type; the publish-time filter offers all, a day or a week only. Only an answer with data is charged; an empty answer or an error is not.
Typical uses: Tracking trends and topics, monitoring keywords and following competitors.
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 limit
NoneNo per-account or per-endpoint request limit
Parameters
Sent as query parameters
Only these parameters are accepted; any other one returns 400.
keywordstringRequired
Search keyword
Max 50 charsPattern\S
Example咖啡
sortstring · enum
Order: general (relevance, the default), latest, most_liked, most_commented or most_saved
Note type: all (the default), video or image notes
DefaultallOne ofall · video · image
note_timestring · enum
Published within: all (the default), a day or a week
DefaultallOne ofall · day · week
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: ….
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.