# Xiaohongshu (RedNote / 小红书) Live Stream & Commerce Scraper (`unitbytes/xiaohongshu-rednote-live-scraper`) Actor

The fastest Xiaohongshu (RedNote / 小红书 / XHS) Live Stream & Live Commerce scraper. Extract active live rooms across all 7 live categories, 1080p FLV & HLS (.m3u8) stream URLs, concurrent viewers, e-commerce goods flags, real-time live chat, and host KOL profiles.

- **URL**: https://apify.com/unitbytes/xiaohongshu-rednote-live-scraper.md
- **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community)
- **Categories:** E-commerce, Videos, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.40 / 1,000 scraped live stream room (with 1080p flv/hls stream & chat)s

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

<p align="center">
  <a href="https://apify.com/unitbytes/xiaohongshu-rednote-live-scraper?fpr=939u3w&fp_sid=readme" target="_blank">
    <img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/banners/unitbytes-xiaohongshu-rednote-trend-scraper-banner.jpg" alt="RedNote / Xiaohongshu Live Stream & Commerce Scraper by UnitBytes" width="100%" />
  </a>
</p>

<p align="center">
  <a href="https://apify.com/unitbytes/xiaohongshu-rednote-live-scraper?fpr=939u3w&fp_sid=readme" target="_blank">
    <img src="https://raw.githubusercontent.com/unitbytes/.github/main/assets/try-it-for-free.svg" width="240" height="48" alt="Try it for Free">
  </a>
  <br>
  <sub>⚡ <b>1-Click Free Trial:</b> Test live queries using Apify's $5 free monthly credit • No credit card required</sub>
</p>

## 🔴 Xiaohongshu (RedNote / 小红书) Live Stream, Live Commerce & 1080p Stream URL Scraper

The only **100% cookie-free Xiaohongshu (RedNote / 小红书 / XHS) Live Stream & Live Commerce Scraper** on Apify. Extract active live broadcast rooms across all **7 official RedNote Live categories (`/livelist`)**, direct **1080p `.flv` and `.m3u8` (HLS) video stream URLs**, concurrent & cumulative viewer counts, **native e-commerce shopping cart flags (`hasGoods`)**, real-time live chat messages, fan-club loyalty badges (`fansGroup`), and host KOL profiles — with **zero login or personal cookies required**.

***

<table>
  <tr>
    <td colspan="5" style="padding:10px 14px;background:#FF2442;color:#FFFFFF;font-size:13px;font-weight:700;border-radius:6px 6px 0 0">
      ⚡ UnitBytes · Xiaohongshu (RedNote) & Asian E-Commerce Ecosystem
    </td>
  </tr>
  <tr>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">🌟 <b><a href="https://apify.com/unitbytes/xiaohongshu-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">RedNote All-in-One</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">6-in-1 Flagship Suite</span><br>
      <span style="color:#64748B;font-size:11px">Trends, Live, KOL Leads, Notes & Comments</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FFF4ED;vertical-align:top;width:20%">
      <span style="white-space:nowrap">🔴 <b><a href="https://apify.com/unitbytes/xiaohongshu-rednote-live-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#C2410C;text-decoration:none;font-size:13px">RedNote Live & Commerce</a></b></span><br><span style="color:#EA580C;font-size:11px;font-weight:700">📍 You are here</span><br>
      <span style="color:#64748B;font-size:11px">1080p FLV/HLS, E-Commerce & Live Chat</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">📕 <b><a href="https://apify.com/unitbytes/xiaohongshu-rednote-trend-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">RedNote Trends & Notes</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">13 Category Feeds</span><br>
      <span style="color:#64748B;font-size:11px">Fast discovery, viral posts & HD media</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">👤 <b><a href="https://apify.com/unitbytes/xiaohongshu-rednote-profile-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">RedNote KOL & Creators</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">KOL Leads & Profiles</span><br>
      <span style="color:#64748B;font-size:11px">Followers, badges & portfolios</span>
    </td>
    <td style="padding:10px 12px;border:1px solid #E2E8F0;background:#FAFAFA;vertical-align:top;width:20%">
      <span style="white-space:nowrap">💬 <b><a href="https://apify.com/unitbytes/xiaohongshu-rednote-comments-scraper?fpr=939u3w&fp_sid=ecosystem" style="color:#0F172A;text-decoration:none;font-size:13px">RedNote Comments</a></b></span><br><span style="color:#2563EB;font-size:11px;font-weight:600">Comments & Live Chat</span><br>
      <span style="color:#64748B;font-size:11px">Nested replies (楼中楼) & buyer intent</span>
    </td>
  </tr>
