RedNote & Xiaohongshu Keyword Search Scraper ($1.50/1k) 小红书

RedNote & Xiaohongshu Keyword Search Scraper (小红书搜索 / XHS Search API)

Purpose-built RedNote (xiaohongshu.com / rednote.com / 小红书) keyword search engine for brand mention monitoring, consumer topic & hashtag research, competitive product benchmarking, and viral .mp4 video discovery—starting at $1.50 per 1,000 posts with zero cookies, zero QR logins, and a clean 5-field interface.

🎯 Why Choose This Dedicated Keyword Search Scraper?

Unlike multi-purpose scrapers cluttered with dozens of mode toggles, this Actor gives analysts, e-commerce teams, and AI pipelines a streamlined, zero-friction RedNote search API:

• 300+ Unique Posts per Keyword: Paginates deep across up to 25 pages per query (~300–440 unique notes per keyword, up to 50 keywords and 10,000 posts per run).
• Server-Side Ranking Controls (sort): Switch between Most Popular (popularity_descending — highest likes & saves), Newest First (time_descending — chronological brand monitoring), or Relevance (general).
• Native Format Filtering (noteType): Isolate Video Posts Only (video_only) for short-form video creative research & Whisper/VLM pipelines, Image Carousels Only (image_only), or All Posts (all).
• Full Captions, Hashtags & Unwatermarked HD Media: Extracts untruncated post descriptions (desc), structured tags, exact engagement metrics (likedCount, collectedCount, commentCount, sharedCount, viralScore), ISO publish timestamps (publishedAt), author IP regions (ipLocation), high-resolution photo galleries (images), and direct .mp4 video URLs (videoUrl).
• 100% Cookie-Free on 256 MB RAM: Sub-second startup with zero +86 phone numbers, zero session cookies to maintain, and zero risk to personal or brand accounts.

---

🚀 High-Impact Use Cases

Workflow	Recommended Configuration	Key Fields Delivered
🏷️ Brand Mention & Launch Monitoring	keywords: ["Lululemon", "Rhode"], sort: "time_descending", noteType: "all"	Chronological publishedAt, untruncated desc, ipLocation, sentiment.hasPurchaseIntent, sentiment.hasPraise, and author links
📈 Topic, Ingredient & Hashtag Research	keywords: ["retinol serum", "早C晚A", "防晒测评"], sort: "popularity_descending"	Top-performing posts ranked by engagement, tags co-occurrence, collectedCount (bookmark-to-like ratio), and viralScore
🎬 Viral Video Ad & Creative Discovery	keywords: ["unboxing", "好物分享", "穿搭vlog"], sort: "popularity_descending", noteType: "video_only"	Direct .mp4 videoUrl, coverUrl, video duration, full spoken/caption hook in title + desc, and engagementRate
🛒 Cross-Border Product Demand Validation	Up to 50 product/niche keywords in a single batch run	Buyer inquiry signals (sentiment.intentKeywords like "求链接", "多少钱"), save velocity, and regional demand (ipLocation)

---

🧩 Complete UnitBytes RedNote (Xiaohongshu) 6-Actor Suite

Pick the exact specialized Actor for your pipeline—or combine them seamlessly:

1. 🔍 RedNote Keyword Search Scraper (rednote-xiaohongshu-search-scraper) (📍 You are here) — Pure 5-field keyword search (300+ notes/query, popularity & newest sort, video/image filter).
2. 🌟 RedNote All-in-One Scraper (xiaohongshu-scraper) — Flagship unified suite combining Keyword Search, Deep Multi-Page Comments, Creator Profiles, Category Trends & Live Streams.
3. 🔥 Xiaohongshu Post, Trend & Keyword Scraper (xiaohongshu-rednote-trend-scraper) — 13 official category explore feeds, bare direct post URLs (no xsec_token needed), keyword search & live rooms.
4. 💬 RedNote Comments & Replies Scraper (xiaohongshu-rednote-comments-scraper) — Deep multi-page comment threads (250–1,000+ comments/post), inline replies (楼中楼), and buyer sentiment.
5. 👤 RedNote Creator & KOL Profile Scraper (xiaohongshu-rednote-profile-scraper) — Influencer discovery by keyword or category, follower counts, verification badges, and ~30 portfolio posts per creator.
6. 🔴 RedNote Live Stream & Commerce Scraper (xiaohongshu-rednote-live-scraper) — Real-time active live broadcasts across 7 channels, 1080p .flv/.m3u8 streams, hasGoods shopping flags & live chat.

---

📥 Input Parameters (Clean 5-Field Search Schema)

Parameter	Type	Default	Description
keywords	string[]	["skincare"]	One or more English or Chinese search queries, brand names, or hashtag topics (up to 50 keywords per run; 300+ unique posts per keyword).
sort	string	"popularity_descending"	Server-side search ranking: "popularity_descending" (Most Popular), "general" (Relevance), or "time_descending" (Newest First).
noteType	string	"all"	Media format filter: "all" (Images + Videos), "video_only" (.mp4 Video Posts Only), or "image_only" (Image Carousels Only).
maxItems	integer	30	Maximum total search notes to extract (1 – 10,000).
enrichDetails	boolean	true	Fetches full untruncated post text (desc), hashtags (tags), publish timestamps, IP location, and HD photo galleries / .mp4 video URLs.
proxyConfiguration	object	HK Residential	Apify Residential Proxy configuration (apifyProxyCountry: "HK" recommended).

