Rednote Video Downloader
Pricing
from $1.50 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
5
Total users
0
Monthly active users
7 days ago
Last modified
Categories
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
- In the Input tab, paste Rednote post URLs into Rednote post URLs (one per line, or as JSON).
- Click Start and wait for the run to finish. A 10-URL batch takes ~60s.
- Open the Dataset tab to inspect, filter, and download the results.
Input
| Field | Type | Required | Notes |
|---|---|---|---|
urls | array | yes | At least 1 item; each is a Rednote post URL. Bounded by maxUrls. |
maxUrls | integer | no | Soft 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
| Field | Type | Notes |
|---|---|---|
url | string | input URL this row corresponds to |
status | string | "ok" (fields populated) or "error" (fields null + error) |
downloadUrl | string | null | sns-video-bd.xhscdn.com CDN URL for the video bytes |
id | string | note ID |
title / description | string | null | |
type | string | always "video" for accepted Works |
publishedAt / updatedAt | string | null | ISO-8601 (+00:00 offset) |
authorName / authorId / authorUrl | string | null | authorUrl is xiaohongshu.com/user/profile/{authorId} |
favoriteCount / commentCount / shareCount / likeCount | number | null | null when upstream reports -1 |
tags | string[] | empty [] when none |
error | object | 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
| Code | Meaning | Retry helps? |
|---|---|---|
invalid_url | URL was not recognized as a Rednote post link | no |
fetch_failed | HTTP/transport error fetching the page | yes |
parse_failed | Page was fetched but the Work data (or Download Link) could not be extracted | sometimes |
not_video | Work resolved but is 图文 / 图集, not a Video | no |
Tips
- CDN URLs expire. Read the latest
downloadUrlbefore 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.