</table>

***

### 🌟 Why Choose This Live Stream & Commerce Scraper?

| Feature | This Live Stream Scraper | Standard Guest Scrapers | Cookie-Based Scrapers |
| :--- | :---: | :---: | :---: |
| **Live Stream Discovery (`live`)** | **✅ All 7 Official Categories + Multi-Page Pagination** | ❌ Not Supported | ❌ Manual Browser Only |
| **Direct Video Stream URLs** | **✅ 1080p `.flv` & `.m3u8` (HLS) + Backup CDN Streams** | ❌ None | ❌ None |
| **E-Commerce Live Filter (`hasGoods`)** | **✅ Native RedNote `hasGoods: true` (`买手直播` / `店播`)** | ❌ None | ❌ None |
| **Real-Time Live Room Chat** | **✅ Embedded Chat + Standalone `liveChat` Mode + Fan Badges** | ❌ None | ❌ None |
| **Host KOL Profile Enrichment** | **✅ Optional Followers, Red ID, Likes, Verification & Bio** | ❌ None | Manual Only |
| **Account / Cookies** | **None (100% Zero Cookies Needed)** | None | User Must Supply Fragile Cookies |
| **Cold-Start Speed** | **<1s (Ultra-Lean 256MB RAM Tier)** | 10–30s Heavy Browser Warmup | 15–30s Browser Delay |

***

### 🚀 Key Capabilities

- **📺 All 7 Official RedNote Live Categories (`/livelist`) with Deep Cursor Pagination:**
  Sweep active live broadcasts across all 7 official Xiaohongshu Live channels:
  - `"0"` — **All Live Streams (`全部`)**
  - `"1"` — **Gaming (`游戏`)**
  - `"2"` — **Talent & Beauty (`才艺颜值`)**
  - `"3"` — **Lifestyle (`生活分享`)**
  - `"4"` — **Crafts & Hobbies (`兴趣手工`)**
  - `"5"` — **Tech & Finance (`科技财经`)**
  - `"6"` — **Sports & Outdoors (`运动户外`)**
- **🎬 Direct 1080p `.flv` & `.m3u8` (HLS) Video Stream Links:**
  Extracts primary and backup `1080x1920` H.264 `.flv` and `.m3u8` live stream URLs ready for `ffmpeg`, Whisper ASR speech-to-text transcription, or multimodal AI analysis.
- **🛍️ Native E-Commerce Live Shopping Flags (`hasGoods` — Prioritized First):**
  Automatically surfaces active e-commerce broadcasters (`买手直播` / `店播`) with live shopping carts enabled (`hasGoods: true`) at the top of each category page alongside full category stream coverage.
- **💬 Real-Time Live Room Chat & Buyer Intent Keywords (`mode: "live"` or `mode: "liveChat"`):**
  Captures live viewer messages (`liveChatMessages`), room-level buyer intent prompts (`buyerIntentKeywords`), and viewer fan-club badges (`fansGroup.groupName`, `fansLevel`, `activeFans`). Switch to `mode: "liveChat"` to emit standalone chat message records with automatic buyer intent sentiment classification (`high_buyer_intent`, `inquiry`, `general`).
- **👤 Host KOL Profile Enrichment:**
  Enable `includeAuthorProfile: true` to enrich every broadcaster with their full creator profile (`followerCount`, `followerCountFormatted`, `totalLikesAndCollects`, `redId`, `ipLocation`, `isVerified`, and `bio`).
