RedNote (Xiaohongshu / 小红书) Video & Image Downloader and Note Scraper

From Zen Studio. Creators of RedNote Search and Douyin Search, which have ranked #1 for “rednote” and “douyin”, respectively, in Apify Store relevance results, with 100,000+ combined lifetime runs.

Why choose this actor?

• Original photos, not previews. Save every gallery image and video cover as the file the creator uploaded, at full resolution and in its own format (JPEG, PNG or WEBP; iPhone HEIC photos arrive as JPEG). Each image also carries a lasting url_original link.
• The best video each note offers. Choose Highest available for up to 4K, or Most compatible for H.264 that plays everywhere. Every saved video lists its resolution and codec.
• Live Photos, subtitles and the post, together. Keep Live Photo motion clips, subtitle SRT files with English translations when the video has them, and the note’s title, text, author, tags and likes, comments, saves and shares.

Try a video and a Live Photo note

Open the actor’s input page, switch to JSON and paste this. Replace the examples with your own note links, then start the run.

{
  "noteUrls": [
    "https://www.xiaohongshu.com/explore/6831c6390000000021018b17",
    "https://www.xiaohongshu.com/explore/6a8268ba000000002402d00e"
  ],
  "downloadVideos": true,
  "videoQuality": "highest",
  "downloadImages": true
}

Saved files appear in videoFile, imageFiles and livePhotoFiles, each with a direct link to your key-value store. The video versions on offer vary by note, from 720p up to 4K. For H.264, set "videoQuality": "compatible".

Video and image downloads are billed per saved file and need a paid Apify plan. On the Apify Free plan (15 lifetime preview runs, up to 20 notes each) the same input returns the note data and media links without saving those files; subtitle SRT downloads stay free.

Continue your research

Zen Studio · RedNote & Likee
Note Detail You are here	RedNote Search Post search	Comments Comments & replies	Creator Profiles Creators & posts	Likee Scraper Videos and MP4 files

Copy to your AI assistant