---

💻 Quickstart Code Examples

JSON Input Example

{
  "keywords": ["skincare", "早C晚A", "防晒测评"],
  "sort": "popularity_descending",
  "noteType": "all",
  "maxItems": 60,
  "enrichDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "HK"
  }
}

Python SDK (apify-client)

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_API_TOKEN>")

run = client.actor("unitbytes/rednote-xiaohongshu-search-scraper").call(
    run_input={
        "keywords": ["Lululemon", "瑜伽裤测评"],
        "sort": "time_descending",
        "noteType": "video_only",
        "maxItems": 50,
        "enrichDetails": True,
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["id"], item["likedCount"], item["title"], item.get("videoUrl"))

Node.js / TypeScript SDK (apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_API_TOKEN>' });

const run = await client.actor('unitbytes/rednote-xiaohongshu-search-scraper').call({
    keywords: ['matcha latte', '京都抹茶'],
    sort: 'popularity_descending',
    noteType: 'all',
    maxItems: 40,
    enrichDetails: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} RedNote search posts:`, items[0]);

---

📤 Output Sample (itemType: "note")

{
  "itemType": "note",
  "id": "67c9d41e000000000b0192fa",
  "title": "油痘肌早C晚A实测28天｜不翻车精简护肤公式",
  "desc": "油敏肌亲测温和不拔干的早C晚A搭配思路，附早晚用量和防晒注意事项！#早C晚A #油痘肌护肤 #精华测评",
  "type": "video",
  "url": "https://www.xiaohongshu.com/explore/67c9d41e000000000b0192fa",
  "isDetailEnriched": true,
  "author": {
    "id": "5f3a81c20000000001006b42",
    "nickname": "成分党小周",
    "avatarUrl": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31a8c9.jpg",
    "profileUrl": "https://www.xiaohongshu.com/user/profile/5f3a81c20000000001006b42"
  },
  "likedCount": 14280,
  "collectedCount": 9640,
  "commentCount": 386,
  "sharedCount": 1920,
  "viralScore": 45610.0,
  "engagementRate": 83.66,
  "imageCount": 1,
  "hasVideo": true,
  "coverUrl": "https://sns-img-qc.xhscdn.com/1040g00831ne0rhi94s005negled08bnqrs1goe0",
  "images": [
    "https://sns-img-qc.xhscdn.com/1040g00831ne0rhi94s005negled08bnqrs1goe0"
  ],
  "videoUrl": "https://sns-video-qc.xhscdn.com/stream/110/259/01e7c9d41e.mp4",
  "publishedAt": "2026-10-18T11:24:09+00:00",
  "ipLocation": "上海",
  "tags": [
    "早C晚A",
    "油痘肌护肤",
    "精华测评"
  ],
  "sentiment": {
    "hasPurchaseIntent": true,
    "hasInquiry": true,
    "hasPraise": true,
    "emojis": [],
    "intentKeywords": [
      "求链接",
      "敏感肌能用吗"
    ]
  },
  "scrapedAt": "2026-10-20T08:15:12.410Z"
}

---

🤖 Connect to Claude, Cursor & AI Agents via Official Apify MCP

Expose live RedNote / Xiaohongshu keyword search directly to Claude Desktop, Cursor, Windsurf, VS Code, or custom AI agents over Streamable HTTP via Apify's Official MCP Server—with zero local browser dependencies:

https://mcp.apify.com/?tools=unitbytes/rednote-xiaohongshu-search-scraper

Example mcp.json configuration (Cursor / Claude Desktop / VS Code):

{
  "mcpServers": {
    "rednote-keyword-search": {
      "url": "https://mcp.apify.com/?tools=unitbytes/rednote-xiaohongshu-search-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}

---

💰 Transparent Pay-Per-Event (PPE) Pricing

Pay strictly for delivered search results with zero monthly subscription commitment:

Event	Price	Details
Actor Start (apify-actor-start)	$0.00001	One-time micro-cent run initialization.
Search Note Extracted (note)	$0.0022 → $0.0015 / note	$2.20/1k on Free tier, scaling automatically down to $1.50/1k on Gold, Platinum & Diamond plans.

---

💬 Support & Compliance

• Support & Custom Requests: Open an issue anytime on the Apify Actor Issues Tab.
• Public Data & Privacy: Extracts strictly publicly searchable RedNote posts without logging in or bypassing private account restrictions. Ensure downstream use complies with GDPR, CCPA, PIPL, and applicable laws—see Apify's guide on is web scraping legal?.
• Disclaimer: Independent tool not affiliated with, endorsed by, or sponsored by Xiaohongshu (RED / 小红书 / Xingin Information Technology Co., Ltd.).