- **🔒 100% No-Login / Cookie-Free Operation:**
  Runs in an ultra-fast `256 MB` RAM container with zero cookies or account credentials required. Never risk banning your personal or brand Xiaohongshu account.

***

### 🎯 Who Uses This Data? (High-Value Use Cases)

1. **Cross-Border Brands & China E-Commerce Agencies (Streamer / 买手 Recruiting):**
   Discover active e-commerce streamers (`onlyEcommerceLive: true`) sorted by `viewersTotalUv` and `viewersConcurrent`, complete with host `profileUrl`, `redId`, and follower counts for BD outreach.
2. **AI Video, Speech-to-Text (ASR) & Live Selling Intelligence:**
   Pipe direct `streamInfo.flvUrl` or `streamInfo.hlsUrl` (`.m3u8`) feeds into `ffmpeg` + Whisper ASR + Vision LLMs to transcribe live sales scripts, identify products pitched on screen, and benchmark conversion hooks.
3. **E-Commerce Analytics Platforms & Scheduled Competitive Monitoring:**
   Schedule hourly runs on Apify to track which brands and KOLs are broadcasting live, peak concurrent viewer velocity (`viewersConcurrent`), cumulative room traffic (`roomPv`), and category share of voice.
4. **Consumer Research & Real-Time Buyer Objection Mining (`mode = "liveChat"`):**
   Extract real-time pre-purchase questions (*"求链接"*, *"多少钱"*, *"敏感肌能用吗"*, *"什么码"*) and `buyerIntentKeywords` across active live rooms.

***

### 🤖 AI Agents, Multimodal LLMs & Apify MCP Server Ready

This Actor is structured for **AI Agents, RAG pipelines, Multimodal Vision/Audio LLMs, and Model Context Protocol (MCP)** workflows:

- **Plug-and-Play with Apify MCP Server (`@apify/actors-mcp-server`):** Connect `unitbytes/xiaohongshu-rednote-live-scraper` directly to **Claude Desktop, Cursor, Windsurf, LangChain, CrewAI, or OpenAI Agents** via the official Apify MCP Server so AI agents can autonomously query active RedNote live streams, inspect live shopping rooms (`hasGoods`), and analyze real-time buyer chat on demand.
- **Direct 1080p `.flv` & `.m3u8` Streams for Whisper ASR & Vision LLMs:** Every `live_room` record outputs clean `streamInfo.flvUrl` and `streamInfo.hlsUrl` links ready for `ffmpeg` frame extraction, OpenAI Whisper / Deepgram real-time speech-to-text transcription, and multimodal product recognition.
- **Pre-Labeled Buyer Intent Signals:** Both `live_room` (`buyerIntentKeywords`) and `liveChat` (`sentiment.intent`, `sentiment.isBuyerIntent`, `sentiment.keywords`) provide structured JSON signals ready for downstream LLM classification with zero pre-processing.

***

### 📥 Input Parameters

| Field | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `mode` | `string` | `"live"` | `"live"` = extract live broadcast rooms (`live_room`) with 1080p stream links, viewer stats, `hasGoods` flags & embedded chat. `"liveChat"` = extract standalone real-time chat messages (`comment`) across active rooms. |
| `liveCategories` | `array` | `["0"]` | One or more official RedNote Live category IDs: `"0"` All (`全部`), `"1"` Gaming (`游戏`), `"2"` Talent & Beauty (`才艺颜值`), `"3"` Lifestyle (`生活分享`), `"4"` Crafts & Hobbies (`兴趣手工`), `"5"` Tech & Finance (`科技财经`), `"6"` Sports & Outdoors (`运动户外`). |
| `startUrls` | `array` | `[]` | Optional direct `/livelist?channel_id=...` URLs, specific live room URLs (`room_id=...`), or 18–19 digit numeric room IDs. |
| `maxItems` | `integer` | `27` | Maximum number of live stream rooms (or standalone chat messages in `liveChat` mode) to extract (`1`–`1000`). |
| `includeLiveChat` | `boolean` | `true` | Attach real-time viewer chat messages (`liveChatMessages`), fan badges, and `buyerIntentKeywords` to each room. |
| `includeAuthorProfile` | `boolean` | `false` | Enrich each broadcaster's `author` object with `followerCount`, `followerCountFormatted`, `totalLikesAndCollects`, `redId`, and verification badges. |

