RedNote (Xiaohongshu) Note Detail Scraper | Full Note, Video Streams, Image Downloads (2026)

20 fields per note: title, full description, every image URL, video stream URLs (h265 + h264), 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), 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
• 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"
}

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.
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), and a url_720p convenience link
• 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

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)
    ]
  },
  "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,
  "_input": "http://xhslink.com/o/6oKW7wkJf09"
}

videoFile, coverFile, and imageFiles 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

FAQ

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.

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.

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

🏠 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).

---

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.