RedNote (Xiaohongshu / 小红书) Live Recorder | Record Live Streams to MP4, Chat + Room Data (2026)

From Zen Studio. Creators of RedNote Search and Douyin Search, which have ranked #1 for “rednote” and “douyin”, respectively, in Apify Store relevance results, with 100,000+ combined lifetime runs.

Why choose this actor?

• Download video before the broadcast ends. Get MP4 segments with individual download links as each segment finishes. Start reviewing saved footage while the actor keeps recording.
• Save audience questions alongside the video. Enable live chat to collect message text, sender names and available fan badges. Review questions and reactions after the session, with chat kept as structured data.
• Record for up to four hours, with host details. Target a live-room link or let the actor pick a room. Keep the host’s name, room title, cover and available viewer and like counts with the recording.

Try a one-minute recording

Open the actor’s input page, switch to JSON and paste this. It requests a one-minute sample of a currently live room, with video and chat enabled.

{
  "liveUrls": [
    "auto"
  ],
  "runTime": 1,
  "recordVideo": true,
  "captureChat": true,
  "uploadEvery": 1
}

Replace auto with a RedNote live-room URL to choose a broadcast. The actor records the first room in the list. Download MP4s through the run’s OUTPUT record; chat and room details appear in the dataset.

Chat is optional and billed separately while enabled. Set captureChat to false for video only. Busy broadcasts may contain more messages than the actor returns; chat is not a guaranteed complete transcript.

Apify Free plan: 15 lifetime preview runs, capped at one minute each. Longer recordings require a paid Apify plan.

Zen Studio · Live streams & creators
RedNote Live You are here	Douyin Live Video & live events	RedNote Search Post search	Creator Profiles Creators & posts

Copy to your AI assistant

zen-studio/rednote-live-recorder on Apify. Records a currently live Xiaohongshu (小红书) broadcast to MP4 video segments in your key-value store, and emits room metadata (title, host profile, viewer / member / like counts, stream quality ladder) plus optional live chat (one dataset row per collected message; coverage may be partial). Input liveUrls accepts a xiaohongshu.com/livestream/<id> URL, a numeric room id, or "auto" to pick a currently-live room; runTime caps the recording in minutes (0 = until the broadcaster ends, within the four-hour run limit). Only the first room is recorded. Chat is billed separately while enabled. Call ApifyClient("TOKEN").actor("zen-studio/rednote-live-recorder").call(run_input={"liveUrls":["auto"],"captureChat":True,"runTime":1}), then read dataset rows via client.dataset(run["defaultDatasetId"]).list_items().items and the recordings[] manifest via client.key_value_store(run["defaultKeyValueStoreId"]).get_record("OUTPUT"). Full spec: GET https://api.apify.com/v2/acts/zen-studio~rednote-live-recorder/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.

Key Features

• MP4 recording, saved as you go: the broadcast is recorded to video segments that land in your storage while the stream is still live, so completed uploads remain available if the run ends early; an unfinished segment may be lost
• Room metadata + host profile: title, cover, host nickname and id, viewer / member / like counts, and the available quality ladder (codec and bitrate per stream)
• Optional live chat: collect available messages into the dataset with sender, fan-club badge and language when present; complete chat coverage is not guaranteed
• Auto or targeted: paste a live-stream URL or numeric room id, or use auto to record a currently-live room
• Apify Free plan: 15 lifetime preview runs, capped at 60 seconds each

How to Record a Xiaohongshu Live Stream

Basic: auto-pick a currently-live room

{
    "liveUrls": ["auto"],
    "runTime": 1
}

Record a specific live stream

{
    "liveUrls": ["https://www.xiaohongshu.com/livestream/570305058583373361"]
}

Record with live chat, capped at 30 minutes

{
    "liveUrls": ["570305058583373361"],
    "captureChat": true,
    "runTime": 30
}

Long unattended recording into a reusable store

{
    "liveUrls": ["auto"],
    "runTime": 120,
    "uploadEvery": 5,
    "recordingsKvStore": "my-rednote-recordings"
}

Where Do I Get a Live-Stream Link?

Open a live room in the Xiaohongshu app or on the web and copy the link. Any of these work:

Format	Example	Works
Live-stream URL	https://www.xiaohongshu.com/livestream/570305058583373361	✅
Numeric room id	570305058583373361	✅
auto keyword	auto	✅ picks a live room for you

A broadcast has to be live at the moment the run starts. If it has already ended, there is nothing to record.

