Xiaohongshu (RedNote) scraper API
The InsightSocial Xiaohongshu (RedNote) API has 6 endpoints, from 50 credits a call. A profile call costs 50 credits, about $0.05 on Pro, and your first 10 calls up to 100 credits each are free.
The Xiaohongshu (RedNote) scraper API for public creators, notes, comments and keyword search, as JSON, plus the live hot-search board. No merchant account needed.
6 endpoints · from 50 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/xiaohongshu/profile?url=https%3A%2F%2Fwww.xiaohongshu.com%2Fuser%2Fprofile%2F5f0000000000000000000001" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Xiaohongshu (RedNote) data can you get?
Public Xiaohongshu (RedNote) data only, returned in the same JSON envelope as every other platform.
Creator profiles
Display name, RedNote ID, bio, followers, following, notes posted, likes received and the IP province the platform shows.
Notes
A creator's notes, newest first, and one note in full with its body text, images or video, and like, comment, save and share counts.
Comments
Top-level comments under a note with likes, reply count, pin flag and the commenter's IP province.
Xiaohongshu (RedNote) API endpoints
All 6 Xiaohongshu (RedNote) endpoints and their price in credits. 4 are metered: they show a range and charge what the call actually read.
| Endpoint | Credits | What it returns |
|---|---|---|
| /search | 50–1,000 | Returns Xiaohongshu notes matching a keyword: title, short summary, creator, likes, comments, saves, shares, and cover image. |
| /trending | 50–1,000 | Returns the live Xiaohongshu hot search board: ranked topics with a hot value. |
| /profile | 50 | Returns a Xiaohongshu (RedNote) creator's profile: display name, RedNote ID, bio, avatar, followers, following, notes posted, likes received, and IP province. |
| /profile/posts | 50–1,000 | Returns a Xiaohongshu creator's notes, newest first: title, short summary, engagement counts, and pinned flag. |
| /post | 50 | Returns one Xiaohongshu note in full: body text, images or video, creator, likes, comments, saves, shares, and the IP province. |
| /post/comments | 50–1,000 | Returns top-level comments on a Xiaohongshu note: text, commenter, likes, reply count, pin flag, and the commenter's IP province. |
Parameters, response fields and examples for each endpoint are in the Xiaohongshu (RedNote) API reference.
InsightSocial vs the official Xiaohongshu (RedNote) API
Xiaohongshu's open platform is built for merchants and the service providers that build apps for their shops, around orders, products, inventory and after-sales.
| InsightSocial API | Official Xiaohongshu (RedNote) API | |
|---|---|---|
| Who it serves | Anyone reading public notes | Merchants and service providers |
| What it covers | Creators, notes, comments and search | Shop operations: orders, products, inventory |
| Setup | Sign in and copy a key | Developer account, an app and interface permissions |
| Cost per call | 50 credits | No per-call price; built for merchants and their service providers |
The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.
How much does the Xiaohongshu (RedNote) API cost?
Xiaohongshu (RedNote) calls start at 50 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 200 profiles at 50 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats and retries
A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Xiaohongshu (RedNote) data in plain English. Same account, same credits.
Xiaohongshu (RedNote) API: frequently asked questions
It has an open platform for merchants and the service providers that build apps for their shops, covering orders, products, inventory and after-sales. It is not designed for reading public notes or creator profiles; the InsightSocial API is.
Yes. /v1/xiaohongshu/search takes a keyword in Chinese or English, sorts by relevance, newest, most liked, most commented or most saved, and filters by image or video notes and by recency.
No. Search and a creator's note list carry the title and a short summary. Pass a note URL or id to /v1/xiaohongshu/post for the full body text, images or video, and engagement counts.
/v1/xiaohongshu/post/comments returns the top-level comments, page by page, with likes, reply count and the commenter's IP province. Reply threads under a comment are not expanded on this call.
A profile is 50 credits, and so is one note in full. Search, a creator's notes, comments and the hot-search board are metered: they quote a range and charge what the call read. Calls that fail or find nothing are free.
No. There is no Xiaohongshu (RedNote) app, OAuth flow or review. One API key in the x-api-key header works for Xiaohongshu (RedNote) and the other 60 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Xiaohongshu (RedNote)'s terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Xiaohongshu (RedNote) API guides
The same key works for 60 more platforms
- TikTok scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API
- Amazon scraper API
- App Store scraper API
- Apple Music scraper API
- Behance scraper API
- Dailymotion scraper API
- Deezer scraper API
- DEV Community scraper API
- Discord scraper API
- Dribbble scraper API
- Fandom scraper API
- Flickr scraper API
- GitHub scraper API
- Google Ads Transparency scraper API
- Google News scraper API
- Google Trends scraper API
- Gumroad scraper API
- Hacker News scraper API
- Hugging Face scraper API
- Ko-fi scraper API
- Lemmy scraper API
- Letterboxd scraper API
- Linktree scraper API
- Lnk.Bio scraper API
- Mastodon scraper API
- Medium scraper API
- MyAnimeList scraper API
- npm scraper API
- Polymarket scraper API
- Product Hunt scraper API
- Shopify scraper API
- SoundCloud scraper API
- Spotify scraper API
- Stack Overflow scraper API
- Stan Store scraper API
- Steam scraper API
- Vimeo scraper API
- Wikipedia scraper API
- Yahoo Finance scraper API
- Yelp scraper API