Xiaohongshu (RedNote) API
Scrape Xiaohongshu (小红书, RedNote, XHS, Little Red Book): search notes, topic feeds, note details, comments and replies, creator profiles, shop products and reviews. Commenters come with user ID, RED ID, avatar and IP location. No login or cookies needed. Export to JSON, CSV or Excel.
Xiaohongshu API in one table
| Official public API for people outside China | No. This tool collects the publicly visible data instead. |
|---|---|
| What you send | A keyword, a link or an ID, depending on the request type |
| What you get back | JSON rows with English field names; 18 request types |
| Login, cookies, Chinese phone number | None needed |
| Output formats | JSON, CSV, Excel, or the Apify API |
| Price | $0.0046 per result on the Bronze tier, no subscription |
| Last verified with a real run | 2026-11-09 |
18 kinds of Xiaohongshu request
Xiaohongshu (小红书, xiaohongshu.com), called RedNote in English, is China's leading lifestyle and shopping-discovery community. Users publish notes (image or video posts with text and hashtags) about topics such as beauty, food, travel and fashion, and the platform also has a shop with products and buyer reviews. Every user has a RED ID, and the platform shows an IP location (province or country) on notes and comments.
- Search notes by keyword
- Note details
- Note comments
- Creator profile + recent notes
- Search products by keyword
- Product reviews
- Notes under a topic
- Comments with all replies
- A creator's public saved notes
- Search creators by keyword
- Search images by keyword
- Search group chats by keyword
- Products similar to a product
- Product details
- Creator-centre trends
- Discover page by channel
- Search suggestions for a keyword
- Hot notes board for a keyword
A real run, 22 fields per record
Run on 2026-10-26 with input {"mode": "search", "maxResults": 5, "keyword": "咖啡"}. Personal fields of ordinary users are masked here.
| title | description | likes | comments | collects | shares |
|---|---|---|---|---|---|
| 乌龙拿铁|茶咖脑袋本命!清爽不腻太上头 | 谁懂啊!乌龙茶的清冽+咖啡的醇厚+牛奶的丝滑 一口下去茶香回甘,完全不苦不腻 比纯拿铁清爽,比纯奶茶提神 早八续命、下午 | 18728 | 365 | 16349 | 7825 |
| 🌿福州新店!!拥有绿色窗台的小木屋咖啡店 | 这个窗景谁能不喜欢呀!每个窗口都能看到大片的绿色 找个悠闲的时间段慢慢来感受 真的很舒服 感觉也很适合自习!!! 我最喜 | 695 | 61 | 521 | 1177 |
All 22 fields in one record
typenotenoteId69d4809b0000000023013094urlhttps://www.xiaohongshu.com/explore/69d4809b0000000023013094noteTypevideotitle乌龙拿铁|茶咖脑袋本命!清爽不腻太上头description谁懂啊!乌龙茶的清冽+咖啡的醇厚+牛奶的丝滑 一口下去茶香回甘,完全不苦不腻 比纯拿铁清爽,比纯奶茶提神 早八续命、下午authorNameauthorIdauthorRedIdauthorAvatarauthorIpLocationauthorVerifiedauthorUrlpublishedAt2026-04-07T03:57:15Zlikes18728collects16349comments365shares7825coverUrlhttps://sns-i11.rednotecdn.com/1040g2sg31ul6sapt2s005oji8...imageCountdurationSeconds27hashtags
Need only one kind of Xiaohongshu data?
These smaller tools do one job each, with fewer settings.
Xiaohongshu 小红书 Search Scraper (RedNote)
Search Xiaohongshu (小红书, RedNote) notes by keyword: title, text, images, video, likes, favorites, comments, tags and author. No login or coo
Xiaohongshu 小红书 Comments Scraper (RedNote) | No Login
Scrape comments of Xiaohongshu (小红书, RedNote) notes with replies: text, likes, time, IP location and commenter profile. Paste note links, xh
Xiaohongshu 小红书 User Scraper (RedNote) | No Login
Get Xiaohongshu (小红书, RedNote) creator profiles and their notes: nickname, bio, followers, likes and favorites, IP location, then each note
Call the Xiaohongshu API
Every run is one HTTP call: send the input as JSON, get the rows back. The same works from Make, Zapier or n8n.
Pay per result
Bronze tier prices from the tool's listing; higher Apify tiers pay less. Free Apify users get two trial runs with their own input.
Full price table and worked examples
The Actor uses pay-per-event pricing: a small start fee per run plus a fee per item returned. Prices depend on your Apify plan tier.
| Event | What it covers | Bronze | Silver | Gold, Platinum, Diamond |
|---|---|---|---|---|
| Run start | charged once per run, when the first request succeeds. Mode hotNotes charges it 3 times ($0.00015) |
$0.00005 | $0.00005 | $0.00005 |
| Result | one note, creator, group, trend, suggestion or product from a list, one comment or reply, one review | $0.0046 | $0.0042 | $0.0038 |
| Detail | one full note from mode note, one productDetail, reviewSummary or topicInfo record |
$0.0184 | $0.0166 | $0.015 |
| Profile | one creator profile | $0.0184 | $0.0166 | $0.015 |
Worked examples:
- 100 search notes or comments on Bronze: $0.00005 + 100 x $0.0046 = about $0.46. On Gold or higher: $0.00005 + 100 x $0.0038 = about $0.38.
- 34 hot notes (
hotNotes, one board page) on Bronze: 3 x $0.00005 + 34 x $0.0046 = about $0.16. - 20 creators from
userSearchon Bronze: $0.00005 + 20 x $0.0046 = about $0.09. - 10 note details on Bronze: $0.00005 + 10 x $0.0184 = about $0.18.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
The run-start fee is charged once per run, when the first request succeeds, even if that request returns nothing and the run ends with few or no items. It is not charged when the run fails from the start or rejects the IDs (for example, when every note or creator ID you give is invalid), or when the spending limit cannot cover it. Items are charged only when they are actually returned. Set a maximum cost per run in the run options and the Actor stops when it is reached.
Xiaohongshu API questions
Do I need a Xiaohongshu account or cookies?
No. No login, cookies, proxies or Chinese-language skills are needed.
Is it legal, and does it collect personal data?
The Actor only returns publicly visible information. That includes the public profile of users who appear in the results (user ID, RED ID, avatar, IP location, gender and verification, as published on the platform). Private messages and anything not publicly visible are never collected. Bios are returned as published, including any business contact info the creator put there. You are responsible for using the data in line with applicable laws and Xiaohongshu's terms.
How fresh is the data?
The data is collected when you start a run, so counts such as likes and followers reflect that moment. Schedule runs if you want to track changes over time.
Why is IP location or another field empty?
The platform does not return every field for every item. In those cases the field is `null` (or `[]` for list fields): that's the platform's data, not a failed run. See the list under Tips and limits.
How many results can I get?
Up to 5,000 items per run with `maxResults`.
Why is a note detail priced higher than a search result?
A detail needs its own lookup per note, while list pages return many notes at once.