Xiaohongshu (RedNote) Scraper — Notes, Profiles & Search

Unofficial tool for publicly accessible Xiaohongshu / RedNote (小红书) data. Xiaohongshu, RedNote, Little Red Book, and related trademarks belong to their respective owners. Not affiliated with, sponsored by, or endorsed by Xingyin Information Technology. Provided for informational use only; users must comply with applicable terms and laws.

Social discovery	Product launches
Xiaohongshu (RedNote) Scraper ◄── you are here	Product Hunt Scraper
TikTok Trending Hashtags Scraper	Launches, reviews, comments, leaderboards
Bluesky Scraper
YouTube Comments Scraper

Xiaohongshu scraper and RedNote API alternative — extract notes (image and video), creator profiles, comments, and keyword search from Xiaohongshu (小红书 / XHS / Little Red Book) as structured JSON. Each note includes engagement counts (likes, collects, comments, shares), image galleries, playable video URLs, hashtags, IP region, and an xsec_token you can pipe into the next run.

Scrape Xiaohongshu / RedNote with Python, Node.js, cURL, or MCP / AI assistants. Export JSON, CSV, or Excel from the dataset. The public explore feed, note detail, and profiles do not need a login. Xiaohongshu gates keyword search and comment threads behind a logged-in web_session cookie — paste yours only when you need those modes.

When to use

• China consumer research, brand listening, and 种草 / haul monitoring before Tmall or JD rankings move
• Influencer / KOL discovery from the recommend feed or a creator profile (Red ID, fans, bio, region)
• Pull a note's body, images, video stream, subtitles, and numeric engagement without the app
• Build an AI training corpus of first-person product reviews from RedNote
• Chain explore → note_detail: every explore row already carries xsecToken

When not to use

• You need keyword search or comments without a cookie — Xiaohongshu login-gates those APIs. This Actor fails the run with a clear message and does not bill empty gated lookups.
• You paste a bare note ID or an app share link without xsec_token — the site often serves a 404. Copy the address-bar URL, or run explore first and reuse the URLs it emits.
• You want 蒲公英 (PGY) rate cards or mall checkout SKUs — not in this version. Use note + profile fields for creator sizing instead.

Key features

• Seven modes — explore, note detail, user profile, user notes, search notes, search users, comments
• No login for public surfaces — recommend explore (~30 notes per reload), note HTML, and profiles
• Numeric twins for Chinese counts — "1.5万" → 15000, "1千+" → 1000
• Video notes — h264 master URL, duration, quality, backup CDNs, subtitle URLs when Xiaohongshu publishes them
• Share links — xhslink.com redirects resolved to a note or profile
• Cookie is optional and secret — only search / comments / extra user-note pages need web_session
• Residential proxy recommended — datacenter IPs hit Xiaohongshu's 安全限制 / 300011 wall

Input

Parameter	Description
mode	explore (default), note_detail, user_profile, user_notes, search_notes, search_users, comments
startUrls	Note URLs (keep ?xsec_token=), xhslink shares, or note IDs
userUrls	Profile URLs or 24-character user IDs
keyword / keywords	Search terms (Chinese or English)
channel	Explore channel; public SSR is recommend. Other channels need a cookie
fullDetail	Hydrate each explore/search card to full note HTML
includeNotes	Profile mode: also emit that creator's note cards
includeComments	Note detail: also scrape comments (cookie)
maxItems	Dataset cap (default 50)
maxPages	How many times to reload explore (feed rotates)
cookie	Logged-in web_session cookie string (secret)
proxyConfiguration	Apify RESIDENTIAL recommended

Public recommend feed (first run, no cookie):

