Social data API · integration guide
Xiaohongshu API: search notes, details and comments
Retrieve available public Xiaohongshu notes, comments and profile data through ChinaAPI. This API can support content research and retrieval workflows; the live capability table defines what is actually offered.
Search notes with the documented filter values
Some filters use literal Chinese values even when your application is in English. Send the exact enum or example in the reference. Translate a display label in your UI, but preserve the API value sent over the wire.
Use note identifiers and URLs correctly
Search responses provide the information needed to select a note. Check whether the chosen detail endpoint expects a note ID or accepts a URL alternative. Do not assume a shortened sharing link works wherever an ID is required.
Plan for visibility changes and incomplete comments
A note or comment may become unavailable between search and detail retrieval. Handle an empty result as an end condition, retain the collection time, and avoid presenting a limited comment sample as the complete discussion.
Trending is not currently offered
The Xiaohongshu trending route is excluded from the published catalog. Use the supported search workflow rather than building against a missing hot-list endpoint. The reference below is generated only from available capabilities.
Available endpoints and USD prices
Per successful synchronous call. First top-up required. Captured 2026-10-29T17:56:18Z from the public catalog.
| Capability | Endpoint | USD / call |
|---|---|---|
| Search posts | GET /v1/social/xiaohongshu/search | $0.02 |
| Post details | GET /v1/social/xiaohongshu/post | $0.02 |
| Profiles | GET /v1/social/xiaohongshu/user | $0.02 |
| Comments | GET /v1/social/xiaohongshu/comments | $0.02 |
| User posts | GET /v1/social/xiaohongshu/user-posts | $0.02 |
Request example
curl --fail-with-body --get "https://api.chinaapi.ai/v1/social/xiaohongshu/search" \
-H "Authorization: Bearer $CHINAAPI_API_KEY" \
--data-urlencode 'keyword=美食推荐'Keep the key server-side. Replace resource identifiers with the content you intend to retrieve.
Billing and limits
Beta: paid accounts only. Complete your first top-up before calling this API. Trial credits cannot be used for social-data requests. This beta has no SLA and platform coverage may change.
You must comply with each platform's terms and applicable data rules. Do not use this API to build personal profiles. Login, contact extraction, engagement manipulation, and private or paid-content access are outside this beta.
Calls use your existing ChinaAPI key and balance. Synchronous calls charge only for HTTP 200 with data. Async POST creation reserves the price; failed or empty tasks are refunded, and GET task reads are free. Empty or failed results are not charged. A daily beta budget may return HTTP 429; retry after the UTC day resets. Repeating a successful synchronous request creates another billable call. Retry async creation with the same Idempotency-Key to avoid duplicate submissions.
Every successful page is separately billed. Prices and parameters can change; check the reference before deployment.