***

### 💡 Input Examples

#### Example 1: Sweep Active Live Streams & E-Commerce Broadcasters (with Host KOL Profiles & 1080p Streams)

```json
{
  "mode": "live",
  "liveCategories": ["0", "3"],
  "maxItems": 30,
  "includeLiveChat": true,
  "includeAuthorProfile": true
}
```

#### Example 2: Harvest 100 Standalone Real-Time Live Chat Messages & Buyer Intent Prompts

```json
{
  "mode": "liveChat",
  "liveCategories": ["0"],
  "maxItems": 100
}
```

#### Example 3: Inspect Specific Live Broadcast Rooms by URL or Room ID

```json
{
  "mode": "live",
  "startUrls": [
    { "url": "https://www.xiaohongshu.com/livelist?channel_id=0&channel_type=web_live_list&room_id=570505062122631608" }
  ],
  "includeLiveChat": true,
  "includeAuthorProfile": true
}
```

***

### 📦 Output Samples

#### 1. Live Stream Room Record (`mode: "live"`, `itemType: "live_room"`)

```json
{
  "itemType": "live_room",
  "type": "live",
  "id": "570505062122631608",
  "roomId": "570505062122631608",
  "title": "秋冬赴暖｜设计师质感衣橱专场",
  "nickname": "十点梨穿搭记",
  "profileUrl": "https://www.xiaohongshu.com/user/profile/5b331070e8cd614138e4a9e5",
  "followerCount": 100000,
  "likedCount": 5280,
  "commentCount": 18,
  "category": "All (全部)",
  "categoryId": "0",
  "url": "https://www.xiaohongshu.com/livelist?channel_id=0&channel_type=web_live_list&room_id=570505062122631608",
  "coverUrl": "https://sns-img-qc.xhscdn.com/1040g2jo31...",
  "isLive": true,
  "hasGoods": true,
  "isPaidLive": false,
  "viewersTotalUv": 14820,
  "viewersConcurrent": 412,
  "displayCount": 412,
  "roomPv": 14820,
  "displayLikesCount": "5280",
  "displayViewerCount": "1.4万观看",
  "displayMemberCount": "412人在线",
  "roomStatus": 2,
  "monetizeType": 1,
  "hotValue": 14820,
  "pinnedAnnouncement": "新进直播间的姐妹点点关注，领30元粉丝券！",
  "buyerIntentKeywords": [
    "身高体重穿什么码",
    "几号链接",
    "划算",
    "现货"
  ],
  "liveChatCount": 18,
  "liveChatMessages": [
    {
      "id": "570505091842103219",
      "text": "主播165 98斤穿S还是M码？求3号链接",
      "originLanguage": "zh-CN",
      "author": {
        "id": "5f9a82b10000000001004c12",
        "nickname": "小鹿爱穿搭",
        "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/...",
        "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/...",
        "ipLocation": "",
        "profileUrl": "https://www.xiaohongshu.com/user/profile/5f9a82b10000000001004c12"
      },
      "fansGroup": {
        "groupName": "梨梨铁粉团",
        "fansLevel": 6,
        "intimateName": "铁粉",
        "activeFans": true,
        "hasJoined": true
      }
    }
  ],
  "streamInfo": {
    "flvUrl": "http://live-source-play.xhscdn.com/live/570505062122631608.flv",
    "hlsUrl": "http://live-source-play.xhscdn.com/live/570505062122631608.m3u8",
    "backupUrls": [
      "http://live-source-play-hw.xhscdn.com/live/570505062122631608.flv",
      "http://live-source-play-hw.xhscdn.com/live/570505062122631608.m3u8"
    ],
    "width": 1080,
    "height": 1920,
    "codec": "h264",
    "maxBitrate": 0,
    "quality": "HD"
  },
  "author": {
    "id": "5b331070e8cd614138e4a9e5",
    "nickname": "十点梨穿搭记",
    "redId": "958231044",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/...",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/5b331070e8cd614138e4a9e5",
    "followerCount": 100000,
    "followerCountFormatted": "100K+",
    "totalLikesAndCollects": 842150,
    "isVerified": true
  },
  "scrapedAt": "2026-10-20T12:00:00.000000+00:00"
}
```

