RedNote Xiaohongshu 小红书 Scraper API — Notes & Transcripts
Pricing
from $4.00 / 1,000 notes
RedNote Xiaohongshu 小红书 Scraper API — Notes & Transcripts
RedNote scraper and unofficial Xiaohongshu (XHS / 小红书) API: category feeds, full note details with images, video links, subtitles and transcripts, creator profiles, comment threads, keyword search and suggestions — 8 modes, six need no login. Export JSON, CSV, Excel. From $3.50/1k notes.
Pricing
from $4.00 / 1,000 notes
Rating
0.0
(0)
Developer
Raven
Maintained by CommunityActor stats
0
Bookmarked
8
Total users
4
Monthly active users
a day ago
Last modified
Categories
Share
RedNote (Xiaohongshu / 小红书) Scraper | Notes, Creators, Comments & Keywords — No Login (2026)
Scrape RedNote / Xiaohongshu (小红书 · XHS · Little Red Book · RED) without an account, a cookie or a browser. Trending category feeds, full note payloads (caption, every image, direct video links, video subtitle tracks and spoken-text transcripts, hashtags, region, exact engagement), creator profiles with followers, 小红书号, profession and country, comment threads with replies, and RedNote's own keyword suggestions — from $4 per 1,000 notes, streamed straight into a dataset you can export to JSON, CSV, Excel or XML.
Six of the eight modes need no login at all. No cookie export, no QR scan, no API key, no proxies to buy, no code.

