XiaoHongShu (RedNote) Scraper — Notes, Search, Comments 小红书

Scrape XiaoHongShu (小红书 / RedNote) notes by keyword search: titles, full text, authors, engagement stats (likes / collects / comments / shares), images, video URLs, publish time and top comments — delivered as clean JSON via the Apify API.

XiaoHongShu has no public API. This actor drives a real headless browser (Playwright) against the xiaohongshu.com web app and extracts structured data from rendered pages, so you get exactly what a logged-in user sees.

Built for CN/SEA e-commerce operators, US agencies, brand monitoring and trend research pipelines.

What it does

1. Opens xiaohongshu.com search for each of your keywords.
2. Scrolls the result feed and collects up to maxNotesPerKeyword note cards.
3. Opens every note page and extracts the full note: title, description, hashtags, author, likes, collects, comment count, share count, publish time, all images, video URL.
4. Optionally scrolls the comment section and collects up to maxCommentsPerNote top-level comments per note (user, text, likes).
5. Pushes one dataset item per note — ready for export as JSON / CSV / Excel or API consumption.

⚠️ Keyless vs. cookies — read this before running

XiaoHongShu aggressively gates its web app behind login. Here is exactly what works, verified live:

Feature	Without cookies	With login cookies
Explore (发现) feed notes (exploreFeed)	✅ Works	✅ Works
Keyword search results	❌ Blocked — the search page shows a login wall and renders zero note cards	✅ Works
Note detail pages (title, author, stats, images)	✅ Works	✅ Works
Comments on note pages	✅ Works (login popup auto-dismissed)	✅ Works

Bottom line: without cookies, use the Explore feed (the default when no keywords are given). For keyword search, set the cookies input.

How to get your cookies

1. Log in to xiaohongshu.com in Chrome/Edge (phone SMS or QR scan).
2. Open DevTools (F12) → Network tab → refresh the page.
3. Click any request to xiaohongshu.com → copy the full Cookie: request header value.
4. Paste it into the cookies input. It looks like a1=abc123; webId=def456; web_session=....

Cookies typically last days to weeks. If a run with cookies returns 0 notes, grab fresh ones.

Input

Field	Type	Default	Description
keywords	string[]	["护肤 推荐"]	Search keywords (Chinese or English). One search run per keyword. Required.
maxNotesPerKeyword	integer	20	Max notes scraped per keyword (1–200).
maxCommentsPerNote	integer	0	Max top-level comments per note. 0 skips comment extraction entirely (much faster).
cookies	string	—	Browser cookies for xiaohongshu.com (name=value; name=value). Strongly recommended — see above.
proxyConfiguration	object	—	Optional Apify proxy. Residential proxies help if you hit rate limits.

Example input

{
  "keywords": ["护肤 推荐", "夏日穿搭"],
  "maxNotesPerKeyword": 20,
  "maxCommentsPerNote": 5,
  "cookies": "a1=yourCookieValue; webId=yourCookieValue; web_session=yourCookieValue"
}

Output

One dataset item per note:

Field	Type	Description
keyword	string	Keyword that found this note
noteId	string	XiaoHongShu note ID
url	string	Canonical note URL
type	string	note (image/text) or video
title	string	Note title
desc	string	Body text incl. hashtags
authorName	string	Author nickname
authorId	string	Author user ID
authorUrl	string	Author profile URL
likes	string	Like count as displayed (e.g. 2.4万)
collects	string	Collect/favorite count
commentsCount	string	Total comment count
shareCount	string	Share count
publishTime	string	ISO publish timestamp
images	string[]	Image URLs
videoUrl	string	Video URL (video notes only, else null)
comments	object[]	{userName, text, likes} — empty when comment extraction is off
scrapedAt	string	ISO timestamp of scraping

Example item

{
  "keyword": "护肤",
  "noteId": "6a64f1c60000000010026e57",
  "url": "https://www.xiaohongshu.com/explore/6a64f1c60000000010026e57",
  "type": "note",
  "title": "讨厌夏天",
  "desc": "没有鲨人！但是是真的心好累……",
  "authorName": "+こおり+",
  "authorId": "699af24b000000001c037d61",
  "authorUrl": "https://www.xiaohongshu.com/user/profile/699af24b000000001c037d61",
  "likes": "2.4万",
  "collects": "1497",
  "commentsCount": "2153",
  "shareCount": "6106",
  "publishTime": "2026-07-25T16:06:30.000Z",
  "images": ["http://sns-webpic-qc.xhscdn.com/..."],
  "videoUrl": null,
  "comments": [
    { "userName": "+こおり+", "text": "你们点赞的是啥意思呀！", "likes": "1千+" }
  ],
  "scrapedAt": "2026-08-19T18:00:00.000Z"
}

