Pricing

Rating

Developer

Actor stats

Categories

Share

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

Segmented MP4 recording, room metadata, host profile, and live chat from any Xiaohongshu (小红书) live broadcast, unattended for up to 4 hours per run. Auto-pick a live room or target a specific stream.

👁 RedNote (Xiaohongshu) live recorder: live broadcasts saved to MP4 with room metadata, host profile, and chat messages

Copy to your AI assistant

zen-studio/rednote-live-recorder on Apify. Records any Xiaohongshu (小红书) live 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, optionally, the live chat stream (one dataset row per message). 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). Call ApifyClient("TOKEN").actor("zen-studio/rednote-live-recorder").call(run_input={"liveUrls":["auto"],"captureChat":true,"runTime":10}), thenread 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

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 nothing is lost if the run ends early
• 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: capture chat messages into the dataset, one row per message, with sender, fan-club badge, and language
• Auto or targeted: paste a live-stream URL or numeric room id, or use auto to record a currently-live room
• Free tier: 5 lifetime runs, 60 seconds each, no credit card

How to Record a Xiaohongshu Live Stream

Basic: auto-pick a currently-live room

{
"liveUrls":["auto"]
}

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:

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

Input Parameters

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)

You are billed for connected time, by the second, with no per-file or per-message charge. Two 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:

A 30-minute recording with live chat on the Free plan is about $4.50 ($2.70 recording + $1.80 chat). Video only is about $2.70.

Free tier: 5 lifetime runs, 60 seconds each. No credit card.

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? Standard MP4 files, playable in any modern player. 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 confirms the room is offline before stopping, so short network blips do not cut the recording short.

What's the free tier? 5 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

• 👁 Image
  RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Note Detail Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Product Reviews Scraper
• 👁 Image
  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
• 👁 Image
  Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper

🛒 E-commerce

• 👁 Image
  Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Product Detail Scraper
  • Taobao Seller Products Scraper
• 👁 Image
  JD.com 京东
  • JD.com Search Scraper
• 👁 Image
  1688 阿里巴巴
  • 1688 Wholesale Scraper
  • Alibaba Scraper
• 👁 Image
  Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper

🏠 Real estate & autos

• 👁 Image
  Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 👁 Image
  58.com 58同城
  • 58.com Real Estate Scraper
• 👁 Image
  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 any Xiaohongshu (小红书) live broadcast to MP4 video segments, with room metadata, host profile, viewer counts, and the live chat stream, unattended for up to 4 hours per run.