Input Parameters

Parameter	Type	Default	Description
liveUrls	array	["auto"]	One or more live streams: a xiaohongshu.com/livestream/<id> URL, a numeric room id, or auto. The first entry is recorded.
runTime	integer	0	How long to record, in minutes. 0 = until the broadcaster ends the stream (capped at the 4-hour platform limit).
recordVideo	boolean	true	Save the broadcast as MP4 video segments to your storage.
videoQuality	string	highest	highest for the best available resolution, or lowest for smaller files.
uploadEvery	integer	5	Minutes of footage per MP4 segment. Shorter segments appear in your storage sooner; longer segments mean fewer files.
recordingsKvStore	string	""	Name of a key-value store for the recordings. Leave blank for the run's default store. Download or retain files according to your Apify storage settings.
captureChat	boolean	false	Also capture live chat messages into the dataset, one row per message.

What Data Do You Get?

The dataset holds three kinds of rows, and the run's key-value store holds the MP4 files plus an OUTPUT manifest that lists them.

Room info (one row): room_id, status, room_title, room_cover, viewer_count, member_count, praise_count, host (nickname, id, avatar), streams[] (quality name, codec, bitrate), and media (width, height).

Chat (one row per message, when captureChat is on): comment_id, user_id, nick_name, msg, fans_group, role, at_users, origin_language.

Summary (one row): the run outcome, including segment count, total bytes, recorded duration, chat message count, and reason_for_exit.

Recordings manifest (OUTPUT record): one entry per saved MP4 with key, seq, started_at_ms, ended_at_ms, duration_s, bytes, quality, codec, and kv_url (a direct download link).

Output Example

Room info row:

{
  "type": "room_info",
  "room_id": "570305058583373361",
  "status": 2,
  "room_title": "听说今天有礼物",
  "room_cover": "http://sns-na-i1.xhscdn.com/alpha_image/...webp",
  "viewer_count": 998,
  "member_count": 16,
  "praise_count": 13000,
  "host": {
    "nick_name": "過期小八",
    "user_id": "67cf4304000000000e01e88a",
    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/...jpg"
  },
  "streams": [
    { "quality_type_name": "蓝光(高帧率)", "codec": "h265", "max_bitrate": 6000000, "protocol": "flv" },
    { "quality_type_name": "超清", "codec": "h265", "max_bitrate": 2000000, "protocol": "flv" },
    { "quality_type_name": "原画", "codec": "h264", "max_bitrate": 3500000, "protocol": "" }
  ],
  "media": { "width": 1080, "height": 1920 }
}

Chat row:

{
  "type": "chat",
  "room_id": "570305058583373361",
  "comment_id": "7647528465717583404",
  "user_id": "52d8c541b4c4d60e6c867480",
  "nick_name": "拽姐的内心~",
  "msg": "这歌有什么问题啊？",
  "fans_group": { "has_join": true, "fans_level": 20, "group_name": "小八", "intimate_name": "钟爱粉" },
  "role": 0,
  "at_users": [],
  "origin_language": "zh_cn"
}

Summary row, and the recordings manifest from the OUTPUT record:

{
  "type": "summary",
  "room_id": "570305058583373361",
  "record_video": true,
  "capture_chat": true,
  "video_quality": "highest",
  "duration_seconds": 75.5,
  "recording_segments": 1,
  "recording_total_bytes": 15092562,
  "recording_total_duration_s": 59.1,
  "chat_emitted": 9,
  "reason_for_exit": "runtime_cap"
}

{
  "recordings": [
    {
      "key": "recording_570305058583373361_0000.mp4",
      "seq": 0,
      "started_at_ms": 1780579004088,
      "ended_at_ms": 1780579063147,
      "duration_s": 59.1,
      "bytes": 15092562,
      "quality": "highest",
      "codec": "h265",
      "kv_url": "https://api.apify.com/v2/key-value-stores/<storeId>/records/recording_570305058583373361_0000.mp4"
    }
  ]
}

Advanced Usage

Record the whole broadcast, however long it runs

{ "liveUrls": ["auto"], "runTime": 0, "uploadEvery": 5 }

Capture only the live chat, no video

{ "liveUrls": ["570305058583373361"], "recordVideo": false, "captureChat": true, "runTime": 60 }

Smaller files for a long session

{ "liveUrls": ["auto"], "videoQuality": "lowest", "uploadEvery": 10, "runTime": 180 }

Pricing: Pay Per Event (PPE)