#### 2. Standalone Live Chat Message Record (`mode: "liveChat"`, `itemType: "comment"`)

```json
{
  "itemType": "comment",
  "isLiveChat": true,
  "id": "570505091842103219",
  "noteId": "570505062122631608",
  "roomId": "570505062122631608",
  "roomTitle": "秋冬赴暖｜设计师质感衣橱专场",
  "roomUrl": "https://www.xiaohongshu.com/livelist?channel_id=0&channel_type=web_live_list&room_id=570505062122631608",
  "url": "https://www.xiaohongshu.com/livelist?channel_id=0&channel_type=web_live_list&room_id=570505062122631608",
  "content": "主播165 98斤穿S还是M码？求3号链接",
  "originLanguage": "zh-CN",
  "author": {
    "id": "5f9a82b10000000001004c12",
    "nickname": "小鹿爱穿搭",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/...",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/5f9a82b10000000001004c12"
  },
  "fansGroup": {
    "groupName": "梨梨铁粉团",
    "fansLevel": 6,
    "intimateName": "铁粉",
    "activeFans": true,
    "hasJoined": true
  },
  "roomBuyerIntentKeywords": ["身高体重穿什么码", "几号链接", "划算", "现货"],
  "sentiment": {
    "intent": "high_buyer_intent",
    "isBuyerIntent": true,
    "keywords": ["链接", "求链接", "什么码"]
  },
  "scrapedAt": "2026-10-20T12:00:00.000000+00:00"
}
```

***

### 💰 Monetization & Pay-Per-Event (PPE) Pricing

This Actor uses transparent, predictable **Pay-Per-Event (PPE)** pricing with automatic volume discounts on higher Apify subscription tiers:

| Event | Free Tier | Bronze | Silver | Gold / Platinum / Diamond | Description |
| :--- | :---: | :---: | :---: | :---: | :--- |
| `apify-actor-start` | **$0.00001** | $0.00001 | $0.00001 | **$0.00001** | One-time startup fee per run (virtually $0.00). |
| `note` (Live Room) | **$0.0079** | $0.0069 | $0.0059 | **$0.0054** | Charged per active live stream room extracted (includes 1080p FLV/HLS links, viewer counts, `hasGoods` e-commerce status & embedded chat). |
| `comment` (Live Chat) | **$0.0035** | $0.0031 | $0.0028 | **$0.0025** | Charged per standalone real-time live chat message extracted when `mode = "liveChat"`. |
| `profile` (Host KOL) | **$0.0059** | $0.0052 | $0.0047 | **$0.0043** | Charged per broadcaster KOL profile enriched when `includeAuthorProfile = true`. |

***

### 🔗 The UnitBytes Xiaohongshu & Sourcing Ecosystem

