Xiaohongshu Note Detail Scraper

Turn a public Xiaohongshu (RedNote / 小红书) note URL, share link, or 24-character note ID into one structured note-detail row. You get title, description, image and video CDN URLs, like/collect/comment/share counts, author profile, tags, and location when the public page exposes them. No Xiaohongshu login or cookies.

This Actor is built for brand analysts, China-market researchers, and AI agents that already have a note link and need a predictable public creative payload before they scrape comments or run search.

Best fit for this Actor

• Enrich a known list of Xiaohongshu note URLs with engagement counts and media URLs.
• Qualify a RedNote creative before pulling the comment thread.
• Feed MCP or CRM workflows with one row per public note.

Practical scenario

A social-listening analyst pastes https://www.xiaohongshu.com/explore/69afda73000000002800b3f2?xsec_token=YOUR_XSEC_TOKEN, sets maxNotes to 1, and starts the run. The dataset returns title, body, media CDN URLs, likes/collects/comments/shares, author name, and tags. A deleted note finishes SUCCEEDED with VALID_EMPTY and no note-scraped charge. Notes that clear the engagement bar can then be sent to the comments sibling.

Quick start input

{
  "noteUrls": [
    "https://www.xiaohongshu.com/explore/69afda73000000002800b3f2?xsec_token=YOUR_XSEC_TOKEN"
  ],
  "maxNotes": 1
}

noteUrls accepts explore, discovery/item, profile/note URLs, xhslink.com / xhslink.cn share links, and bare 24-character note IDs. Prefer Share → Copy link URLs that include xsec_token.

Input reference

Field	Type	What it controls
noteUrls	array (required)	Public note URLs, share links, or note IDs. Max 50 values.
maxNotes	integer	Hard cap on saved rows. Default 20. Prefill 1 keeps quality tests fast.

What data you receive

One dataset item is one public note.

{
  "noteId": "69afda73000000002800b3f2",
  "title": "关于打击AI托管运营账号的治理公告",
  "likedCount": 6088,
  "collectedCount": 1269,
  "commentCount": 1700,
  "shareCount": 9919,
  "authorName": "薯管家",
  "noteType": "normal",
  "provider": "zen-studio",
  "scrapedAt": "2026-09-10T13:16:26.000Z"
}

Field	Meaning
title + description	Public title and body
likedCount / collectedCount / commentCount / shareCount	Public engagement counters
imageUrls / coverUrl / videoUrl	Media CDN URLs when exposed
authorName / authorProfileUrl	Public author fields
noteUrl / provider / scrapedAt	Provenance

OUTPUT and RUN_SUMMARY in the default key-value store hold outcome, itemsPushed, and chargedEventCounts.

Use through the API

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~xiaohongshu-note-detail-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"noteUrls":["https://www.xiaohongshu.com/explore/69afda73000000002800b3f2?xsec_token=YOUR_XSEC_TOKEN"],"maxNotes":1}'

Download rows as JSON, CSV, Excel, or HTML from the Dataset tab.

Use with AI agents through Apify MCP

Look up the public Xiaohongshu note at https://www.xiaohongshu.com/explore/69afda73000000002800b3f2?xsec_token=YOUR_XSEC_TOKEN. Return title, description, likedCount, collectedCount, commentCount, shareCount, imageUrls, videoUrl, authorName, and tags. Keep the scope to public note detail; route comment threads and keyword search to the sibling Actors.

Connect via https://mcp.apify.com. Read OUTPUT.outcome and itemsPushed to interpret empty datasets. Cost signal: about $0.25 per saved note plus platform usage. Missing or deleted notes surface as VALID_EMPTY without a note-scraped charge.

Connect the workflow

• After you confirm the note, scrape comment threads with Xiaohongshu Comments Scraper.
• For a creator homepage, use Xiaohongshu User Profile Scraper.
• When you still need note URLs, discover notes with Xiaohongshu Search Scraper and then return here for detail enrichment.

Pricing

This Actor uses Pay per event plus Apify platform usage. The live Pricing tab is the current source of truth for billing details.

• apify-actor-start: $0.00005 per run
• note-scraped: $0.25 per saved public note-detail row

A one-note prefill is about $0.25 in result events plus compute/proxy usage. Missing or deleted notes have no note-scraped charge.

How it works

1. Normalize note URLs, share links, and note IDs.
2. Fetch the public note page through Scrapfly ASP when quota is available, then batch remaining notes into one nested public note-detail provider, then residential Camoufox if needed.
3. Parse title, description, media URLs, engagement counts, author, and tags.
4. Charge note-scraped for found rows, then write the dataset item.

Best results

• Prefer explore/discovery URLs that include xsec_token, or xhslink.com share links.
• Keep maxNotes at 1 for smoke tests; raise it for campaign batches.
• A typo or deleted note finishes SUCCEEDED with VALID_EMPTY and no note charge.
• Profile-only URLs belong on the user-profile Actor; comment threads belong on the comments Actor.

Builder's note

I found that Xiaohongshu's public note page still ships __INITIAL_STATE__ with title, description, media, and engagement when the anti-bot render path succeeds. Direct datacenter HTTP usually surfaces Xiaohongshu code 300031, and Scrapfly Discovery can hit quota or HTTP 429, so this Actor keeps the owned parser and uses Scrapfly first, then batches remaining URLs into one nested zen-studio/rednote-note-detail-scraper run to amortize the nested start charge, then residential Firefox. That split keeps the product a lean one-row note-detail SKU rather than a comments archive.

Legal and responsible use

Use this Actor on public Xiaohongshu note pages you are authorized to process, follow applicable law and Xiaohongshu's terms, and keep the output in your own compliance workflow. This Actor is independent of Xiaohongshu / RedNote. It does not collect private notes, DMs, login-walled data, or comment threads.

Issues and feature requests: use the Actor Issues tab on Apify.