Turn any RedNote / Xiaohongshu (小红书) note URL or ID into a clean, structured data record — title, body, media, hashtags, author and full engagement metrics — in one call.

⚡ What you get

Capability	Detail
Full note detail	Title, body text, note type (normal / video), media URLs
Engagement metrics	Likes, collects, comments and shares counts
Author data	Handle, user ID and profile URL
Media extraction	All image URLs and the video URL (for video notes)
Discovery & hashtags	Hashtag list, IP location and posted-at timestamp
Flexible input	Paste full note URLs, bare IDs, or sample the live feed

🎯 Use cases

• China social listening — pull full post detail for any RedNote note your monitoring surfaces.
• KOL / influencer research — capture author handle, profile URL and per-post engagement for outreach lists.
• Consumer & trend insight — extract body text, hashtags and media to analyse what resonates with Chinese consumers.
• Competitor content audits — archive a competitor's notes with metrics to benchmark performance over time.
• Dataset building for ML/NLP — assemble structured Chinese-language post datasets with text, media and engagement signals.

🚀 How to use

Apify Console — open the actor, paste one or more note URLs into Note URLs or IDs (or set Sample latest feed notes to a number), then click Start. Results land in the run's dataset.

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")

run_input = {
    "noteUrls": [
        "https://www.xiaohongshu.com/explore/<NOTE_ID>?xsec_token=<TOKEN>"
    ],
    "proxyConfiguration": {"useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"]},
}

run = client.actor("nexgendata/rednote-note-detail").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

cURL

curl -X POST "https://api.apify.com/v2/acts/nexgendata~rednote-note-detail/runs?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
        "noteUrls": ["https://www.xiaohongshu.com/explore/<NOTE_ID>?xsec_token=<TOKEN>"],
        "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}
      }'

📊 Output fields

Field	Description
note_id	Unique RedNote note ID
title	Note title
body	Full note body text
type	Note type: normal or video
image_urls[]	Array of image URLs
video_url	Video URL (video notes only)
hashtags[]	Array of hashtags on the note
author_handle	Author display handle
author_id	Author user ID
author_url	Author profile URL
likes_count	Number of likes
collects_count	Number of collects / saves
comments_count	Number of comments
shares_count	Number of shares
posted_at	Original posted-at timestamp
ip_location	IP location shown on the note
url	Canonical note URL
data_source	Source of the record
as_of_timestamp	When the data was captured

⚖️ Legal & data

This actor collects public content only — notes that are publicly visible on RedNote / Xiaohongshu without login. No private, login-gated or personal data is accessed. You are responsible for using the output in compliance with RedNote's terms, applicable laws and any data-protection regulations (e.g. GDPR / PIPL) that apply to you.

❓ FAQ

Q: How do I supply note URLs or IDs? Put one or more values in the Note URLs or IDs input. You can paste full note URLs, bare note IDs, or mix both. Leave it empty and use Sample latest feed notes to pull from the live feed instead.

Q: Why do I need an xsec_token? RedNote note-detail pages require a short-lived xsec_token. The reliable way to supply it is to paste the full note URL from your browser — it already carries the token (...?xsec_token=...). Bare IDs work only when the note is currently present in the live feed, where the token is harvested automatically; otherwise prefer the full URL.

Q: What does the feedSample input do? Set Sample latest feed notes (feedSample) to a number N > 0 and the actor scrapes full details for the latest N notes from the live RedNote explore feed — each fetched with its own fresh xsec_token. Use it when you have no specific URLs and just want recent notes.

Q: Which proxy should I use? RESIDENTIAL Apify Proxy is strongly recommended (and prefilled) for reliable access to RedNote.

🔗 Related Actors

Part of the NexGenData RedNote matrix:

• RedNote (Xiaohongshu) Scraper — trending, user posts, hashtag and keyword search.
• RedNote (Xiaohongshu) User Profile Scraper — full user profile and stats.
• Xiaohongshu Trends Tracker — track trending topics over time.

🏢 About NexGenData

NexGenData builds reliable, production-grade scrapers for hard-to-reach platforms. Explore the full catalogue at NexGenData on Apify.

---

小红书笔记详情采集器 · RedNote (Xiaohongshu) Note Detail Scraper

只需一次调用，即可把任意小红书（RedNote / Xiaohongshu）笔记的链接或 ID 转换为结构化数据：标题、正文、媒体、话题标签、作者以及完整的互动指标。

⚡ 功能

