# RedNote & Xiaohongshu Keyword Search Scraper ($1.50/1k) 小红书 (`unitbytes/rednote-xiaohongshu-search-scraper`) Actor ⚡ Fast & Cheap ($1.50/1k): Pure RedNote & Xiaohongshu (小红书搜索 / XHS) Keyword Search Scraper & API — 300+ notes/keyword, popularity & newest sort, video/image filter, HD photos & MP4, 0 cookies. - **URL**: https://apify.com/unitbytes/rednote-xiaohongshu-search-scraper.md - **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community) - **Categories:** Social media, E-commerce, Automation - **Features:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 search note extracteds 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

RedNote & Xiaohongshu Keyword Search Scraper API by UnitBytes

Try it for Free on Apify
⚡ 1-Click Free Trial: Search live RedNote & Xiaohongshu keywords using Apify's $5 free monthly credit • Zero login or cookies required

## 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`)**](https://apify.com/unitbytes/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`)**](https://apify.com/unitbytes/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`)**](https://apify.com/unitbytes/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`)**](https://apify.com/unitbytes/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`)**](https://apify.com/unitbytes/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`)**](https://apify.com/unitbytes/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 ```json { "keywords": ["skincare", "早C晚A", "防晒测评"], "sort": "popularity_descending", "noteType": "all", "maxItems": 60, "enrichDetails": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "HK" } } ``` #### Python SDK (`apify-client`) ```python from apify_client import ApifyClient client = ApifyClient("") 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`) ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ 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"`) ```json { "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: ```text https://mcp.apify.com/?tools=unitbytes/rednote-xiaohongshu-search-scraper ``` Example `mcp.json` configuration (`Cursor` / `Claude Desktop` / `VS Code`): ```json { "mcpServers": { "rednote-keyword-search": { "url": "https://mcp.apify.com/?tools=unitbytes/rednote-xiaohongshu-search-scraper", "headers": { "Authorization": "Bearer " } } } } ``` *** ### 💰 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](https://apify.com/unitbytes/rednote-xiaohongshu-search-scraper/issues). - **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?](https://blog.apify.com/is-web-scraping-legal/). - **Disclaimer:** Independent tool not affiliated with, endorsed by, or sponsored by Xiaohongshu (RED / 小红书 / Xingin Information Technology Co., Ltd.). # Actor input Schema ## `keywords` (type: `array`): Enter RedNote / Xiaohongshu search queries (e.g. 'skincare', 'Lululemon', '京都旅游攻略', '咖啡推荐'). ## `sort` (type: `string`): Sort keyword search results by Most Popular (likes & engagement), Relevance, or Newest First. ## `noteType` (type: `string`): Filter search results to return All Posts, Video Posts Only (.mp4), or Image / Carousel Posts Only. ## `maxItems` (type: `integer`): Maximum total number of search notes to extract across all keywords. ## `enrichDetails` (type: `boolean`): When enabled, enriches each search note with untruncated body text, hashtags, publish timestamp, IP region, and watermark-free HD images / .mp4 video URLs. ## `proxyConfiguration` (type: `object`): RedNote / Xiaohongshu performs best over Residential proxies (Hong Kong recommended). ## Actor input object example ```json { "keywords": [ "skincare" ], "sort": "popularity_descending", "noteType": "all", "maxItems": 20, "enrichDetails": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HK" } } ``` # Actor output Schema ## `notesDataset` (type: `string`): Scraped RedNote (Xiaohongshu) keyword search posts with full captions, engagement metrics, hashtags, author info, and HD images / MP4 video URLs. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "skincare" ], "sort": "popularity_descending", "noteType": "all", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HK" } }; // Run the Actor and wait for it to finish const run = await client.actor("unitbytes/rednote-xiaohongshu-search-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["skincare"], "sort": "popularity_descending", "noteType": "all", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "HK", }, } # Run the Actor and wait for it to finish run = client.actor("unitbytes/rednote-xiaohongshu-search-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 '{ "keywords": [ "skincare" ], "sort": "popularity_descending", "noteType": "all", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "HK" } }' | apify call unitbytes/rednote-xiaohongshu-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/rednote-xiaohongshu-search-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 ` 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/qOx5FAcgaoRZ9ivGV/builds/RRy43J4fAeEPqjElu/openapi.json