Recording and optional chat are billed by active time, in seconds. The rates below cover two time-based events:

• Recording accrues while video is being captured.
• Live chat accrues only while chat capture is on. A video-only run never incurs it.

Rates drop with your Apify plan:

Your Apify plan	Recording / hour	Live chat / hour
Free	$5.40	$3.60
Bronze	$5.04	$3.35
Silver	$4.68	$3.13
Gold and above	$4.32	$2.88

The table shows recording and live-chat time charges. Chat is an additional charge; a video-only run only accrues recording time. See the actor’s Pricing tab for other applicable charges.

Apify Free plan: 15 lifetime preview runs, capped at 60 seconds each. Longer recordings require a paid Apify plan.

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. Creators and shops there run live broadcasts for product launches, sales, and Q&A sessions, which is what this actor records.

How long can I record? Up to 4 hours per run. Set runTime in minutes, or 0 to record until the broadcaster ends the stream.

What video format do I get? MP4 files. Playback requires a player that supports the recorded stream's video codec. Long broadcasts are split into segments so they appear in your storage while the stream is still live.

Where do the recordings go? Into your run's key-value store by default, or a named store you set with recordingsKvStore. The OUTPUT record lists every segment with a direct download link.

Can I record without saving video? Yes. Set recordVideo to false and captureChat to true to collect just the live chat.

What does auto do? It picks a currently-live room for you, useful when you just want a sample or don't have a specific stream in mind.

What happens when the stream ends? The run finishes cleanly, saves the final segment, and writes the summary. The reason_for_exit field tells you whether it ended because the broadcast stopped, the run time was reached, or the stream went quiet.

Are the viewer and like counts exact? They are returned as integers. Counts that Xiaohongshu rounds for display (e.g. 1.3万) become best-effort integers (13000).

Why did a recording stop early? A broadcast can end at any time, or briefly drop out. The recorder checks whether the room is still live after a stall and can continue when the connection recovers. Persistent interruptions can still end a recording; previously uploaded segments remain available.

What's the free tier? 15 lifetime runs, each capped at 60 seconds of recording, one room. Enough to see a real MP4 sample and the data shape.

How fresh is the data? Live from the broadcast at run time. There is no cache.

Do I need a Xiaohongshu account or cookies? No. Paste a live-stream URL, a room id, or auto and run; no account, cookie export, or QR login is involved.

Can I scrape regular notes, comments, or profiles too? Not with this actor; it records live broadcasts only. Use RedNote Search Scraper for keyword search, RedNote Note Detail Scraper for full notes, and RedNote User Profile Scraper for creator back-catalogues.

Is it legal to record Xiaohongshu live streams? The actor records publicly broadcast streams only, nothing behind a login. You are responsible for complying with Xiaohongshu's terms of service, broadcasters' rights, and applicable data protection law (GDPR, CCPA, PIPL), especially before republishing recordings or chat data.

More Zen Studio scrapers for Chinese platforms

🎬 Short-video & social

• Douban 豆瓣
  • Douban Scraper
  • Douban Reviews Scraper
  • Douban Group Scraper
• Zhihu 知乎
  • Zhihu Scraper
• Weibo 微博
  • Weibo Search Scraper
  • Weibo Comments Scraper
• Kwai (Brazil)
  • Kwai Search Scraper
  • Kwai Comments Scraper
• RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Note Detail Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Product Reviews Scraper
  • RedNote Product Detail 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
  • Douyin Product Search Scraper
• Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper
• Bilibili 哔哩哔哩
  • Bilibili Video Scraper
  • Bilibili Danmaku Scraper

🛒 E-commerce

• TikTok Shop
  • TikTok Shop Review Scraper
• Naver Search 네이버 검색
  • Naver Search Scraper
• Shopee
  • Shopee Product Detail Scraper
  • Shopee Product Reviews Scraper
  • Shopee Product Scraper
  • Shopee Live Scraper
• Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
• JD.com 京东
  • JD.com Search Scraper
• 1688 阿里巴巴
  • 1688 Wholesale Scraper
  • Alibaba Scraper
  • 1688 Reviews Scraper
• Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper
  • Goofish (Xianyu) Reverse Image Search Scraper
• Coupang 쿠팡
  • Coupang Review Scraper
  • Coupang Search Scraper
  • Coupang Product Detail 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).

---

Record Xiaohongshu (小红书) live broadcasts as downloadable MP4 segments, with available room and host details plus optional live chat, for up to 4 hours per run.