<!-- GENERATED BY scripts/gen_social_pages.py; DO NOT EDIT -->
# 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.

Canonical: https://chinaapi.ai/social-data-api/xiaohongshu/
Catalog captured: 2026-10-29T17:56:18Z
Price and availability source: https://dash.chinaapi.ai/api/social/catalog?lang=en&utm_source=chinaapi&utm_medium=social-catalog&utm_campaign=social-data-beta

[Create an account](https://dash.chinaapi.ai/register?lang=en&utm_source=chinaapi&utm_medium=social-social-data-api-xiaohongshu&utm_campaign=social-data-beta)

## 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

| Capability | Endpoint | USD / successful call |
| --- | --- | --- |
| [Search posts](https://chinaapi.ai/social-data-api/docs/#xiaohongshu-search) | `GET /v1/social/xiaohongshu/search` | $0.02 |
| [Post details](https://chinaapi.ai/social-data-api/docs/#xiaohongshu-post) | `GET /v1/social/xiaohongshu/post` | $0.02 |
| [Profiles](https://chinaapi.ai/social-data-api/docs/#xiaohongshu-user) | `GET /v1/social/xiaohongshu/user` | $0.02 |
| [Comments](https://chinaapi.ai/social-data-api/docs/#xiaohongshu-comments) | `GET /v1/social/xiaohongshu/comments` | $0.02 |
| [User posts](https://chinaapi.ai/social-data-api/docs/#xiaohongshu-user-posts) | `GET /v1/social/xiaohongshu/user-posts` | $0.02 |

First top-up required. Recheck the live catalog before integration.

## Request example

```bash
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 before running.

## Billing and limits

First top-up required; trial credit is excluded. No SLA. Synchronous empty or failed results are not charged. Every successful page is separately billed. Follow platform terms; personal profiling and private-content access are excluded.

[Full reference](https://chinaapi.ai/social-data-api/docs/)

## Related guides

- [Douyin API: video search, comments and replies](https://chinaapi.ai/social-data-api/douyin/index.md)
- [Bilibili API: search videos and retrieve public discussion](https://chinaapi.ai/social-data-api/bilibili/index.md)
- [Weibo API: keyword search, posts, comments and trends](https://chinaapi.ai/social-data-api/weibo/index.md)
- [Xiaohongshu API: search notes, details and comments](https://chinaapi.ai/social-data-api/xiaohongshu/index.md)
- [Collect comments with bounded pagination](https://chinaapi.ai/social-data-api/guides/comment-pagination/index.md)
- [Build an MCP social research workflow](https://chinaapi.ai/social-data-api/guides/mcp-research/index.md)