{
  "mode": "explore",
  "channel": "recommend",
  "maxItems": 30,
  "maxPages": 1,
  "fullDetail": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Full note from a token-bearing URL:

{
  "mode": "note_detail",
  "startUrls": [
    {
      "url": "https://www.xiaohongshu.com/explore/69e20e1f000000002200c993?xsec_source=pc_search&xsec_token=ABS0VjfVaGyra8KDJ-TwJ-EwR_lhbirY-atpyynmL16UA="
    }
  ]
}

Keyword search (cookie required):

{
  "mode": "search_notes",
  "keyword": "护肤",
  "searchSort": "popular",
  "noteType": "all",
  "maxItems": 40,
  "cookie": "web_session=…; a1=…; webId=…"
}

Output

One dataset row per note, profile, search user, or comment. Filter on type.

Field	Description
type	note, profile, user, or comment
noteId / userId / commentId	Xiaohongshu identifiers
title / desc	Note title and body
likedCountNum / collectedCountNum / commentCountNum / shareCountNum	Parsed engagement
imageUrls / coverUrl / videoUrl	HTTPS media
hashtags	Topic names from tagList
xsecToken	Token to reuse in note_detail / comments
url	Shareable note or profile URL
redId / fansCount / bio / ipLocation	Profile fields
content / parentCommentId / isReply	Comment fields
scrapedAt	UTC timestamp

Note row (abridged):

{
  "type": "note",
  "source": "note_detail",
  "noteId": "69e20e1f000000002200c993",
  "noteType": "normal",
  "title": "被陌生人问用的什么香水",
  "likedCount": "5301",
  "likedCountNum": 5301,
  "collectedCountNum": 2199,
  "commentCountNum": 269,
  "shareCountNum": 277,
  "hashtags": ["被陌生人问", "香水", "咖啡店", "日本生活记录"],
  "userId": "6302a7dc000000001200ec31",
  "userNickname": "yaya",
  "url": "https://www.xiaohongshu.com/explore/69e20e1f000000002200c993?xsec_token=…",
  "xsecToken": "ABS0VjfVaGyra8KDJ-TwJ-EwR_lhbirY-atpyynmL16UA="
}

Use cases

• Track which beauty / fashion / food notes are surfacing on the public recommend feed
• Export a creator's profile (Red ID, region, fans, bio) plus their latest cards
• Collect image URLs and video streams for a specific viral note
• Search 口红 / camping gear once you have a session cookie, then hydrate full detail
• Sentiment on a campaign note via comments (cookie)
• Feed RedNote JSON into an MCP / agent workflow instead of screenshotting the app

Integration examples

Replace YOUR_TOKEN with your Apify API token. Actor name: crawloop/xiaohongshu-scraper.

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/xiaohongshu-scraper').call({
  mode: 'explore',
  maxItems: 20,
  proxyConfiguration: { useApifyProxy: true, apifyProxyGroups: ['RESIDENTIAL'] },
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("crawloop/xiaohongshu-scraper").call(
    run_input={
        "mode": "note_detail",
        "startUrls": [
            {
                "url": "https://www.xiaohongshu.com/explore/69e20e1f000000002200c993?xsec_token=ABS0VjfVaGyra8KDJ-TwJ-EwR_lhbirY-atpyynmL16UA="
            }
        ],
    }
)
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items[0]["title"], items[0]["likedCountNum"])

cURL

curl "https://api.apify.com/v2/acts/crawloop~xiaohongshu-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"explore","maxItems":10}'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call this Actor by its Store ID / name.

Example prompts:

• "Run Xiaohongshu (RedNote) Scraper in explore mode for 20 notes and return title, likes, hashtags, and author as JSON"
• "Scrape this Xiaohongshu note URL with crawloop/xiaohongshu-scraper and summarize engagement, images, and video URL"
• "Chain Xiaohongshu (RedNote) Scraper explore into note_detail using each row's url, then compare with TikTok Trending Hashtags Scraper for the same campaign week"

Suite next step

After you have note URLs and xsecToken values, run note_detail (or user_profile on userUrl) in a second run. For Western trend context on the same brief, use TikTok Trending Hashtags Scraper.

FAQ

Is this a Little Red Book / XHS / 小红书 scraper?
Yes. Xiaohongshu, RedNote, Little Red Book, XHS, and 小红书 are the same platform. This Actor reads the public web app.

Do I need a Xiaohongshu account?
Not for explore, note pages that already have xsec_token, or public profiles. Search and comments yes — paste your own web_session.

Where does xsec_token come from?
Explore and search output include it on every note URL. You can also copy it from the browser address bar after opening a note, or from Share → Copy link.

Why are profile note IDs empty?
Anonymous HTML often strips noteId on a creator's grid and keeps title, likes, cover, and xsecToken. Add a cookie or run explore (those cards include IDs).

Is this an official Xiaohongshu API?
No. It is a Xiaohongshu API alternative: it reads the same public web pages a browser does (window.__INITIAL_STATE__) plus optional signed endpoints when you provide a cookie. No Xiaohongshu developer key.

Can I scrape Xiaohongshu with Python or Node.js?
Yes. Use the Apify client examples above, or call the Actor from MCP / an AI assistant and export the dataset as JSON.

Related Actors

• TikTok Trending Hashtags Scraper
• Bluesky Scraper
• YouTube Comments Scraper