能力	说明
完整笔记详情	标题、正文、笔记类型（图文 / 视频）、媒体链接
互动指标	点赞、收藏、评论、分享数
作者数据	昵称、用户 ID 与主页链接
媒体提取	全部图片链接及视频链接（视频笔记）
话题与发现	话题标签列表、IP 属地、发布时间
灵活输入	粘贴完整笔记链接、纯 ID，或采样实时信息流

🎯 适用场景

• 中国社媒舆情监测 — 为监测到的任意小红书笔记拉取完整详情。
• KOL / 达人研究 — 获取作者昵称、主页链接及单篇互动数据，用于建立合作名单。
• 消费者与趋势洞察 — 提取正文、话题标签与媒体，分析中国消费者关注的内容。
• 竞品内容审计 — 归档竞争对手的笔记及其指标，长期对比表现。
• 机器学习 / NLP 数据集构建 — 汇总包含文本、媒体与互动信号的结构化中文笔记数据集。

🚀 使用方法

Apify 控制台 — 打开该 Actor，在 Note URLs or IDs 中粘贴一个或多个笔记链接（或将 Sample latest feed notes 设为一个数字），然后点击 Start。结果会保存到运行的数据集中。

Python（apify-client）

from apify_client import ApifyClient

client = ApifyClient("<你的_APIFY_TOKEN>")

run_input = {
    "noteUrls": [
        "https://www.xiaohongshu.com/explore/<NOTE_ID>?xsec_token=<TOKEN>"
    ],
    "proxyConfiguration": {"useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"]},
}

run = client.actor("nexgendata/rednote-note-detail").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

cURL

curl -X POST "https://api.apify.com/v2/acts/nexgendata~rednote-note-detail/runs?token=<你的_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
        "noteUrls": ["https://www.xiaohongshu.com/explore/<NOTE_ID>?xsec_token=<TOKEN>"],
        "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}
      }'

📊 输出字段

字段	说明
note_id	笔记唯一 ID
title	笔记标题
body	笔记正文全文
type	笔记类型：normal（图文）或 video（视频）
image_urls[]	图片链接数组
video_url	视频链接（仅视频笔记）
hashtags[]	笔记话题标签数组
author_handle	作者昵称
author_id	作者用户 ID
author_url	作者主页链接
likes_count	点赞数
collects_count	收藏数
comments_count	评论数
shares_count	分享数
posted_at	原始发布时间
ip_location	笔记显示的 IP 属地
url	笔记规范链接
data_source	数据来源
as_of_timestamp	数据采集时间

⚖️ 合规与数据

本 Actor 仅采集公开内容 —— 无需登录即可在小红书 / Xiaohongshu 上公开查看的笔记。不会访问任何私密、需登录或个人隐私数据。请您自行确保对输出数据的使用符合小红书的服务条款、适用法律以及对您适用的数据保护法规（如 GDPR / 个人信息保护法 PIPL）。

❓ 常见问题

问：如何提供笔记链接或 ID？ 在 Note URLs or IDs 输入框中填入一个或多个值。可以粘贴完整笔记链接、纯笔记 ID，或两者混合。留空并使用 Sample latest feed notes 即可改为从实时信息流拉取。

问：为什么需要 xsec_token？ 小红书笔记详情页需要一个时效较短的 xsec_token。最可靠的方式是直接粘贴浏览器中的完整笔记链接 —— 它已携带该 token（...?xsec_token=...）。纯 ID 仅在该笔记当前出现在实时信息流时有效（此时 token 会被自动采集）；否则请优先使用完整链接。

问：feedSample 输入有什么用？ 将 Sample latest feed notes（feedSample）设为大于 0 的数字 N，Actor 就会从小红书发现页实时信息流抓取最新 N 篇笔记的完整详情，每篇都带有自己全新的 xsec_token。当你没有具体链接、只想获取最新笔记时使用。

问：应使用哪种代理？ 强烈建议使用 RESIDENTIAL（住宅）Apify 代理（已默认预填），以稳定访问小红书。

🔗 相关 Actor

NexGenData 小红书矩阵的一部分：

• RedNote (Xiaohongshu) Scraper — 热门、用户笔记、话题与关键词搜索。
• RedNote (Xiaohongshu) User Profile Scraper — 完整用户主页与统计数据。
• Xiaohongshu Trends Tracker — 长期追踪热门话题。

🏢 关于 NexGenData

NexGenData 专注为难以采集的平台打造可靠、生产级的爬虫。在 Apify 上的 NexGenData 浏览完整产品目录。