Xiaohongshu (RedNote) Scraper — Public Notes & Profiles

Disclaimer: Unofficial tool — not affiliated with, sponsored by, or endorsed by Xiaohongshu / RedNote or its affiliates. Data is read from publicly accessible pages only. No login. You are responsible for complying with applicable law (including GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

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 publicly accessible image/video notes and creator profiles from Xiaohongshu (小红书 / XHS / Little Red Book) as structured JSON. Each note includes engagement counts, 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 Actor is limited to the public recommend explore feed, note detail, and profiles and does not accept login cookies.

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 a research corpus from public notes you have the right to process
• Chain explore → note_detail: every explore row already carries xsecToken

When not to use

• Private accounts, chats, inboxes, or gated content — public pages only; the Actor does not log in.
• Keyword search, comments, private content, or inbox data — login-gated APIs and authenticated cookies are out of scope.
• 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

• Four public modes — explore, note detail, user profile, and public user notes
• No login or cookies — recommend explore (~30 notes per reload), note HTML, and profiles only
• 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
• Residential proxy recommended — datacenter IPs hit Xiaohongshu's 安全限制 / 300011 wall

Input

Parameter	Description
mode	explore (default), note_detail, user_profile, or user_notes
startUrls	Note URLs (keep ?xsec_token=), xhslink shares, or note IDs
userUrls	Profile URLs or 24-character user IDs
channel	Public recommend SSR feed only
fullDetail	Hydrate each public explore card to full note HTML
includeNotes	Profile mode: also emit that creator's note cards
maxItems	Dataset cap (default 50)
maxPages	How many times to reload explore (feed rotates)
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="
    }
  ]
}

Output

One dataset row per public note or profile. Filter on type.

Field	Description
type	note or profile
noteId / userId	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
url	Shareable note or profile URL
redId / fansCount / bio / ipLocation	Profile 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
• Compare engagement on public notes from a campaign URL set
• 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?
No. The Actor accepts only public explore, note, and profile pages and rejects authenticated-cookie inputs.

Where does xsec_token come from?
Public explore output includes it on note URLs. You can also copy it from a publicly accessible browser address or share link.

Why are profile note IDs empty?
Anonymous HTML may omit noteId on a creator's grid while keeping title, likes, cover, and xsecToken. Run public explore for note cards with IDs.

Is this an official Xiaohongshu API?
No. It is a Xiaohongshu API alternative that reads publicly accessible web pages (window.__INITIAL_STATE__) without credentials or authenticated cookies.

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