<p class="crumbs"><a href="/apis/">Data APIs</a> / Xiaohongshu (RedNote)</p>

# Xiaohongshu (RedNote) data API

22 Xiaohongshu (RedNote) endpoints: posts, comments, accounts, search and trending, from $0.02 a call. Failures are free. No Xiaohongshu (RedNote) account needed.

## The 22 endpoints

### Posts (3)

| Endpoint | What you get | Per call |
| --- | --- | --- |
| [Xiaohongshu note](/apis/xiaohongshu/notes/get/) | One note: title, text, tags, cover, author, and its likes, saves, comments and shares | $0.02 |
| [Xiaohongshu creator notes](/apis/xiaohongshu/users/notes/list/) | A creator's notes, newest first, page by page | $0.02 |
| [Xiaohongshu note search](/apis/xiaohongshu/notes/search/) | Search notes by keyword, ordered by relevance, newest or most liked, within a time range | $0.02 |

### Comments (2)

| Endpoint | What you get | Per call |
| --- | --- | --- |
| [Xiaohongshu note comments](/apis/xiaohongshu/notes/comments/list/) | Comments under a note: text, time, commenter, likes and reply count, page by page | $0.02 |
| [Xiaohongshu comment replies](/apis/xiaohongshu/notes/comments/replies/list/) | Replies under one Xiaohongshu comment: text, time, author and likes, page by page | $0.02 |

### Accounts (2)

| Endpoint | What you get | Per call |
| --- | --- | --- |
| [Xiaohongshu creator profile](/apis/xiaohongshu/users/get/) | A creator: name, RED ID, bio, avatar, followers, following and likes received | $0.02 |
| [Xiaohongshu account search](/apis/xiaohongshu/users/search/) | Find Xiaohongshu accounts by keyword: user ID, RED ID, name, bio, avatar, verification and followers, 20 a page | $0.02 |

### Creator marketing (PGY) (15)

| Endpoint | What you get | Per call |
| --- | --- | --- |
| [PGY blogger search](/apis/xiaohongshu/pgy/creators/search/) | Find Xiaohongshu bloggers on PGY by note content or name: followers, picture and video rates, read and engagement medians, cost per read, video completion and follower growth, 20 a page | $0.04 |
| [PGY blogger profile](/apis/xiaohongshu/pgy/creators/get/) | A blogger on PGY: name, RED ID, location, tags, followers, likes and saves, sponsored notes, picture and video rates and agency | $0.04 |
| [PGY blogger overview](/apis/xiaohongshu/pgy/creators/metrics/) | PGY’s core figures for a blogger: impression, read and engagement medians, expected CPM, CPE and cost per read for pictures and videos, 30-day follower growth and response rate | $0.04 |
| [PGY blogger note performance](/apis/xiaohongshu/pgy/creators/performance/) | How a blogger’s notes did over 30 days: median impressions, reads, engagements, likes, saves, comments and shares, engagement rate, video completion, 3-second picture views and share of notes over 100 and 1,000 likes | $0.04 |
| [PGY blogger daily figures](/apis/xiaohongshu/pgy/creators/costs/history/) | A blogger’s impressions, reads, engagements, CPM, CPE and CPV for each of the last 30 days | $0.04 |
| [PGY blogger follower profile](/apis/xiaohongshu/pgy/creators/followers/get/) | Who follows a blogger: gender, age, province, city, device and interests, with shares | $0.04 |
| [PGY blogger follower quality](/apis/xiaohongshu/pgy/creators/followers/metrics/) | A blogger’s followers over 30 days: gained, active, engaged, reading and paying followers, with rates | $0.04 |
| [PGY blogger follower history](/apis/xiaohongshu/pgy/creators/followers/history/) | A blogger’s follower count for each of the last 30 days | $0.04 |
| [PGY blogger notes](/apis/xiaohongshu/pgy/creators/notes/list/) | Eight of a blogger’s notes (newest, most read or most engaged) with PGY’s impressions, reads, engagements and saves, plus the brand behind sponsored ones | $0.04 |
| [PGY similar bloggers](/apis/xiaohongshu/pgy/creators/similar/list/) | Bloggers PGY recommends as similar: followers and picture and video rates, 4 a page | $0.04 |
| [PGY note figures](/apis/xiaohongshu/pgy/notes/get/) | The figures PGY shows a brand for one note: title, text, impressions, reads, likes, saves, comments and shares | $0.04 |
| [PGY trending notes](/apis/xiaohongshu/pgy/notes/trending/) | PGY’s content square boards (Xiaohongshu hot, product seeding, e-commerce, PGY collaborations and more), over the last 3–30 days, with reads, likes, saves and comments | $0.04 |
| [PGY keyword overview](/apis/xiaohongshu/pgy/keywords/metrics/) | A keyword on Xiaohongshu over 30 days: search index, notes, creators, impressions, reads and engagements, with change on the previous period | $0.04 |
| [PGY keyword daily index](/apis/xiaohongshu/pgy/keywords/history/) | A keyword’s search index, notes, creators, impressions, reads and engagements for each day of about the last three months | $0.04 |
| [PGY related keywords](/apis/xiaohongshu/pgy/keywords/related/) | What people search on Xiaohongshu before and after a keyword, with each word’s search index, for topic ideas | $0.04 |

## A typical use and its bill

One page of comments under a Xiaohongshu (RedNote) post (the platform decides how many, usually 10–40): $0.02 a page, billed per page.

## Use it in your AI

With the [MCP server](/mcp/) installed, you can say:

- "What are people complaining about under this Xiaohongshu (RedNote) post? Top 20 by likes."
- "How did this Xiaohongshu (RedNote) account's last 10 posts do?"
- "What is trending on Xiaohongshu (RedNote) right now?"

## Questions

### How much does the Xiaohongshu (RedNote) API cost?

From $0.02 a call; each endpoint has its own price, listed above. Failures, timeouts and missing objects are free. New accounts get trial credit, no card needed.

### Do I need a Xiaohongshu (RedNote) account?

No. Only public data is read; no platform account, cookie or authorisation is needed.

### Where do I find the IDs?

A note ID is the part after /explore/ in a note link; a share link (xhslink.com) works too.

### How fresh is the data?

Each call reads the platform at that moment; `meta.fetched_at` says when.

### How do I let Claude or Cursor read Xiaohongshu (RedNote)?

Install the [FeedMCP MCP server](/mcp/) in your AI and just ask; it picks the endpoint and calls it.

### Can this get my account banned?

No. Calls do not go through your account.

---

HTML version: https://feedmcp.com/apis/xiaohongshu/