Pricing (pay per event)

• $3.00 per 1,000 notes scraped
• $0.005 per comment extracted
• No start fee — you only pay for successfully scraped data

Set maxCommentsPerNote: 0 if you don't need comments — note-only runs are fast and cheap.

Tips & limits

• Rate limits: XiaoHongShu throttles aggressively. Anonymous (no-cookie) access from one IP is cut off entirely after a burst of requests — with cookies, keep volumes modest per account, or attach a residential proxy (Chinese IPs work best; datacenter IPs are often pre-blocked).
• Login wall popups on note pages are auto-dismissed by the actor.
• Counts like likes are returned as displayed on the site (2.4万 = 24,000) — convert in post-processing if you need raw numbers.
• Deleted or private notes are skipped with a warning.

Legal

This actor extracts publicly visible data from xiaohongshu.com. You are responsible for complying with XiaoHongShu's Terms of Service and applicable law. Use your own account cookies at your own risk.

Use XiaoHongShu (RedNote) Scraper with AI agents (MCP)

Give Claude, ChatGPT, Cursor, VS Code or any MCP client this Actor as a tool through the hosted Apify MCP server. The agent sees the input fields with descriptions and example values, runs the Actor, and reads the results.

MCP server URL (this Actor only):

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

Claude Code:

$claude mcp add --transport http apify "https://mcp.apify.com/?tools=technicaldost/xiaohongshu-rednote-scraper" --header "Authorization: Bearer YOUR_APIFY_TOKEN"

Cursor, VS Code, Claude Desktop and other clients (mcp.json or the client's MCP settings):

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=technicaldost/xiaohongshu-rednote-scraper",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

Clients that support sign-in (such as Claude.ai connectors) can use the URL without a token and log in to Apify instead. Get your token in Apify Console → Settings → API & Integrations, or generate a ready config for your client at mcp.apify.com. In the agent the tool is named technicaldost--xiaohongshu-rednote-scraper; ask it, for example, to "run XiaoHongShu (RedNote) Scraper with {"keywords": ["护肤 推荐"]}".

AI agents without an Apify account can also run and pay for this Actor per request with x402 agentic payments.

Run XiaoHongShu (RedNote) Scraper via API

Run the Actor and get its results in one call (replace YOUR_APIFY_TOKEN):

curl -X POST "https://api.apify.com/v2/acts/technicaldost~xiaohongshu-rednote-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["护肤 推荐"]}'

Python (pip install apify-client):

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("technicaldost/xiaohongshu-rednote-scraper").call(run_input={"keywords": ["护肤 推荐"]})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript / TypeScript (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('technicaldost/xiaohongshu-rednote-scraper').call({"keywords": ["护肤 推荐"]});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Long runs: start them with POST /v2/acts/technicaldost~xiaohongshu-rednote-scraper/runs and fetch the dataset when the run finishes, or receive a webhook.

Integrations

XiaoHongShu (RedNote) Scraper works with Make, Zapier, n8n, LangChain, Google Sheets, Slack, GitHub and webhooks. Schedule runs in Apify Console and send new results straight to your apps, spreadsheets or AI pipelines.

FAQ

Can I use XiaoHongShu (RedNote) Scraper with AI agents like Claude or ChatGPT?

Yes. Connect the Apify MCP server with ?tools=technicaldost/xiaohongshu-rednote-scraper (see above) and the agent can run the Actor and read its results on its own.

Can I call XiaoHongShu (RedNote) Scraper from my own code?

Yes. Use the REST API, or the official Python and JavaScript clients shown above. Results are available as JSON, CSV, Excel, XML or HTML.

How do I run it on a schedule?

Save your input as a task in Apify Console and add a schedule (for example, daily). Use webhooks or integrations to send each run's results onward.

Is it legal to use this Actor?

It works with publicly available data. Make sure your use complies with the source website's terms and with data protection laws such as GDPR, especially for personal data.

Something doesn't work or I need a feature. What should I do?

Open an issue in the Issues tab on this Actor's page with an example input, and we'll look into it.