- 🌟 **[RedNote (Xiaohongshu) All-in-One Scraper](https://apify.com/unitbytes/xiaohongshu-scraper?fpr=939u3w\&fp_sid=ecosystem)**: Unified scraping for category trends, live streams, KOL leads, creator analytics, and comments.
- 🔴 **[RedNote Live Stream & Commerce Scraper](https://apify.com/unitbytes/xiaohongshu-rednote-live-scraper?fpr=939u3w\&fp_sid=ecosystem)** (📍 You are here): Dedicated live broadcast discovery, 1080p `.flv`/`.m3u8` stream extraction, e-commerce room filtering (`hasGoods`), and real-time live chat.
- 📕 **[RedNote Trends & Note Scraper](https://apify.com/unitbytes/xiaohongshu-rednote-trend-scraper?fpr=939u3w\&fp_sid=ecosystem)**: High-speed 13-category explore feeds, live rooms, and watermark-free HD media downloads.
- 👤 **[RedNote Creator & KOL Leads Scraper](https://apify.com/unitbytes/xiaohongshu-rednote-profile-scraper?fpr=939u3w\&fp_sid=ecosystem)**: Automated KOL lead discovery from category feeds & live streams, plus deep creator profile intelligence.
- 💬 **[RedNote Comments & Live Chat Scraper](https://apify.com/unitbytes/xiaohongshu-rednote-comments-scraper?fpr=939u3w\&fp_sid=ecosystem)**: Note comment extraction, nested replies (`楼中楼`), real-time live room chat messages, and buyer sentiment scoring.

***

### 💬 Support & Feature Requests

Need help configuring your run, requesting custom fields, or reporting an issue?

- 💬 **Apify Issues**: Open a ticket in the [Apify Issues Tab](https://apify.com/unitbytes/xiaohongshu-rednote-live-scraper/issues?fpr=939u3w)

***

### ⚖️ Compliance & Privacy

This Actor extracts **strictly publicly available data** from Xiaohongshu pages. It does not log in, bypass authentication walls, or collect private user messages. Personal data is protected by regulations such as GDPR, CCPA, and PIPL—see Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) and ensure your usage complies with applicable data privacy laws.

#### Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Xiaohongshu (RED / 小红书 / Xingin Information Technology Co., Ltd.) or any of its subsidiaries or affiliates.

# Actor input Schema

## `mode` (type: `string`):

live = scrape active Xiaohongshu Live Stream rooms (with 1080p .flv & .m3u8 video stream URLs, concurrent viewers, e-commerce goods status, embedded chat, and host KOL profiles). liveChat = extract standalone real-time live chat messages, fan-club badges & buyer intent keywords across active rooms.

## `liveCategories` (type: `array`):

Select which Xiaohongshu Live channels (/livelist) to sweep for active live broadcasts, e-commerce hosts (hasGoods), 1080p video streams, and live chat.

## `startUrls` (type: `array`):

Optional: paste Xiaohongshu live URLs such as 'https://www.xiaohongshu.com/livelist?channel_id=0\&channel_type=web_live_list', room URLs with 'room_id=...', or bare 18-19 digit numeric room IDs. Leave empty to sweep the selected Live Stream Categories above.

## `maxItems` (type: `integer`):

Maximum number of live stream rooms (or standalone chat messages when Mode = Live Chat) to extract. Supports multi-page cursor pagination across active broadcasts.

## `includeLiveChat` (type: `boolean`):

When enabled, queries each live room's real-time chat feed to attach active viewer messages, fan-club badges (fansGroup), and buyer intent keywords.

## `includeAuthorProfile` (type: `boolean`):

When enabled, enriches each live broadcaster's author object with their full KOL profile metrics (followerCount, followerCountFormatted, totalLikesAndCollects, redId, bio, verification).

## `proxyConfiguration` (type: `object`):

Pre-configured with Apify Residential (Hong Kong) for reliable access.

## Actor input object example

```json
{
  "mode": "live",
  "liveCategories": [
    "0"
  ],
  "maxItems": 27,
  "includeLiveChat": true,
  "includeAuthorProfile": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "HK"
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

Overview of extracted Xiaohongshu live broadcast rooms, 1080p video streams, e-commerce status, and host KOL profiles.

## `chat` (type: `string`):

Standalone real-time live room chat messages, fan-club loyalty badges, and buyer intent classifications.

# 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 = {
    "mode": "live",
    "liveCategories": [
        "0"
    ],
    "maxItems": 27,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "HK"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("unitbytes/xiaohongshu-rednote-live-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 = {
    "mode": "live",
    "liveCategories": ["0"],
    "maxItems": 27,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "HK",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("unitbytes/xiaohongshu-rednote-live-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 '{
  "mode": "live",
  "liveCategories": [
    "0"
  ],
  "maxItems": 27,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "HK"
  }
}' |
apify call unitbytes/xiaohongshu-rednote-live-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/xiaohongshu-rednote-live-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/ZzIkWdpeBlh1vS6I9/builds/bAXaYO4GSXDL1wfiW/openapi.json