Data APIs / Xiaohongshu (RedNote)
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 | One note: title, text, tags, cover, author, and its likes, saves, comments and shares | $0.02 |
| Xiaohongshu creator notes | A creator's notes, newest first, page by page | $0.02 |
| Xiaohongshu note 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 | Comments under a note: text, time, commenter, likes and reply count, page by page | $0.02 |
| Xiaohongshu comment replies | 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 | A creator: name, RED ID, bio, avatar, followers, following and likes received | $0.02 |
| Xiaohongshu account 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 | 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 | 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 | 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 | 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 | A blogger’s impressions, reads, engagements, CPM, CPE and CPV for each of the last 30 days | $0.04 |
| PGY blogger follower profile | Who follows a blogger: gender, age, province, city, device and interests, with shares | $0.04 |
| PGY blogger follower quality | A blogger’s followers over 30 days: gained, active, engaged, reading and paying followers, with rates | $0.04 |
| PGY blogger follower history | A blogger’s follower count for each of the last 30 days | $0.04 |
| PGY blogger notes | 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 | Bloggers PGY recommends as similar: followers and picture and video rates, 4 a page | $0.04 |
| PGY note figures | The figures PGY shows a brand for one note: title, text, impressions, reads, likes, saves, comments and shares | $0.04 |
| PGY trending notes | 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 | 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 | 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 | 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 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 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.