RedNote (Xiaohongshu / 小红书) Note Detail Scraper | Full Note, Video Streams, Subtitles, Image Downloads (2026)

20 fields per note: title, full description, every image URL, video stream URLs (h265 + h264), native video subtitles (original transcript + auto-translated English), like / collect / comment / share counts, author profile, tags, and location from any Xiaohongshu (小红书) note. Optional MP4 and image file download.

Zen Studio · RedNote (小红书) suite   •  Search, note detail, comments, and profiles from Xiaohongshu
RedNote Note Detail ➤ You are here	RedNote Search 500 notes / 30s, 24 fields	RedNote Comments Nested replies, IP city	RedNote User Profile Profile + every post, 68 fields

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 downloads the MP4, cover, and gallery images to your key-value store. 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 share links or full note URLs that include their xsec_token. 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

Key Features

• 20 structured fields per note: title, description, every image, video streams, engagement counts, author, tags, location
• Video stream URLs: direct MP4 links in h265 and h264, with a url_720p convenience link and per-stream codec, bitrate, and resolution
• Native video subtitles: the video's built-in subtitle track as timestamped .srt links, with the original-language transcript plus auto-translated English and Chinese, whenever the video has them
• Optional media download: save the actual MP4, cover frame, and gallery images to your key-value store before the source links expire
• One link in, one row out: paste a share link or note URL; each note runs independently and counts as one result
• Free tier: 25 lifetime runs, up to 20 notes per run, no credit card

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 and its cover

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

Download a photo note's full gallery 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

Many Xiaohongshu videos ship with a built-in subtitle track: the spoken words, timestamped. This scraper surfaces them on every video note, free.

• 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.

Subtitles depend on the video itself: talking, tutorial, and how-to videos almost always have them; purely visual clips set to music often don't. 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?

Note links must include their access token. The easiest source is the app's Share → Copy link, which gives you an xhslink.com link. A full xiaohongshu.com URL works too, as long as it still contains xsec_token=.

Format	Example	Works
Share link	http://xhslink.com/o/6oKW7wkJf09	✅
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=...	✅
Bare 24-character ID	6a06c9360000000036001d5a	❌ no access token

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 or full note URLs that include their xsec_token. Each note runs independently and counts as one result.
downloadVideos	boolean	false	Save each video note's MP4 to your key-value store. Image notes have no video.
downloadCovers	boolean	false	Save each video note's cover image (JPEG).
downloadImages	boolean	false	For image notes, save every gallery image (JPEG). 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, width, height, live_photo, live_photo_url
• video: duration_seconds, streams[] (codec, quality, resolution, fps, url, backup_urls), a url_720p convenience link, and subtitles
• 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[]: key-value store key, size, MIME type, and the source URL for each saved file
• 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",
      "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
      }
      // ... 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=..."
  },
  "coverFile": {
    "kvStoreKey": "69f1df66000000003601fe33_cover.jpg",
    "kvStoreId": "Q11ZEQN9Usl2fKunQ",
    "kvUrl": "https://api.apify.com/v2/key-value-stores/Q11ZEQN9Usl2fKunQ/records/69f1df66000000003601fe33_cover.jpg",
    "sizeBytes": 131408,
    "mimeType": "image/jpeg",
    "sourceUrl": "http://sns-webpic-qc.xhscdn.com/.../01e9f1df...!nd_dft_wlteh_jpg_3"
  },
  "imageFiles": 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, and subtitleFiles are null unless you turn on the matching download toggle.

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	Per 1,000 notes
Free	$9.99
Bronze	$8.99
Silver	$8.79
Gold and above	$7.99

Optional media downloads (Free-plan rate; higher plans get the same tier discount):

Add-on	Per 1,000
Video downloaded (MP4)	$4.99
Image downloaded (cover or gallery, JPEG)	$1.99
Subtitle file downloaded (SRT)	Free

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 share links and full xiaohongshu.com URLs (/discovery/item/<id> or /explore/<id>) that include an xsec_token. You can also paste the whole share-text the app copies. Bare 24-character IDs can't be opened because they carry no access token.

Why do I need the access token? The token is the credential that unlocks a note's full detail. Without it, the note can't be opened. The app's Share → Copy link always includes one.

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 image and video CDN links are signed and expire a few hours after they are issued. Turn on the download toggles to save the actual files to your key-value store while the links are still valid.

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[] 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 frame. 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. Talking and tutorial videos almost always have subtitles; purely visual clips set to music often don't, in which case 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.

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 already carries the required xsec_token, this actor fetches the full detail, RedNote Comments Scraper pulls the threads, and RedNote User Profile Scraper returns the author's complete back-catalogue.

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

• RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Product Reviews Scraper
  • RedNote Live Recorder
• 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

🛒 E-commerce

• Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
• JD.com 京东
  • JD.com Search Scraper
• 1688 阿里巴巴
  • 1688 Wholesale Scraper
• Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A 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.