# RedNote (Xiaohongshu) Note Scraper: Video & Image Downloader (`zen-studio/rednote-note-detail-scraper`) Actor

Scrape RedNote (Xiaohongshu) notes: text, likes, comments, author, tags. Optionally download 4K videos, original images, Live Photos and SRT subtitles with English translations. Paste share links, note URLs or IDs. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/zen-studio/rednote-note-detail-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** Social media, Videos, Automation
- **Stats:** 1,416 total users, 249 monthly users, 98.7% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.99 / 1,000 note details

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

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

<p><a href="https://console.apify.com/actors/KUsXYaUL4BmKEjYjf/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/rednote-note-detail-scraper-hero-v2.png" alt="Original RedNote photos, up to 4K video and Live Photos. Full-resolution files, not previews. Source-inspired RedNote note artwork."></a></p>

<p><strong>From Zen Studio.</strong> Creators of <a href="https://apify.com/zen-studio/rednote-search-scraper">RedNote Search</a> and <a href="https://apify.com/zen-studio/douyin-search-scraper">Douyin Search</a>, which have ranked <strong>#1 for “rednote” and “douyin”</strong>, respectively, in Apify Store relevance results, with <strong>100,000+ combined lifetime runs</strong>.</p>

### Why choose this actor?

<ul>
<li><strong>Original photos, not previews.</strong> 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 <code>url_original</code> link.</li>
<li><strong>The best video each note offers.</strong> Choose <strong>Highest available</strong> for up to 4K, or <strong>Most compatible</strong> for H.264 that plays everywhere. Every saved video lists its resolution and codec.</li>
<li><strong>Live Photos, subtitles and the post, together.</strong> 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.</li>
</ul>

<p><a href="https://console.apify.com/actors/KUsXYaUL4BmKEjYjf/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/rednote-note-detail-scraper-cta-v2.png" width="264" height="46" alt="Download RedNote media →"></a></p>

### Try a video and a Live Photo note

<p>Open the actor’s <a href="https://console.apify.com/actors/KUsXYaUL4BmKEjYjf/input">input page</a>, switch to JSON and paste this. Replace the examples with your own note links, then start the run.</p>

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

<p>Saved files appear in <code>videoFile</code>, <code>imageFiles</code> and <code>livePhotoFiles</code>, 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 <code>"videoQuality": "compatible"</code>.</p>
<p>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.</p>

### Continue your research

<table>
<tr>
<td style="padding:10px 14px;background:#FF2442;color:#1C1917;font-size:13px;font-weight:700;border-radius:4px 4px 0 0">Zen Studio · RedNote &amp; Likee</td>
</tr>
<tr>
<td style="padding:6px;border:1px solid #E7E5E4;border-top:none;border-radius:0 0 4px 4px;background:#FFF0EE">
<span style="display:inline-block;vertical-align:top;margin:4px;padding:8px 12px;border:1px solid #E7E5E4;border-radius:4px;background:#FFDED8"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-KUsXYaUL4BmKEjYjf-X1HWVHrvau-xiaohongshu-search-scraper-logo-square.png" width="20" height="20" alt="" style="vertical-align:middle">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/rednote-note-detail-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Note Detail</a></span><br><span style="color:#57534E;font-size:12px;white-space:nowrap">You are here</span></span>
<span style="display:inline-block;vertical-align:top;margin:4px;padding:8px 12px;border:1px solid #E7E5E4;border-radius:4px;background:#FFF0EE"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-hO5NqsA6aC1bz3jra-MjB05eVFEt-xiaohongshu-search-scraper-logo-square.png" width="20" height="20" alt="" style="vertical-align:middle">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/rednote-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">RedNote Search</a></span><br><span style="color:#57534E;font-size:12px;white-space:nowrap">Post search</span></span>
<span style="display:inline-block;vertical-align:top;margin:4px;padding:8px 12px;border:1px solid #E7E5E4;border-radius:4px;background:#FFF0EE"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-sAWbV6wp5XO5aEapx-C7gOsPJt9Q-xiaohongshu-search-scraper-logo-square.png" width="20" height="20" alt="" style="vertical-align:middle">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/rednote-comments-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Comments</a></span><br><span style="color:#57534E;font-size:12px;white-space:nowrap">Comments &amp; replies</span></span>
<span style="display:inline-block;vertical-align:top;margin:4px;padding:8px 12px;border:1px solid #E7E5E4;border-radius:4px;background:#FFF0EE"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="20" height="20" alt="" style="vertical-align:middle">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/rednote-user-profile-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Creator Profiles</a></span><br><span style="color:#57534E;font-size:12px;white-space:nowrap">Creators &amp; posts</span></span>
<span style="display:inline-block;vertical-align:top;margin:4px;padding:8px 12px;border:1px solid #E7E5E4;border-radius:4px;background:#FFF0EE"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-W1gPQtJKpQCTqUyiU-YNqixGFDej-likee-video-scraper-icon-v1.png" width="20" height="20" alt="" style="vertical-align:middle">&nbsp;&nbsp;<a href="https://apify.com/zen-studio/likee-video-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Likee Scraper</a></span><br><span style="color:#57534E;font-size:12px;white-space:nowrap">Videos and MP4 files</span></span>
</td>
</tr>
</table>

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

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