| Raven · Social-commerce suite • RedNote, TikTok Shop, AliExpress, Instagram | |||
|
➤ You are here |
Products, stores, creators |
Products, variants, reviews |
Posts, followers, comments |
Copy to your AI assistant
Apify Actor: pro100chok/rednote-xiaohongshu-scraperWhat it does: scrapes RedNote / Xiaohongshu (小红书) — category feeds, full note details(images + video URLs + subtitle tracks + spoken-text transcripts + hashtags + engagement),creator profiles, comment threads, keyword suggestions. Six of eight modes require nologin or cookie.Run it from Python:from apify_client import ApifyClientclient = ApifyClient("<YOUR_APIFY_TOKEN>")run = client.actor("pro100chok/rednote-xiaohongshu-scraper").call(run_input={"scrapeType": "discoverFeed","feedCategories": ["food", "beauty"],"maxItems": 100,"fullNoteDetail": True})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item)Modes: discoverFeed | noteDetails | noteComments | userProfiles | userNotes |keywordResearch | searchNotes* | searchUsers* (* need a cookie)Input schema: https://api.apify.com/v2/acts/pro100chok~rednote-xiaohongshu-scraper/builds/defaultGet a token: https://console.apify.com/settings/integrations
What does this RedNote (Xiaohongshu) scraper do?
RedNote has no public content API for third parties — its open platform is limited to business and advertising integrations, so there is no official endpoint that hands you notes, creators or comments. This actor is the practical unofficial Xiaohongshu API: one actor, eight operations, one flat dataset.
| Mode | What you get | Login needed? |
|---|---|---|
🔥 discoverFeed | Trending notes from 12 RedNote category channels (food, beauty, fashion, travel, fitness, gaming, home, career, relationships, movies, video, recommended), paginated by cursor for as many notes as you ask for | No |
📝 noteDetails | Full payload for the exact notes you paste: caption, every image, direct video links, hashtags + topic IDs, region, mentions, exact counters, edit time | No |
💬 noteComments | Comment threads with replies as separate linked rows, commenter profile, likes, region | No |
👤 userProfiles | Creator profile: followers, following, likes+saves, 小红书号 (RedNote handle), bio, gender, region, profile tags | No |
📚 userNotes | A creator's profile plus their recent posts (titles, covers, likes, dates, post type) | No |
🔎 keywordResearch | RedNote's own search suggestions for any seed keyword, expandable into a long-tail map | No |
🔍 searchNotes | Keyword search over notes, with sort + post-type + date filters | Cookie |
🔍 searchUsers | Keyword search over creators | Cookie |
Every row streams into the dataset the moment it is parsed, so an aborted run keeps everything already collected.
Why use this scraper?
- ✅ No account, no cookie, no QR login for feeds, note details, comments, profiles, creator notes and keyword research. The actor gets its own anonymous guest session automatically.
- ✅ 46 fields on a photo note, 82 on a video note (measured medians over live notes), 30 on a creator profile, up to 28 on a comment — 156 documented fields in total.
- ✅ Counters you can actually sort by. RedNote prints
10万+; you get bothlikesText: "10万+"andlikes: 100000, plus a pre-computedengagementTotal. - ✅ Direct video links with duration, resolution, fps, file size, codec, audio track and mirror URLs — every rendition RedNote exposes (h264 / h265 / av1 when present), plus the source resolution before transcoding and the cover / first-frame stills.
- ✅ Video subtitles and transcripts. Every subtitled video comes back with its subtitle tracks (
.srtURL per language, typicallyzh-CN+en-US); switch on Also download video transcripts and the spoken text lands in the row astranscript. - ✅ Image links that do not expire. Alongside RedNote's own signed, time-limited URLs you also get
imageUrlsOriginal/coverUrlOriginal/videoThumbnailUrl— id-based CDN links to the un-resized originals that keep working long after the run. - ✅ Access tokens handed back to you. Every note and profile row carries its
xsecToken, so you can re-run or chain modes later without re-copying links. - ✅ No headless browser. Plain HTTP requests — no Chromium, no captcha overhead.
- ✅ You are never charged for a failed row. Inputs that cannot be opened come back as an explanatory row at zero cost.
- ✅ Share links work. Paste
xhslink.com/...and the actor resolves it for you.
| Official RedNote API | Typical store scrapers | This actor | |
|---|---|---|---|
| Access to note/creator data | Not offered to third parties | Yes | Yes |
| Works with no login | — | Usually requires your session cookie | 6 of 8 modes, cookie-free |
| Operations per actor | — | Often one (search or comments or profiles) | 8 in one |
| Parsed numeric counters | — | Usually the raw 1.9万 string only | String + integer |
| Video renditions | — | Often one URL | Every variant + mirrors + audio track |
| Video subtitles / transcripts | — | Sold as a separate actor | Included, all languages |
| Non-expiring original image links | — | Signed links only | Both |
| Keyword suggestion research | — | Rarely offered | Included |
| Charged for error rows | — | Sometimes | Never |
| Full note detail per 1,000 | — | $8–$20 | $5.00, from $3.50 |
What data can you extract from RedNote?
Notes (discoverFeed, noteDetails, userNotes, searchNotes)
- Identity —
noteId,noteUrl,xsecToken,noteType(image/video/live),pinned(creator pinned it to their profile) - Content —
title,description,hashtags[],hashtagCount,topics[](id + name + type),topicIds[] - Engagement —
likes,collects,commentsCount,shares,niceCount,engagementTotal, pluslikesText/collectsText/commentsText/sharesTextexactly as RedNote displays them - Timing —
publishedAt,publishedTimestamp,lastUpdatedAt,lastUpdatedTimestamp - Author —
authorId,authorName,authorAvatar,authorUrl,authorXsecToken - Images —
imageCount,coverUrl,coverUrlPreview,coverUrlOriginal,imageUrls[],imageUrlsOriginal[],images[](url, non-expiring original, preview, width, height, fileId, live-photo flag). Up to 18 images seen on a single note. - Video —
videoUrl,videoBackupUrls[],videoStreams[],videoStreamCount,videoQualityLadder[],videoDuration,videoDurationMs,videoWidth,videoHeight,videoSourceWidth,videoSourceHeight,videoFps,videoSizeBytes,videoQuality,videoCodec,videoFormat,videoBitrate,videoAudioCodec,videoAudioBitrate,videoAudioChannels,videoId,videoMd5,videoHdrType,videoDrmType,videoStreamTypes[],videoThumbnailUrl,videoFirstFrameUrl - Subtitles & transcripts —
videoHasSubtitles,videoSubtitles[](track + language +.srtURL),videoSubtitleLanguages[],videoLanguages[],videoHasHumanVoice,transcriptSrtUrl, and with the transcripts add-ontranscript,transcriptLanguage,transcriptCharCount - Extras —
ipLocation(when RedNote publishes it for that note),atUsers[](with profile URL and token),atUserNames[],atUserCount,hasLivePhoto,livePhotoCount,shareDisabled
Creators (userProfiles, userNotes, searchUsers)
userId, profileUrl, xsecToken, nickname, redId (小红书号), description, followers + followersText + followersI18nText, following + followingText + followingI18nText, likesAndCollects + likesAndCollectsText + likesAndCollectsI18nText, gender, genderCode, ipLocation, location (country chip), profession, avatar, avatarLarge, tags[] (age, city, occupation, school, zodiac when public), tagDetails[] (each tag with its type and icon), verified, verifyType, collectionPublic, collectionNoteCount, collectionBoardCount, collectionFileCount, followStatus, blockType, notesCollected
Comments (noteComments, or the comment add-on)
commentId, noteId, noteUrl, content, likes + likesText, replyCount, hasMoreReplies, isReply, parentCommentId, rootCommentId, repliedToCommentId, repliedToUserId, repliedToUserName, repliedToUserUrl, authorId, authorName, authorAvatar, authorUrl, isNoteAuthor (the creator answering in their own thread), authorIsAiAgent, ipLocation, createdAt, createdTimestamp, status, invalid, showTags[], pictures[], atUsers[]
Keywords (keywordResearch)
keyword, suggestion, searchType, suggestionType, position
How to scrape RedNote step by step
- Click Try for free — an Apify account takes a few seconds and the free plan comes with $5 of monthly credits (about 1,000 fully-detailed notes).
- Pick a mode in the first field. It arrives on
discoverFeedwith the Recommended channel, so pressing Start straight away returns real notes. - Fill in only the field that belongs to your mode — categories for feeds, note links for note details or comments, profile links for creators, keywords for research. Get it the wrong way round and the run reads the field you filled in and switches to the matching mode rather than returning nothing; the log says when it does.
- Set Max results to cap the run precisely, then press Start.
- Watch rows land live in the Output tab, then export to JSON, CSV, Excel, XML or HTML, or pull them from the API.
Accepted inputs — what to paste where
| You have | Paste it into | Works |
|---|---|---|
https://www.xiaohongshu.com/explore/6a51b7...?xsec_token=ABz... | noteUrls | ✅ Best — the token in the link is the access key |
https://www.xiaohongshu.com/discovery/item/6a51b7...?xsec_token=... | noteUrls | ✅ |
http://xhslink.com/a/AbCdEf (share link) | noteUrls | ✅ Resolved automatically |
A bare 24-character note id, e.g. 6a51b700000000000f028107 | noteUrls | ⚠️ Only if you already hold a matching token from an earlier run |
https://www.xiaohongshu.com/user/profile/5bbe0958... | userUrls | ✅ Profile stats work with or without a token |
| A bare 24-character user id | userUrls | ✅ For profile stats |
| A nickname, a 小红书号, or a keyword | — | ❌ Not a note or profile reference — use keywordResearch or the search modes |
Where the links live: open a note in RedNote, hit share → copy link. The link already contains xsec_token. In every dataset row the actor gives that token back as xsecToken and rebuilds the full noteUrl / authorUrl for you.
Ready-to-paste input recipes
Trend scan of a niche (no login)
{"scrapeType": "discoverFeed","feedCategories": ["beauty", "fashion"],"maxItems": 500,"fullNoteDetail": true}
Brand or product deep-dive on specific posts
{"scrapeType": "noteDetails","noteUrls": ["https://www.xiaohongshu.com/explore/6a51b700000000000f028107?xsec_token=ABzPDMicao11A7ioBtbwH1ox1LqAtrhBjv1vTx6xbsXIQ%3D&xsec_source=pc_feed"],"includeComments": true,"maxCommentsPerNote": 50,"includeAuthorProfile": true}
Comment sentiment mining
{"scrapeType": "noteComments","noteUrls": ["https://www.xiaohongshu.com/explore/6a51b700000000000f028107?xsec_token=ABzPDMicao11A7ioBtbwH1ox1LqAtrhBjv1vTx6xbsXIQ%3D&xsec_source=pc_feed"],"maxItems": 500,"maxCommentsPerNote": 100,"includeSubComments": true}
KOL / influencer vetting
{"scrapeType": "userProfiles","userUrls": ["https://www.xiaohongshu.com/user/profile/5bbe0958e1e44e00014185bb","https://www.xiaohongshu.com/user/profile/55878481f5a2632c8480b32f"],"maxItems": 50}
Keyword and SEO research, expanded automatically
{"scrapeType": "keywordResearch","keywords": ["口红", "coffee", "护肤"],"expandKeywords": true,"maxItems": 300}
Cheap, fast harvest — listing data only
{"scrapeType": "discoverFeed","feedCategories": ["food", "travel", "fitness"],"maxItems": 2000,"fullNoteDetail": false}
Turning fullNoteDetail off skips the per-note page load: several times faster and a fraction of the bandwidth, keeping title, cover, author, likes, date and post type.
Output examples
Photo note
{"type": "note","noteId": "6453436d000000000800c87b","noteUrl": "https://www.xiaohongshu.com/explore/6453436d000000000800c87b?xsec_token=ABjM1Za...","noteType": "image","title": "芭蕾舞女孩蛋糕 六寸蛋糕 女生蛋糕","description": "#蛋糕[话题]# #最好吃的奶油蛋糕[话题]# #生日蛋糕[话题]# ...","likes": 23,"collects": 15,"commentsCount": 4,"shares": 4,"engagementTotal": 46,"likesText": "23","publishedAt": "2023-05-04T05:32:29Z","lastUpdatedAt": "2023-05-04T05:32:29Z","ipLocation": "河南","authorId": "55878481f5a2632c8480b32f","authorName": "宸一烘焙~(👀简介)","authorUrl": "https://www.xiaohongshu.com/user/profile/55878481f5a2632c8480b32f?xsec_token=...","hashtags": ["蛋糕", "最好吃的奶油蛋糕", "生日蛋糕", "定制蛋糕", "动物奶油"],"topics": [{ "id": "53cb2602b4c4d60d1602cc2a", "name": "蛋糕", "type": "topic" }],"imageCount": 9,"coverUrl": "http://sns-webpic-qc.xhscdn.com/.../nd_dft_wlteh_jpg_3","coverUrlOriginal": "https://sns-img-qc.xhscdn.com/1000g0082pam93cgjq0205n106eg1oa8j4dto510","imageUrls": ["http://sns-webpic-qc.xhscdn.com/...", "..."],"imageUrlsOriginal": ["https://sns-img-qc.xhscdn.com/1000g0082pam93cgjq0205n106eg1oa8j4dto510", "..."],"images": [{ "url": "...", "urlOriginal": "...", "width": 1440, "height": 1920, "livePhoto": false }],"sourceCategory": "food","scrapedAt": "2026-08-13T18:21:39Z"}
Video note (media block)
{"noteType": "video","videoUrl": "http://sns-video-v27.xhscdn.com/stream/1/110/259/01ea59b0...mp4?sign=...","videoDuration": 57,"videoDurationMs": 57002,"videoWidth": 720,"videoHeight": 1280,"videoSourceWidth": 1080,"videoSourceHeight": 1920,"videoFps": 30,"videoSizeBytes": 13057498,"videoQuality": "HD","videoCodec": "h264","videoFormat": "mp4","videoAudioCodec": "aac","videoAudioBitrate": 56064,"videoAudioChannels": 2,"videoStreamCount": 2,"videoQualityLadder": ["720x1280 h265", "720x1280 h264"],"videoStreams": [{ "codec": "h265", "width": 720, "height": 1280, "avgBitrate": 1163648, "url": "..." },{ "codec": "h264", "width": 720, "height": 1280, "avgBitrate": 1835432, "url": "..." }],"videoBackupUrls": ["http://sns-bak-v8.xhscdn.com/...", "..."],"videoThumbnailUrl": "https://sns-img-qc.xhscdn.com/110/0/01e4a171f52a9f240010000000018916a7fdf9_0.webp","videoFirstFrameUrl": "https://sns-img-qc.xhscdn.com/110/0/01e4a171f52a9f240010000000018916a5a5cd_0.jpg"}
Video subtitles and transcript
{"videoHasSubtitles": true,"videoSubtitleLanguages": ["en-US", "zh-CN"],"videoLanguages": ["zh-CN"],"videoHasHumanVoice": true,"videoSubtitles": [{ "track": "zh-CN", "language": "zh-CN", "url": "https://sns-subtitle-s10.xhscdn.com/subtitle/....srt?sign=..." },{ "track": "en-US", "language": "en-US", "url": "https://sns-subtitle-s10.xhscdn.com/subtitle/....srt?sign=..." }],"transcriptSrtUrl": "https://sns-subtitle-s10.xhscdn.com/subtitle/....srt?sign=...","transcriptLanguage": "zh-CN","transcriptCharCount": 343,"transcript": "好吃,瘦了二十四斤的我又来教你们做减脂餐了,今天我们吃的是淄博烤肉卷饼\n高蛋白超低脂,学会这个配方,减脂期再也不用馋外面的小烧烤了\n..."}
Creator profile
{"type": "user","userId": "5ec5e2b0000000000101ef59","nickname": "二娃的楼顶菜园","redId": "erwa19491001","description": "草莓🍓番茄🍅 蔬菜🥬水果🍈 分享种菜日常和干货 ...","followers": 10000,"followersText": "1万+","followersI18nText": "10K+","following": 10,"likesAndCollects": 10000,"likesAndCollectsText": "1万+","likesAndCollectsI18nText": "10K+","gender": "male","ipLocation": "四川","location": "中国","profession": "vlog博主","tags": ["27岁", "四川成都", "vlog博主", "景观设计师", "四川农业大学"],"tagDetails": [{ "name": "vlog博主", "type": "profession" }, { "name": "中国", "type": "location" }],"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/63229a46faf1f66cf07425ab.jpg","profileUrl": "https://www.xiaohongshu.com/user/profile/5ec5e2b0000000000101ef59?xsec_token=..."}
Comment reply (threads reconstruct in a spreadsheet)
{"type": "comment","commentId": "646367f50000000016037fcf","noteId": "6461e80e000000002702ad27","content": "都不用点进主页就知道是男宝呢[汗颜R]","likes": 10,"isReply": true,"parentCommentId": "646311570000000016036642","rootCommentId": "646311570000000016036642","repliedToCommentId": "646311570000000016036642","repliedToUserName": "?","repliedToUserUrl": "https://www.xiaohongshu.com/user/profile/5a81a274...?xsec_token=...","isNoteAuthor": false,"authorIsAiAgent": false,"authorName": "小红薯54318","authorId": "5a81a2744eacab0af8e1deb2","ipLocation": "江西","createdAt": "2024-01-24T06:00:23Z"}
Keyword suggestion
{"type": "keyword","keyword": "口红","suggestion": "口红色号大全","searchType": "notes","suggestionType": "top_note","position": 1}
How fast is it?
Measured on the Apify platform at the default concurrency of 10:
| Mode | Throughput | Example |
|---|---|---|
discoverFeed, full detail | ~120 notes/min | 100 notes in 37 s; 200 notes in 1 min 39 s, all 200 with full detail |
discoverFeed, listing only | ~120 notes/min | 50 notes in 25 s |
noteComments | ~80 comments/min | 48 comments in 35 s |
userProfiles | ~36 profiles/min | 12 profiles in 20 s |
keywordResearch | ~180 suggestions/min | 60 suggestions in 20 s |
10 is the top of the tested range and held 100 % full-detail yield on a sustained 200-note run; lower it for gentler large runs.
How much does it cost to scrape RedNote?
Pay per result. Higher Apify subscription tiers pay less per result automatically.
| You are charged for | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| Note (per 1,000) | $5.00 | $4.50 | $4.20 | $4.00 | $3.80 | $3.50 |
| Comment or reply (per 1,000) | $2.00 | $1.80 | $1.60 | $1.40 | $1.20 | $1.00 |
| Creator profile (per 1,000) | $10.00 | $9.00 | $8.00 | $7.00 | $6.00 | $5.00 |
| Keyword suggestion (per 1,000) | $1.00 | $0.90 | $0.80 | $0.70 | $0.60 | $0.50 |
| Actor start (per run, per GB of memory) | $0.001 | $0.0001 | $0.0001 | $0.0001 | $0.0001 | $0.0001 |
What a real job costs:
| Job | Free plan | Gold and above |
|---|---|---|
| 1,000 trending notes, full detail | ~$5.00 | ~$4.00 |
| 100 notes + 10 comments each | ~$2.50 | ~$1.80 |
| 500 creator profiles | ~$5.00 | ~$3.50 |
| 50 notes + their authors + 500 comments | ~$1.75 | ~$1.25 |
| 2,000 keyword suggestions | ~$2.00 | ~$1.40 |
On the free plan, $5 of monthly credits is roughly 1,000 fully-detailed notes, 2,500 comments, 500 creator profiles or 5,000 keyword suggestions. The price is all-inclusive — there is nothing else to add on top — and rows that only explain why an input failed are never charged. Set maxItems to cap any run exactly.
Cheaper still: run fullNoteDetail: false when you only need listing-level data.
What needs a cookie, and what doesn't
Straight answer, because it is the one thing every RedNote scraper trips over:
| Capability | Cookie-free | With the optional cookie |
|---|---|---|
| Category feeds, unlimited cursor pagination | ✅ Full | ✅ Full |
| Full note details (caption, images, video, hashtags) | ✅ Full | ✅ Full |
| Creator profile stats | ✅ Full | ✅ Full |
| Keyword suggestions | ✅ Full | ✅ Full |
| Comments | ✅ Top comment page plus the replies inside those threads (about 10 top-level comments and their replies per note) | ✅ Paginates to your maxCommentsPerNote |
| A specific creator's notes | ⚠️ RedNote blanks the note ids in creator listings for anonymous sessions, so those rows carry title, cover, likes, date and post type, flagged noteIdHiddenByRedNote, without a per-note link | ✅ Full per-note detail |
| Keyword search over notes / creators | ❌ RedNote answers search only for signed-in sessions | ✅ Full |
If you need search, paste the cookie header from a logged-in xiaohongshu.com tab into the optional cookie field (stored as a secret). Everything else runs anonymously and needs nothing from you.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
A note row has only listing fields plus detailError | The note is deleted or private, or its access token expired | Copy a fresh link from RedNote; tokens travel inside the link |
error: Could not read a note id from this input | A nickname, keyword or plain profile link landed in noteUrls | Put note links in noteUrls, profile links in userUrls |
| Search mode returns one row saying the endpoint is restricted | RedNote gates keyword search to signed-in sessions | Fill in the optional cookie field, or use discoverFeed + keywordResearch |
Creator notes come back without links, flagged noteIdHiddenByRedNote | RedNote hides note ids from anonymous creator listings | Use the cookie field for full per-note detail |
| Fewer comments than the note's comment count | Anonymous sessions see the first comment page plus its replies | Raise maxCommentsPerNote and supply the cookie |
Fewer rows than maxItems | The channel or creator ran out of items first | Add more categories, keywords or URLs |
| Media URL stops working after a while | RedNote's videoUrl and imageUrls links are signed and time-limited | For images use imageUrlsOriginal / coverUrlOriginal / videoThumbnailUrl — those are id-based and keep working. For video, download the MP4 soon after the run or re-run to refresh the signature |
transcript missing on a video row | That video has no RedNote subtitle track (videoHasSubtitles is absent), or the add-on is off | Check videoHasSubtitles; switch on Also download video transcripts |
| A feed category returns zero notes | RedNote is not serving that channel to the actor's session (the video channel behaves this way) | Pick another category — the log names the empty one |
The run finished with a single row of type: info | Nothing was scraped, and the row says why — usually a mode whose input field was left empty | Read the error field on that row, or the run's status message; the row is never billed |
| The log says the run switched modes | The mode's own input field was empty while another one was filled in | Nothing to fix if that was what you meant; otherwise set What do you want to scrape? explicitly |
| The whole feed returns one row saying RedNote refused it | The proxy exit IPs are being blocked right now — the feed needs a guest session RedNote would not grant | Re-run, pick another category, or switch the proxy group |
Input parameters
| Field | Type | Default | What it does |
|---|---|---|---|
scrapeType | enum | discoverFeed | Which of the eight modes to run |
feedCategories | array | ["recommended"] | Category channels to page through: recommended, fashion, food, beauty, movies, career, relationships, home, gaming, travel, fitness, video |
noteUrls | array | — | Note links, share links or bare note ids |
userUrls | array | — | Profile links or bare user ids |
keywords | array | — | Seed keywords for research and search |
expandKeywords | boolean | false | Feed each suggestion back as a new seed |
searchSortBy | enum | relevance | relevance, popularity, latest, mostCommented, mostCollected |
searchNoteType | enum | all | all, video, image |
searchTimeFilter | enum | all | all, day, week, halfYear |
maxItems | integer | 100 | Hard cap on dataset rows for the run |
maxNotesPerUser | integer | 30 | Notes per creator |
maxCommentsPerNote | integer | 50 | Comments, replies included, per note |
fullNoteDetail | boolean | true | Open each note for the full payload |
includeComments | boolean | false | Add comment rows for every note collected |
includeSubComments | boolean | true | Include replies inside comment threads |
includeAuthorProfile | boolean | false | Add a profile row per distinct author, fetched once |
includeVideoStreams | boolean | true | Keep every video rendition, not just the best MP4 |
includeTranscripts | boolean | false | Download the spoken-language subtitle file and attach the text as transcript |
includeRawData | boolean | false | Attach RedNote's untouched payload as raw |
maxConcurrency | integer | 10 | Parallel requests, 1–10 |
maxRetries | integer | 5 | Retries per request |
cookie | string (secret) | — | Only needed to unlock the two search modes |
proxyConfiguration | object | Residential | Proxy settings; custom proxies supported |
Integrations
Send RedNote data wherever it needs to go, with no glue code:
- Google Sheets, Airtable, Slack, Gmail — through Apify's native integrations
- Make, Zapier, n8n — trigger a run and pipe rows into any workflow
- Webhooks — fire on run finish and push the dataset to your own endpoint
- REST API + JavaScript / Python clients — call the actor and read the dataset programmatically
- Schedules — run any mode on a cron and let the dataset accumulate
- Exports — JSON, JSONL, CSV, Excel, XML, HTML table
Use with AI agents (MCP)
This actor is callable through the Apify MCP server, so Claude, Cursor, VS Code or any MCP-capable agent can run it as a tool and read the results directly. Point your client at https://mcp.apify.com, add pro100chok/rednote-xiaohongshu-scraper, then just ask:
"Pull 200 trending beauty notes from RedNote, keep the ones above 5,000 likes, and summarise which ingredients keep coming up in the captions."
Because six of the eight modes need no cookie, an autonomous agent can use them without ever handling credentials.
Popular use cases
- China market entry — measure real demand and objections in first-person consumer posts before launching a product.
- KOL / influencer discovery and vetting — followers, likes+saves, region, niche tags and actual posting output per creator.
- Brand and competitor monitoring — schedule a daily category sweep and track engagement on your and rivals' content.
- Beauty, fashion, food and travel trend research — RedNote is where these trends surface first in China.
- Comment sentiment mining — thread-level opinions with likes and commenter region.
- SEO and content planning — RedNote's own suggestions expanded into a long-tail keyword map.
- AI / LLM training corpora — clean, flat Chinese-language UGC with engagement labels.
- Video and image asset collection — direct MP4 links and full-resolution galleries.
Is it legal to scrape RedNote (Xiaohongshu)?
This actor collects only what RedNote shows publicly, and it does not log in anywhere or bypass authentication to reach content you could not otherwise see. Scraping publicly available data is generally lawful, but what you do with it matters: RedNote rows contain personal data such as nicknames, avatars, bios and coarse region, so handle them under GDPR, CCPA and PIPL, respect RedNote's terms of service, and respect creators' rights when storing or republishing media. When in doubt, talk to your legal team — and see Apify's guide, is web scraping legal?
This actor is an independent, unofficial tool. It is not affiliated with, endorsed by or sponsored by Xiaohongshu / RedNote or Xingin (Xingyin Information Technology). The Xiaohongshu, RedNote, 小红书 and Little Red Book names are the property of their respective owners and are used here descriptively.
FAQ
What is RedNote (Xiaohongshu / 小红书 / Little Red Book)?
China's leading lifestyle-discovery and social-commerce platform, with 300M+ monthly users posting first-person reviews of products, restaurants, travel and beauty routines. It is also known as XHS, RED and Little Red Book. It went viral internationally in 2025 when US users migrated to it.
Does RedNote have a public API?
Not for content. RedNote's open platform serves business and advertising integrations, so there is no official endpoint that returns notes, creators or comments to third-party developers. This actor is the practical alternative.
Do I need a RedNote account or cookies?
Not for six of the eight modes. Category feeds, note details, comments, creator profiles, creator notes and keyword research all run anonymously. Only the two keyword-search modes need a cookie, because RedNote itself refuses search for anyone who is not signed in.
Why does keyword search need a cookie?
Because RedNote answers its search endpoint only for signed-in sessions — it returns "this account has no access" to everyone else, from any location. No scraper can change that. Paste a cookie to unlock it, or use discoverFeed plus keywordResearch, which cover most content research without one.
How many comments do I get per note?
Anonymously: the top comment page plus the replies inside those threads, typically around 10 top-level comments with their replies. With the optional cookie the actor keeps paginating up to your maxCommentsPerNote.
How many notes do I get per creator?
RedNote returns a creator's recent posts but blanks the individual note ids for anonymous sessions, so those rows arrive with title, cover, likes, date and post type — flagged noteIdHiddenByRedNote — and no per-note link. Profile stats are complete either way; full per-note detail needs the cookie.
Where do I find a note or profile link?
Open the note or profile in RedNote and use share → copy link. The link contains the xsec_token the actor needs, and every dataset row hands that token back so you can reuse it later.
Can I download RedNote videos and images?
You get direct, ready-to-use MP4 links plus mirrors, and full-resolution image URLs — twice over: RedNote's own signed links, which expire after a while, and id-based originals (imageUrlsOriginal, coverUrlOriginal, videoThumbnailUrl, videoFirstFrameUrl) that keep working. Fetch video files soon after the run; the image originals can wait.
Can I get the spoken text of a RedNote video?
Yes, when RedNote generated subtitles for it. Every video row reports videoHasSubtitles and lists the .srt URL per language in videoSubtitles — usually the original Chinese plus an English translation. Switch on Also download video transcripts and the spoken text arrives in the row as transcript, timings stripped, with transcriptLanguage and transcriptCharCount.
Are the engagement counts exact?
They are exactly what RedNote publishes. Above a threshold RedNote itself rounds to forms like 10万+, so you get both the original string and the parsed integer, and you can see which is which.
Why is ipLocation missing on some notes?
RedNote only attaches a publish region to some posts. When it is absent upstream, the field is simply omitted rather than guessed.
Can I export to CSV or Excel?
Yes — JSON, JSONL, CSV, Excel, XML and HTML table, from the Output tab or the API. The dataset also ships preset views for notes, creators, comments, keywords and media.
Will I be charged for URLs that return nothing?
No. A row that only explains why an input failed is never billed.
Can I schedule recurring runs?
Yes. Use Apify Schedules to run any mode on a cron, and add a webhook if you want each finished dataset pushed into your own system.
How fast is it, and can I speed it up?
At the default concurrency of 10, roughly 120 fully-detailed notes per minute — 100 notes in about 37 seconds — and far more in listing-only mode, which skips the per-note page load entirely. Note URLs, creators and comment threads are all fetched in parallel, so a long input list costs little more per item than a short one.
Is the data in Chinese?
Yes — RedNote is a Chinese platform, so titles, captions, comments and region names come back in the original language, exactly as posted. Tip: searching or scanning with the Chinese brand name (耐克 rather than Nike) surfaces far more native consumer content.
Is it legal to scrape RedNote?
See the section above — public data only, no login, and GDPR / CCPA / PIPL apply to how you use it.
中文说明
本 Actor 用于采集 小红书 / RedNote / Xiaohongshu (XHS) 公开数据:分类推荐流、笔记详情(正文、全部图片、视频直链、话题标签、点赞收藏评论分享数)、博主主页(粉丝数、小红书号、简介、地区)、笔记评论及回复、以及小红书搜索联想词。八个模式中有六个完全无需登录、无需 Cookie。 支持导出 JSON / CSV / Excel,按结果计费,失败行不计费。
Feedback & support
Found a bug, a missing field, or a note that will not parse? Open an issue on the actor's Issues tab with the run URL — that is the fastest path to a fix. Feature requests are welcome there too, and a ⭐ review helps other RedNote researchers find the actor.
More scrapers by this developer
- 🛒 TikTok Shop Scraper & Analytics — products, shops and sales analytics
- 🎵 TikTok Profile API Scraper — profiles, contacts and engagement analytics
- 📸 Instagram Scraper API — profiles, posts, followers and comments
- 🧵 Threads Scraper — posts, profiles and replies, no login
- 📌 Pinterest Full Scraper — pins, profiles and boards
- ▶️ YouTube Scraper API — videos, transcripts and comments
- 🏬 AliExpress Scraper API — products, variants and reviews
- 🏭 Alibaba Scraper API — products, suppliers and prices
Tags: rednote scraper, xiaohongshu scraper, 小红书 采集, xhs scraper, little red book scraper, red scraper, rednote api, xiaohongshu api, unofficial xiaohongshu api, rednote data extraction, xiaohongshu notes scraper, rednote comments scraper, xiaohongshu comments api, rednote profile scraper, xiaohongshu kol scraper, rednote influencer scraper, xiaohongshu keyword research, rednote trending feed, xiaohongshu video downloader, rednote video url, xiaohongshu without login, rednote no cookie, china social media scraper, chinese consumer research, china market entry data, kol discovery china, beauty trends china, fashion trends china, food trends china, chinese ugc dataset, llm training data chinese, brand monitoring china, social listening china, xiaohongshu engagement metrics, rednote hashtags, xiaohongshu export csv