🚀 RedNote (Xiaohongshu) Search Scraper – Multi-Keyword & Batch

English | 中文帮助

✨ Why This Actor?

• Multi-keyword batch — Search 露营, 美妆, 宠物 in one run (同时搜索多个词)
• Super fast — 2-5 seconds per keyword, no browser needed
• Cookie auto-save — Provide once, we reuse it (一次提供，自动保存)
• Error tolerance — Skipped failures don't break the task
• Full detail — Note body, images, tags, comments (正文/图片/评论)

---

📥 Quick Start (3 Steps)

Step 1: Get Cookie 🔑 (only once)

Why do I need a cookie? The cookie tells Xiaohongshu that you're a real logged-in user. We only use it for search, nothing else. Your cookie is never shared or stored outside this Actor. 为什么需要 Cookie？Cookie 用于验证你的登录身份，让 Actor 能够正常搜索小红书数据。不会被用于其他用途。

🖥️ Detailed Walkthrough (with screenshots)

Follow these steps exactly — it takes less than 30 seconds:

1️⃣ Open your browser (Chrome, Edge, or Firefox) and go to www.xiaohongshu.com

2️⃣ Log in with your Xiaohongshu account (手机号/微信/小红书账号均可)

3️⃣ Press F12 to open Developer Tools

• Mac users: Cmd+Option+I
• You should see a panel open on the right or bottom of your browser

4️⃣ Click the "Application" tab (应用程序) at the top of the Developer Tools panel

• If you don't see "Application", click the » (More tabs) button first

5️⃣ Find Cookies in the left sidebar:

• Expand Cookies (or Storage → Cookies)
• Click https://www.xiaohongshu.com
• You should now see a table of cookies

6️⃣ Select and copy:

• Click anywhere in the cookie table
• Press Ctrl+A (or Cmd+A on Mac) to select all
• Press Ctrl+C (or Cmd+C on Mac) to copy
• ✅ The entire cookie string is now on your clipboard

📋 Cookie table example:
┌──────────────────────┬──────────────────────────────────┐
│ Name                 │ Value                            │
├──────────────────────┼──────────────────────────────────┤
│ a1                   │ 189082...                        │
│ web_session          │ 0400...                          │
│ webId                │ 2b8e...                          │
│ ...                  │ ...                              │
└──────────────────────┴──────────────────────────────────┘
→ Ctrl+A → Ctrl+C to copy all

7️⃣ Paste into the Actor:

• In the Actor's input form, find the Cookies field
• Ctrl+V (or Cmd+V on Mac) to paste
• The field will show a long string like a1=189082...; web_session=0400...; webId=2b8e...

💡 Tip: You only need to do this once. The Actor saves your cookie automatically and reuses it for future runs. If your cookie expires (weeks later), just repeat these steps.

📹 Visual Reference

┌─ Browser Window ──────────────────────────────────────┐
 │                                                       │
 │  [F12]  [Elements] [Console] [Application] [»]        │
 │                        ┌────────────────────────────┐ │
 │  ◉ Storage             │  Filter                    │ │
 │    ├─ Local Stora◉e    ├────────────────────────────┤ │
 │    └─ Cookies          │  Name        │ Value       │ │
 │       ├─ xiaohongshu   │──────────────┼─────────────┤ │
 │       └─ baidu.com     │  a1          │ 189082...   │ │
 │                        │  web_session │ 0400...     │ │
 │                        │  webId       │ 2b8e...     │ │
 │                        │     ...                    │ │
 │                        │  ← Ctrl+A → Ctrl+C →      │ │
 │                        └───────┬────────────────────┘ │
 │                                │                      │
 │                    Paste here ▼ (Cookies field)        │
 └────────────────────────────────────────────────────────┘

---

Step 2: Enter Keywords 🔤

Comma-separated in keywords field:

You type	Result
露营	Single keyword
露营, 美妆	Two keywords
露营, 美妆, 宠物	Three keywords

✅ 支持中文关键词，用英文逗号隔开

Step 3: Run ▶️

Set maxItems (per keyword), click Run. Results in ~10 seconds!

---

📤 Output Example

{
  "keyword": "露营",
  "note_id": "68bd2ad...",
  "title": "绝美露营地推荐",
  "likes": 1269
}

---

⚙️ Config Reference

Field	Req	Default	Description
cookies	✅	—	Login cookies. How to get?
keywords	✅	—	Comma-separated. E.g. 露营, 美妆
maxItems		30	Notes per keyword
enableDetail		true	Full note details
maxDetailNotes		3	Notes with full details
maxComments		10	Comments per note
sortBy		general	Sort order
proxyConfiguration		Residential	Proxy for stability

---

❓ FAQ — 常见问题

Q: Why do I need a cookie? A: The cookie proves you're a real logged-in user on Xiaohongshu. Without it, the search API refuses access. We never store or share your cookie beyond this Actor.

Q: 为什么需要 Cookie？ A: Cookie 用于验证你的小红书登录身份。没有 Cookie，搜索接口会拒绝访问。我们不会将你的 Cookie 存储用于其他用途。

Q: Do cookies expire? A: Yes, typically after 1-2 weeks or when you log out. Just repeat Step 1 to get a fresh one.

Q: Cookie 会过期吗？ A: 会的，通常 1-2 周后过期，或退出登录后立即失效。重新按上方步骤复制新的 Cookie 即可。

Q: I get 0 results? / 搜索不到结果？ A: Most likely your cookie expired. Get a fresh one from your browser.

Q: Error "code=-100" or "code=-101"? A: Cookie expired. Refresh from browser. / Cookie过期，重新获取。

Q: Can I search Chinese keywords? A: Yes! Use English commas between them. / 支持中文，用英文逗号隔开。

Q: How fast is it? A: 2-5 seconds per keyword. 3 keywords ≈ 10-15s total.

---

💡 Pro Tips

• More keywords = more results (total = maxItems × keywords)
• Keep cookie fresh — lasts 1-2 weeks
• Use Residential proxy to avoid blocks
• For research: try 推荐, 好用, 平替, 种草

---

🔧 Tech

Uses xhshow for API signature signing. Direct HTTP — no browser needed. MIT License.

Built with ❤️ for the Apify community.