zen-studio/rednote-note-detail-scraper on Apify. Returns the full detail of any Xiaohongshu (小红书) note from its share link or note URL: title, full description, every image URL, video stream URLs (h265 + h264), native video subtitles (original-language transcript plus auto-translated English and Chinese, as timestamped .srt links, when the video has them), like / collect / comment / share counts, author profile, tags, location. Optionally saves media files to your key-value store: the video (videoQuality "highest" = largest available resolution up to 4K, "compatible" = H.264), the original full-resolution cover and gallery images (HEIC converted to JPEG), and Live Photo motion clips. Every image also carries a lasting url_original link to its original file. Call ApifyClient("TOKEN").actor("zen-studio/rednote-note-detail-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. noteUrls accepts xhslink.com / xhslink.cn share links, full note URLs with or without xsec_token, and bare note IDs. downloadSubtitles saves available SRT tracks without an extra actor charge. Full spec: GET https://api.apify.com/v2/acts/zen-studio~rednote-note-detail-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.

How to Scrape a Xiaohongshu Note

Basic: single note from a share link

{
    "noteUrls": ["http://xhslink.com/o/6oKW7wkJf09"]
}

Multiple notes from full URLs

{
    "noteUrls": [
        "https://www.xiaohongshu.com/discovery/item/69f1df66000000003601fe33?xsec_token=YB8dFv3w...&xsec_source=app_share",
        "https://www.xiaohongshu.com/explore/6a06c9360000000036001d5a?xsec_token=CBMGWfsL...&xsec_source=pc_search"
    ]
}

Download the video in the highest quality, plus its cover

{
    "noteUrls": ["http://xhslink.com/o/6oKW7wkJf09"],
    "downloadVideos": true,
    "videoQuality": "highest",
    "downloadCovers": true
}

Use "videoQuality": "compatible" for an H.264 file that plays in every browser, phone and editor.

Download a photo note's original images and Live Photos to a reusable store

{
    "noteUrls": ["http://xhslink.com/o/6oKW7wkJf09"],
    "downloadImages": true,
    "mediaKvStoreName": "my-rednote-media"
}

Get a video's subtitles (transcript) as SRT files

{
    "noteUrls": ["http://xhslink.com/o/6oKW7wkJf09"],
    "downloadSubtitles": true
}

Video Subtitles & Transcripts

Some Xiaohongshu videos include subtitle tracks: the spoken words, timestamped, plus translations where available. This actor returns those tracks without an extra subtitle charge; normal note-result charges apply.

• In the data: video.subtitles lists the available tracks keyed by language. source is the original-language transcript; en-US and zh-CN are auto-translated versions. Each track is a timestamped .srt link.
• As files: turn on Download subtitles to save those .srt files straight to your key-value store, so you keep the transcript even after the source links roll over. This download is free.
• Use cases: full-text search across a creator's videos, translation, captioning, summarizing, or feeding video speech into an LLM.

Subtitle availability and translation languages vary by video. When a video has no subtitle track, video.subtitles is an empty object and no files are produced.

Where Do I Get a Note Link?

The easiest source is the app's Share → Copy link, which gives you an xhslink.com or xhslink.cn link. A full xiaohongshu.com URL works too, and so does a bare 24-character note ID.

Format	Example	Works
Share link	http://xhslink.com/o/6oKW7wkJf09, https://xhslink.cn/o/7AxkDPYQOTQ	✅
Full URL with token	https://www.xiaohongshu.com/discovery/item/<id>?xsec_token=...	✅
/explore/<id> with token	https://www.xiaohongshu.com/explore/<id>?xsec_token=...	✅
Note URL without a token	https://www.xiaohongshu.com/explore/<id>	✅
Note opened from a profile	https://www.xiaohongshu.com/user/profile/<user id>/<note id>?xsec_token=...	✅
Bare 24-character ID	6a06c9360000000036001d5a	✅
Creator profile, no note	https://www.xiaohongshu.com/user/profile/<user id>	❌ use the User Profile Scraper
Anything else	demo_note_0000, a search keyword	❌ not a note reference

You can also paste the whole share-text the app copies; the link inside it is detected automatically.

Input Parameters

Parameter	Type	Default	Description
noteUrls	array	required	Xiaohongshu share links, full note URLs with or without xsec_token, or bare note IDs. Each note runs independently and counts as one result.
downloadVideos	boolean	false	Save each video note's MP4 to your key-value store, in the quality set by videoQuality. Image notes have no video.
videoQuality	string	"highest"	highest: the largest resolution the note offers, up to 4K (high resolutions are usually H.265). compatible: H.264, which plays everywhere, usually 720p.
downloadCovers	boolean	false	Save each video note's cover image as the original full-resolution file.
downloadImages	boolean	false	For image notes, save every gallery image as the original full-resolution file (JPEG, PNG or WEBP; HEIC photos are converted to JPEG), plus each Live Photo's motion clip as an MP4. No effect on video notes.
downloadSubtitles	boolean	false	Save each video note's subtitle tracks as .srt files (original transcript + any auto-translations). Free.
mediaKvStoreName	string	""	Save downloaded media to a named, persistent key-value store. Leave blank to use the run's default store. Letters, digits, and dashes only.

What Data Can You Extract from a Xiaohongshu Note?

Every dataset row is one note with rich, structured fields.

Core fields:

• id, type (normal or video), title, desc, url, xsec_token
• timestamp, last_update_time (Unix milliseconds), ip_location
• ai_generated_flag, at_user_list

Engagement (engagement):

• liked_count, comments_count, collected_count, shared_count

Author (author):

• userid, nickname, avatar (CDN URL), xsec_token

Media:

• images[]: every image with url, url_pre, url_original (a lasting link to the original full-resolution file), width, height, live_photo, live_photo_url (the Live Photo motion clip)
• video: duration_seconds, streams[] (codec, quality, resolution, fps, url, backup_urls, size, avg_bitrate, video_codec, video_bitrate, audio_codec, audio_bitrate, audio_channels, hdr_type, rotate, stream_type, stream_desc, default_stream, psnr, ssim, vmaf), a url_720p convenience link, and subtitles. The versions on offer vary by note, from a single 720p stream up to 4K
• video.subtitles: native subtitle tracks keyed by language. source is the original-language transcript; en-US and zh-CN are auto-translations. Each is a list of { language, url, type, format } where url is a timestamped .srt. Present when the video has subtitles, otherwise {}
• tags[]: topic and other tags with id, name, type

Downloaded files (when enabled):

• videoFile, coverFile, imageFiles[], livePhotoFiles[]: key-value store key, size, MIME type, and the source URL for each saved file. The key's extension matches the real file type. videoFile also lists the saved width, height, codec and quality
• subtitleFiles[]: one entry per saved .srt track, same fields. Free to download. The track is in the key, e.g. <id>_subtitle_source.srt (original), <id>_subtitle_en-US.srt, <id>_subtitle_zh-CN.srt

Output Example

{
  "id": "69f1df66000000003601fe33",
  "type": "video",
  "title": "瘦肚子的最快的时间，你知道是什么时候吗？",
  "desc": "练前热身动作 - 三个动作各做30秒左右\n正式训练\n#健身POV[话题]# #健身教学[话题]#",
  "url": "https://www.xiaohongshu.com/discovery/item/69f1df66000000003601fe33?xsec_token=YB8dFv3w...&xsec_source=app_share",
  "xsec_token": "YB8dFv3wVEO6i_9lMS4rZrZXJv71XdlpWrT8TJkKHET74=",
  "timestamp": 1777459046000,
  "last_update_time": 1777459051000,
  "ip_location": "上海",
  "engagement": {
    "liked_count": 100000,
    "comments_count": 3367,
    "collected_count": 100000,
    "shared_count": 25000
  },
  "author": {
    "userid": "5ff0847d000000000101eced",
    "nickname": "PAD运动健身",
    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31...jpg",
    "xsec_token": "ABmFY2_5n_PuwIaXcQnMBu_FEZ931s7vbp41QbKTgmzcQ="
  },
  "images": [
    {
      "url": "http://sns-webpic-qc.xhscdn.com/.../01e9f1df...!nd_dft_wlteh_jpg_3",
      "url_pre": "http://sns-webpic-qc.xhscdn.com/.../01e9f1df...!nd_prv_wlteh_jpg_3",
      "url_original": "https://ci.xiaohongshu.com/1040g00831...",
      "width": 720,
      "height": 1280,
      "live_photo": false,
      "live_photo_url": ""
    }
  ],
  "video": {
    "duration_seconds": 51,
    "url_720p": "http://sns-video-alos.xhscdn.com/stream/1/110/258/01e9f1df...258.mp4?sign=...",
    "streams": [
      {
        "url": "http://sns-video-alos.xhscdn.com/stream/1/110/258/01e9f1df...258.mp4?sign=...",
        "backup_urls": ["http://sns-video-hw.xhscdn.com/stream/1/110/258/01e9f1df...258.mp4?sign=..."],
        "quality": "HD",
        "width": 720,
        "height": 1280,
        "fps": 30,
        "duration": 51467,
        "format": "mp4",
        "codec": "h265",
        "size": 8556814,
        "avg_bitrate": 1330066,
        "video_codec": "hevc",
        "video_bitrate": 1265430,
        "audio_codec": "aac",
        "audio_bitrate": 64016,
        "audio_channels": 2,
        "hdr_type": 0,
        "rotate": 0,
        "stream_type": 115,
        "stream_desc": "X265_MP4",
        "default_stream": true,
        "psnr": 0,
        "ssim": 0,
        "vmaf": -1
      }
      // ... more streams (h265 + h264)
    ],
    "subtitles": {
      "source": [
        { "language": "zh-CN", "url": "https://sns-subtitle-s10.xhscdn.com/subtitle/1/110/1/01e9f1df66...e_1.srt?sign=...&t=...", "type": 0, "format": 0 }
      ],
      "en-US": [
        { "language": "en-US", "url": "https://sns-subtitle-s10.xhscdn.com/subtitle/1/110/1/01e9f1df66...e_502.srt?sign=...&t=...", "type": 0, "format": 0 }
      ],
      "zh-CN": [
        { "language": "zh-CN", "url": "https://sns-subtitle-s10.xhscdn.com/subtitle/1/110/1/01e9f1df66...e_11.srt?sign=...&t=...", "type": 0, "format": 0 }
      ]
    }
  },
  "tags": [
    { "id": "5f7f...", "name": "健身POV", "type": "topic" },
    { "id": "5d09...", "name": "健身教学", "type": "topic" }
    // ... 8 more
  ],
  "at_user_list": [],
  "ai_generated_flag": null,
  "videoFile": {
    "kvStoreKey": "69f1df66000000003601fe33.mp4",
    "kvStoreId": "Q11ZEQN9Usl2fKunQ",
    "kvUrl": "https://api.apify.com/v2/key-value-stores/Q11ZEQN9Usl2fKunQ/records/69f1df66000000003601fe33.mp4",
    "sizeBytes": 8556814,
    "mimeType": "video/mp4",
    "sourceUrl": "http://sns-video-alos.xhscdn.com/stream/1/110/258/01e9f1df...258.mp4?sign=...",
    "width": 720,
    "height": 1280,
    "codec": "h265",
    "quality": "HD"
  },
  "coverFile": {
    "kvStoreKey": "69f1df66000000003601fe33_cover.jpg",
    "kvStoreId": "Q11ZEQN9Usl2fKunQ",
    "kvUrl": "https://api.apify.com/v2/key-value-stores/Q11ZEQN9Usl2fKunQ/records/69f1df66000000003601fe33_cover.jpg",
    "sizeBytes": 1149164,
    "mimeType": "image/jpeg",
    "sourceUrl": "https://ci.xiaohongshu.com/1040g00831..."
  },
  "imageFiles": null,
  "livePhotoFiles": null,
  "subtitleFiles": [
    {
      "kvStoreKey": "69f1df66000000003601fe33_subtitle_source.srt",
      "kvStoreId": "Q11ZEQN9Usl2fKunQ",
      "kvUrl": "https://api.apify.com/v2/key-value-stores/Q11ZEQN9Usl2fKunQ/records/69f1df66000000003601fe33_subtitle_source.srt",
      "sizeBytes": 1791,
      "mimeType": "application/x-subrip",
      "sourceUrl": "https://sns-subtitle-s10.xhscdn.com/subtitle/1/110/1/01e9f1df66...e_1.srt?sign=...&t=..."
    }
    // ... one entry per language track (source, en-US, zh-CN)
  ],
  "_input": "http://xhslink.com/o/6oKW7wkJf09"
}

videoFile, coverFile, imageFiles, livePhotoFiles, and subtitleFiles are null unless you turn on the matching download toggle. livePhotoFiles fills when Download gallery images is on and the note has Live Photos.

Advanced Usage

Archive a video note before its links expire

{ "noteUrls": ["http://xhslink.com/o/6oKW7wkJf09"], "downloadVideos": true, "downloadCovers": true, "mediaKvStoreName": "rednote-archive" }

Bulk-fetch a known set of notes

{
  "noteUrls": [
    "https://www.xiaohongshu.com/discovery/item/69f1df66000000003601fe33?xsec_token=YB8dFv3w...&xsec_source=app_share",
    "https://www.xiaohongshu.com/discovery/item/6a06c9360000000036001d5a?xsec_token=CBMGWfsL...&xsec_source=app_share"
  ]
}

Pull just the metadata, skip media files

{ "noteUrls": ["http://xhslink.com/o/6oKW7wkJf09"] }

Pricing: Pay Per Event (PPE)

From $7.99 to $9.99 per 1,000 notes, depending on your Apify plan. Each note returned counts as one billable result. Media downloads are optional add-ons, billed only for files actually saved.

Your Apify plan	Note-result charges per 1,000 notes
Free	$9.99
Bronze	$8.99
Silver	$8.79
Gold and above	$7.99

Optional video, cover, gallery image and Live Photo downloads require a paid Apify plan and are billed per saved file:

Add-on charges per 1,000 files	Bronze	Silver	Gold and above
Video downloaded (MP4)	$4.49	$4.39	$3.99
Image downloaded (cover, gallery image or Live Photo clip)	$1.79	$1.75	$1.59

Subtitle downloads have no additional actor charge and are also available during the Free preview. Normal note-result charges apply outside the preview.

FAQ

What is RedNote (Xiaohongshu / Little Red Book)? RedNote is the international name of Xiaohongshu (小红书, literally "Little Red Book", often abbreviated XHS), China's leading lifestyle and social-commerce platform. A "note" is its core content unit: a short video or image gallery with a caption, comments, and engagement counts.

Which note link formats are accepted? xhslink.com and xhslink.cn share links, full xiaohongshu.com URLs (/discovery/item/<id>, /explore/<id>, or /user/profile/<user id>/<note id> as the site writes it when you open a note from a creator's profile, with or without an xsec_token), and bare 24-character note IDs. You can also paste the whole share-text the app copies. Anything that isn't one of these, a placeholder string, a search keyword, or a profile link with no note in it, is skipped.

Do I need the access token? No. A link that carries its xsec_token is the most direct route to a note, but token-less links and bare note IDs are resolved as well. The app's Share → Copy link always includes a token.

What's the difference between a video note and an image note? Video notes have a populated video object with stream URLs; their images array holds a single cover frame. Image notes have video: null and a multi-image images gallery.

Why are the media URLs time-limited? Xiaohongshu's video links and image display links are signed and expire a few hours after they are issued. Each image's url_original is a lasting link to the original file. Turn on the download toggles to keep the files themselves in your key-value store.

Are engagement counts exact? Counts are returned as integers. Large counts that Xiaohongshu rounds for display (e.g. 10万+) become best-effort integers (100000).

Where do downloaded files go? Into your run's key-value store by default, or a named store you set with mediaKvStoreName. Each videoFile / coverFile / imageFiles[] / livePhotoFiles[] entry includes the store key and a direct record URL.

Can I download images from a video note? downloadCovers saves a video note's cover image as the original file. downloadImages applies to image notes only.

Do videos include subtitles or a transcript? Yes, when the video has them. Each video note carries a video.subtitles map with the original-language transcript (source) plus auto-translated en-US and zh-CN tracks, each a timestamped .srt link. Turn on Download subtitles to also save the .srt files to your key-value store, free. Available translation languages vary by video. When there are no tracks, video.subtitles is empty.

Does downloading subtitles cost extra? No. Subtitle .srt files are saved free of charge. Only video and image downloads carry a per-file fee.

Which video quality do I get? With videoQuality set to highest (the default), the largest resolution the note offers, up to 4K. High resolutions are usually H.265, which some older players can't open. compatible saves the H.264 version, which plays everywhere, usually at 720p. Some notes offer only one version, and videoFile shows what was saved. A video too large for the run's storage is saved in the largest version that fits, or skipped with mediaTruncated: true; give the run more memory to keep larger files.

Are downloaded images the original files? Yes. Covers and gallery images are saved as the original uploaded files at full resolution, in their own format (JPEG, PNG or WEBP). iPhone HEIC photos are converted to full-resolution JPEG so every tool can open them. Live Photos also save their motion clip as an MP4.

What happens if a note is removed or the link expired? That note is skipped with a short note in the log, and the run continues with the rest.

How fresh is the data? Live from Xiaohongshu at run time, no cache.

Do I need a Xiaohongshu account or cookies? No. Paste share links and run; no account, cookie export, or QR login is involved. The access token inside each share link is all the actor needs.

How do I export the data? The dataset downloads as JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or via the Apify API. Downloaded media files sit in your key-value store with direct record URLs.

How do I find notes at scale, or get comments and author history? Chain the suite: RedNote Search Scraper finds notes by keyword and its url field can be used as input, this actor fetches the full detail, RedNote Comments Scraper pulls the threads, and RedNote User Profile Scraper collects the author's profile and posts.

Is it legal to scrape Xiaohongshu notes? The actor fetches publicly shared notes only, via their own share links. You are responsible for complying with Xiaohongshu's terms of service and applicable data protection law (GDPR, CCPA, PIPL), and for respecting creators' rights when storing or reusing downloaded media.

More Zen Studio scrapers for Chinese platforms

🎬 Short-video & social

• Douban 豆瓣
  • Douban Scraper
  • Douban Reviews Scraper
  • Douban Group Scraper
• Zhihu 知乎
  • Zhihu Scraper
• Weibo 微博
  • Weibo Search Scraper
  • Weibo Comments Scraper
• Kwai (Brazil)
  • Kwai Search Scraper
  • Kwai Comments Scraper
• RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Product Reviews Scraper
  • RedNote Live Recorder
  • RedNote Product Detail Scraper
• Douyin 抖音
  • Douyin Search Scraper
  • Douyin Profile Scraper
  • Douyin Video Scraper
  • Douyin Comments Scraper
  • Douyin Transcripts Scraper
  • Douyin Creator Rankings Scraper
  • Douyin Live Recorder
  • Douyin Hot Search Scraper
  • Douyin Product Search Scraper
• Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper
• Bilibili 哔哩哔哩
  • Bilibili Video Scraper
  • Bilibili Danmaku Scraper

🛒 E-commerce

• TikTok Shop
  • TikTok Shop Review Scraper
• Naver Search 네이버 검색
  • Naver Search Scraper
• Shopee
  • Shopee Product Detail Scraper
  • Shopee Product Reviews Scraper
  • Shopee Product Scraper
  • Shopee Live Scraper
• Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
• JD.com 京东
  • JD.com Search Scraper
• 1688 阿里巴巴
  • 1688 Wholesale Scraper
  • Alibaba Scraper
  • 1688 Reviews Scraper
• Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper
  • Goofish (Xianyu) Reverse Image Search Scraper
• Coupang 쿠팡
  • Coupang Review Scraper
  • Coupang Search Scraper
  • Coupang Product Detail Scraper

🏠 Real estate & autos

• Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 58.com 58同城
  • 58.com Real Estate Scraper
• Autohome 汽车之家
  • Autohome (Che168) Used-Car Scraper

Support

• Bugs: Issues tab
• Features: Issues tab

Legal Compliance

Extracts publicly available data. Users must comply with Xiaohongshu's terms and data protection regulations (GDPR, CCPA, PIPL).

---

Get the full detail of any Xiaohongshu (小红书) note from its share link: title, description, every image, video stream URLs, engagement counts, author profile, tags, location, with optional MP4 and image download.