Rednote Video Downloader avatar

Rednote Video Downloader

Pricing

from $1.50 / 1,000 results

Go to Apify Store
Rednote Video Downloader

Rednote Video Downloader

Get a direct download link + structured metadata for any 小红书 (Rednote / Xiaohongshu) video post. Video posts only.

Pricing

from $1.50 / 1,000 results

Rating

0.0

(0)

Developer

Blue Puppy

Blue Puppy

Maintained by Community

Actor stats

0

Bookmarked

5

Total users

0

Monthly active users

7 days ago

Last modified

Share

Rednote (小红书) Video Downloader

Get a direct CDN download link + structured metadata for any 小红书 (Rednote / Xiaohongshu) video post. Paste a batch of post URLs, run once on the Apify Console or via the Apify API. Video posts only.

Quick start

  1. In the Input tab, paste Rednote post URLs into Rednote post URLs (one per line, or as JSON).
  2. Click Start and wait for the run to finish. A 10-URL batch takes ~60s.
  3. Open the Dataset tab to inspect, filter, and download the results.

Input

FieldTypeRequiredNotes
urlsarrayyesAt least 1 item; each is a Rednote post URL. Bounded by maxUrls.
maxUrlsintegernoSoft cap on URLs per run. Default 100; 0 = unlimited. Does not affect the per-10-URL proxy session rotation.

Supported URL formats:

{
"urls": [
{ "url": "https://www.xiaohongshu.com/explore/abc123?xsec_token=XYZ" },
{ "url": "https://xhslink.com/a/abcdef" }
]
}

Output

Each URL becomes one flat row in the default dataset (status: "ok" with fields populated, or status: "error" with fields null and an error object). All URLs in a batch are processed independently — one failure does not short-circuit the others.

{
"url": "https://www.xiaohongshu.com/explore/abc123?xsec_token=XYZ",
"status": "ok",
"downloadUrl": "https://sns-video-bd.xhscdn.com/xyz123",
"id": "abc123",
"title": "Hello",
"description": "A description",
"type": "video",
"publishedAt": "2023-11-14T22:13:20+00:00",
"updatedAt": "2023-11-14T22:15:00+00:00",
"authorName": "Alice",
"authorId": "uid1",
"authorUrl": "https://www.xiaohongshu.com/user/profile/uid1",
"favoriteCount": 5,
"commentCount": 3,
"shareCount": 2,
"likeCount": 12,
"tags": ["tag1", "tag2"],
"error": null
}

Data fields

FieldTypeNotes
urlstringinput URL this row corresponds to
statusstring"ok" (fields populated) or "error" (fields null + error)
downloadUrlstring | nullsns-video-bd.xhscdn.com CDN URL for the video bytes
idstringnote ID
title / descriptionstring | null
typestringalways "video" for accepted Works
publishedAt / updatedAtstring | nullISO-8601 (+00:00 offset)
authorName / authorId / authorUrlstring | nullauthorUrl is xiaohongshu.com/user/profile/{authorId}
favoriteCount / commentCount / shareCount / likeCountnumber | nullnull when upstream reports -1
tagsstring[]empty [] when none
errorobject | null{ code, message } on error; null on success

The Actor returns the download link only; it does not fetch or persist the video bytes. CDN links may expire — re-run to get a fresh one.

Error codes

CodeMeaningRetry helps?
invalid_urlURL was not recognized as a Rednote post linkno
fetch_failedHTTP/transport error fetching the pageyes
parse_failedPage was fetched but the Work data (or Download Link) could not be extractedsometimes
not_videoWork resolved but is 图文 / 图集, not a Videono

Tips

  • CDN URLs expire. Read the latest downloadUrl before the link lapses.

FAQ, disclaimers, and support

  • Is scraping 小红书 legal? This Actor is provided for data you have the right to access (your own content, or content whose ToS permits programmatic access). You are responsible for complying with 小红书's Terms of Service and applicable law.
  • Known limitations: only video posts are supported (image / 图集 posts return not_video); the Actor returns the download link; CDN URLs expire and may require a re-run.
  • Report issues in the Issues tab of the Actor on Apify. For custom extraction needs (more URL formats, recursive crawling, download persistence), a custom Actor can be built on request.