> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/xiaohongshu>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/xiaohongshu.mdx>

---

# Xiaohongshu API. RedNote creators and notes as JSON.

Look up a Xiaohongshu creator, list the notes on their profile, and open any note with its images, video, counts and top comments. Every response uses the same envelope.

- Profiles + notes
- Comments
- 1 credit per request

`GET /v1/xiaohongshu/profiles/{profileId}` returns a Xiaohongshu (RedNote) creator: name, account number, bio with its English translation, region, tags, verification, and the creator's note count with the likes and saves their notes received. `/v1/xiaohongshu/profiles/{profileId}/notes` lists the notes the profile shows, about 30, with title, type, cover, likes and date.

`GET /v1/xiaohongshu/notes/{noteId}` opens one note with its text, topics, mentions, images or video, and its likes, saves, comments and shares; `/comments` returns its top comments with their first replies and the note's comment totals. Every answer is JSON in the `{ data, meta }` envelope with `data.lookupStatus`; lists say with `page.truncated` and `page.total` when the note or creator has more than one page shows. A miss comes back as `lookupStatus: not_found`, not as an HTTP error.

Most notes open only with the `xsec_token` of the link they were shared with: pass the whole note link or its xhslink.com share link, or the id with `xsecToken`. A note Xiaohongshu won't show without its token answers 400, with no charge.

## What you can get

- Creator profile with bio, English translation, tags, verification and exact like and save totals.
- The notes a creator's profile shows, with title, type, cover, likes and date.
- Single notes with text, topics, mentions, images or video, and their counts.
- Top comments on a note with their first replies and the true comment totals.

## Xiaohongshu endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile | GET /v1/xiaohongshu/profiles/{profileId} | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/xiaohongshu/profiles/profileid/get) |
| Profile notes | GET /v1/xiaohongshu/profiles/{profileId}/notes | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/xiaohongshu/profiles/profileid/notes/get) |
| Note | GET /v1/xiaohongshu/notes/{noteId} | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/xiaohongshu/notes/noteid/get) |
| Note comments | GET /v1/xiaohongshu/notes/{noteId}/comments | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/xiaohongshu/notes/noteid/comments/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every route on a few creators.
2. **Pick the creator or note.** Use the profile id from a profile link (xiaohongshu.com/user/profile/5c4a8f94000000001003f8c1). For a note, pass its whole link with the `xsec_token` in it, or its xhslink.com share link: most notes open only with that token. Send `x-api-key` on every request.
3. **Branch on the answer.** Check `data.lookupStatus` before you store a row, read `page.truncated` on lists, and bill from `meta.creditsCharged`.

## Pricing

Each Xiaohongshu route charges a flat credit amount per completed request, shown on every endpoint page. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Social Fetch gives every Xiaohongshu route one JSON shape: ISO 8601 UTC timestamps, numeric counts read from the site's own labels (`9.4万` and `94.3K` read 94000 and 94300), topics written as `#name`, English translations where the site has them, and typed `lookupStatus` responses. You do not need a Xiaohongshu account, an app registration or a user session.

## FAQ

### What Xiaohongshu data can I get from the API?

Creator profiles, the notes a creator's profile shows, single notes with their text, images or video and counts, and the top comments on a note with their first replies.

### Is this the same as RedNote?

Yes. RedNote is the international name of Xiaohongshu, and the same creators and notes are on both. Links from either site work.

### How do I name a creator or a note?

For a creator, use the 24-character id after /user/profile/ in their link, or the whole link. For a note, pass its whole link or its xhslink.com share link: Xiaohongshu shows most notes to visitors who are not signed in only with the xsec_token in the link they were shared with. A bare note id works with that token as xsecToken, or alone for the notes Xiaohongshu currently promotes. A note it refuses without a token answers 400 and costs nothing.

### Why are follower counts ranges?

Xiaohongshu shows followers to visitors who are not signed in only as a band, such as 10K+. The API returns that band as followersAtLeast and followersLabel. Note, like and save totals are exact.

### Can I get every note of a creator, or every comment?

The notes route returns the notes the profile shows, about 30, and the comments route the top 5 comments with their first replies. Both say page.truncated: true and give page.total when there are more.

### Why do most notes in a creator list have no id?

Xiaohongshu hides note ids in creator lists from visitors who are not signed in, and gives no token that opens them. The last note of each list carries its id; open a note by its share link to get everything about it.

### Can I store the image and video links?

No. Image, cover and video links are signed and expire. Download the files if you need them; the note page url stays valid.

### How much does the Xiaohongshu API cost?

Every Xiaohongshu route charges a flat amount per completed request, shown on each endpoint page. A found or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Xiaohongshu Profile API](https://www.socialfetch.dev/platforms/xiaohongshu/profiles-profileid): Bio, tags, verification and totals (`GET /v1/xiaohongshu/profiles/{profileId}`).
- [Xiaohongshu Profile Notes API](https://www.socialfetch.dev/platforms/xiaohongshu/profiles-profileid-notes): The notes a creator's profile shows (`GET /v1/xiaohongshu/profiles/{profileId}/notes`).
- [Xiaohongshu Note API](https://www.socialfetch.dev/platforms/xiaohongshu/notes-noteid): One note with media and counts (`GET /v1/xiaohongshu/notes/{noteId}`).
- [Xiaohongshu Note Comments API](https://www.socialfetch.dev/platforms/xiaohongshu/notes-noteid-comments): Top comments with first replies (`GET /v1/xiaohongshu/notes/{noteId}/comments`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Xiaohongshu question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Xiaohongshu tools from Cursor or Claude with the same credit metering as REST.