#### Multiple notes from full URLs

```json
{
    "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

```json
{
    "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

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

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

```json
{
    "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

```json
{
  "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

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

#### Bulk-fetch a known set of notes

```json
{
  "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

```json
{ "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](https://apify.com/zen-studio/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](https://apify.com/zen-studio/rednote-comments-scraper) pulls the threads, and [RedNote User Profile Scraper](https://apify.com/zen-studio/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**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-bQs2vUPAj8qDbK7EV-bMB0MSMGRY-douban-scraper-logo.png" width="16" height="16" alt="Douban 豆瓣 scraper icon" style="vertical-align:middle;border-radius:3px"> **Douban 豆瓣**
  - [Douban Scraper](https://apify.com/zen-studio/douban-scraper)
  - [Douban Reviews Scraper](https://apify.com/zen-studio/douban-reviews-scraper)
  - [Douban Group Scraper](https://apify.com/zen-studio/douban-group-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-YOq90GHMVnTe8qtHO-UAXIIQ87Oj-zhihu-scraper-logo.png" alt="Zhihu 知乎 scraper" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Zhihu 知乎**
  - [Zhihu Scraper](https://apify.com/zen-studio/zhihu-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-wsZZkHvCzyyfZQdaJ-1H1H3xrBpO-weibo-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Weibo 微博**
  - [Weibo Search Scraper](https://apify.com/zen-studio/weibo-search-scraper)
  - [Weibo Comments Scraper](https://apify.com/zen-studio/weibo-comments-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-euYaQMbH2g53W4ds2-Woud1TIQ7x-kwai-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Kwai (Brazil)**
  - [Kwai Search Scraper](https://apify.com/zen-studio/kwai-search-scraper)
  - [Kwai Comments Scraper](https://apify.com/zen-studio/kwai-comments-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
  - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper)
  - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper)
  - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder)
  - [RedNote Product Detail Scraper](https://apify.com/zen-studio/rednote-product-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
  - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-oSxuPDE1h3HAsHZSu-x3uV98mgTe-bilibili-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Bilibili 哔哩哔哩**
  - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper)
  - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper)

**🛒 E-commerce**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsVmeHsn8748GeSDv-Ktzu3u1ZW9-icon.png" width="16" height="16" alt="TikTok Shop scraper icon" style="vertical-align:middle;border-radius:3px"> **TikTok Shop**
  - [TikTok Shop Review Scraper](https://apify.com/zen-studio/tiktok-shop-review-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-yK9Fwkji44bQkuS7P-f1uyK15FaQ-naver-shopping-scraper.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Naver Search 네이버 검색**
  - [Naver Search Scraper](https://apify.com/zen-studio/naver-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-LwARSYSMWLBZfXfdr-FrDaNbQarB-shopee-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Shopee**
  - [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper)
  - [Shopee Product Reviews Scraper](https://apify.com/zen-studio/shopee-product-reviews-scraper)
  - [Shopee Product Scraper](https://apify.com/zen-studio/shopee-product-scraper)
  - [Shopee Live Scraper](https://apify.com/zen-studio/shopee-live-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD.com 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
  - [1688 Reviews Scraper](https://apify.com/zen-studio/1688-reviews-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)
  - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper)
  - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper)
  - [Goofish (Xianyu) Reverse Image Search Scraper](https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Coupang 쿠팡**
  - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper)
  - [Coupang Search Scraper](https://apify.com/zen-studio/coupang-search-scraper)
  - [Coupang Product Detail Scraper](https://apify.com/zen-studio/coupang-detail-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-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.*

# Actor input Schema

## `noteUrls` (type: `array`):

Xiaohongshu note links. Each runs independently and counts as one result.<br><br>• Share link: <code>http://xhslink.com/o/XXXXXXX</code> or <code>https://xhslink.cn/o/XXXXXXX</code><br>• Full URL: <code>https://www.xiaohongshu.com/discovery/item/\<id>?xsec_token=...\&xsec_source=...</code><br>• Note opened from a creator's profile: <code>https://www.xiaohongshu.com/user/profile/\<user id>/\<note id>?xsec_token=...</code><br>• Bare note ID: <code>6a06c9360000000036001d5a</code> (24 hex characters)<br><br>You can also paste the whole share-text the app copies; the link inside it is detected automatically.<br><br><b>Not a note link:</b> a creator profile with no note after it (<code>https://www.xiaohongshu.com/user/profile/\<user id></code>) opens a person, not a note. To get a creator's posts, use the <b>RedNote User Profile & Notes Scraper</b> instead.

## `downloadVideos` (type: `boolean`):

Save each video note's MP4 to your key-value store, in the quality chosen below. Requires a paid Apify plan. Adds <b>$3.99 to $4.49 per 1,000 saved videos</b>, depending on your plan. Image notes have no video.

## `videoQuality` (type: `string`):

Which version of the video to save when <b>Download videos</b> is on.<br><br>• <b>Highest available</b>: the largest resolution the note offers, up to 4K. High resolutions are usually H.265 (HEVC).<br>• <b>Most compatible</b>: H.264, which plays in every browser, phone and editor, usually at 720p.<br><br>Each saved video lists its resolution and codec in <code>videoFile</code>.

## `downloadCovers` (type: `boolean`):

Save each video note's cover image as the original full-resolution file. Requires a paid Apify plan. Adds <b>$1.59 to $1.79 per 1,000 saved images</b>, depending on your plan.

## `downloadImages` (type: `boolean`):

For image notes, save every gallery image as the original full-resolution file, in the format it was uploaded (JPEG, PNG or WEBP; iPhone HEIC photos are converted to JPEG). A Live Photo also saves its motion clip as an MP4, counted as one more image. Requires a paid Apify plan. Adds <b>$1.59 to $1.79 per 1,000 saved images</b>, depending on your plan. Has no effect on video notes.

## `downloadSubtitles` (type: `boolean`):

Save each video note's subtitle tracks as <code>.srt</code> files (original transcript plus any auto-translated languages). <b>Free</b>, no extra charge. Only video notes that have subtitles produce files.

## `mediaKvStoreName` (type: `string`):

Save downloaded media to a <b>named, persistent</b> key-value store you can reuse across runs. Leave blank to use this run's default store (deleted after the platform retention period). Letters, digits, and dashes only (max 63 characters).

## `feedback` (type: `string`):

For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.

## Actor input object example

```json
{
  "noteUrls": [
    "http://xhslink.com/o/6oKW7wkJf09"
  ],
  "downloadVideos": false,
  "videoQuality": "highest",
  "downloadCovers": false,
  "downloadImages": false,
  "downloadSubtitles": false,
  "mediaKvStoreName": ""
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset of notes — one row per note.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "noteUrls": [
        "http://xhslink.com/o/6oKW7wkJf09"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/rednote-note-detail-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "noteUrls": ["http://xhslink.com/o/6oKW7wkJf09"] }

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/rednote-note-detail-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "noteUrls": [
    "http://xhslink.com/o/6oKW7wkJf09"
  ]
}' |
apify call zen-studio/rednote-note-detail-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/rednote-note-detail-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KUsXYaUL4BmKEjYjf/builds/mPMHVvtlgp02pQWZ3/openapi.json
