How to Fix Xiaohongshu xsec_token Error 300031: Scrape Bare /explore/ URLs, Keyword Search & Comments Without Login

If you have tried to build a Python pipeline, AI agent, or brand monitoring workflow for Xiaohongshu (小红书 / RedNote) in 2026, you have almost certainly hit the infamous error_code=300031 wall:

https://www.xiaohongshu.com/404?source=web&error_code=300031&error_msg=当前笔记暂时无法浏览
# "Note temporarily inaccessible" — even though the post is 100% live in the app!

Across developer forums and open-source repositories, conventional wisdom claims that bare https://www.xiaohongshu.com/explore/<24-hex-id> URLs are impossible to scrape without a live ?xsec_token=... parameter and a logged-in +86 personal cookie. Teams end up running fragile local headless browsers, scanning QR codes every morning, and watching their personal accounts get restricted after 50 requests.

In this engineering guide, we explain why standard scrapers trigger 300031, -100, and 300011—and provide copy-paste Python (apify-client), REST cURL, and Hosted MCP (mcp.apify.com) implementations that extract bare /explore/<id> posts, 300+ note keyword searches, and 250–1,000+ multi-page comments per post with zero xsec_token parameters and zero login cookies.

1. Why Standard Scrapers Fail with 300031, -100, and 300011#

When you inspect Xiaohongshu traffic in browser DevTools, three separate enforcement layers break traditional scraping scripts:

Why Saving xsec_token Links Breaks Downstream Pipelines

Even if your scraper harvests full URLs containing ?xsec_token=... during an authenticated search run, storing those tokens in Postgres, Snowflake, or Airtable for later hydration still fails:

1. xsec_token Is Ephemeral & Context-Bound: Tokens expire and are tied to the originating feed context (pc_search, pc_feed, pc_user). Re-fetching a stored URL 24 hours later to track engagement velocity (likedCount, collectedCount, commentCount) returns 300031.
2. External Links Never Have xsec_token: Note IDs shared in PR trackers, CRM spreadsheets, affiliate briefs, or xhslink.com shortlinks arrive as plain 24-character hex IDs or bare /explore/<id> URLs.
3. Personal Cookie Rotation Does Not Scale: Buying or maintaining +86 SIM cards for headless browser pools introduces compliance risk and constant manual QR re-authentication.

Instead of managing accounts or browser sessions locally, UnitBytes resolves bare Note IDs, keyword searches, and comment threads in the cloud on Apify—with $5.00 in free monthly Apify platform credit included on every free account (~2,200+ notes/month at $0 out-of-pocket cost).

2. Fix 300031: Hydrate Bare /explore/<id> URLs Without xsec_token#

Using the Xiaohongshu Trend & Post Scraper (Run on Apify Store), you can pass any of the following directly inside startUrls with mode: "notes":

• Bare web URLs: https://www.xiaohongshu.com/explore/660000000000000000000001
• Discovery links: https://www.rednote.com/discovery/item/660000000000000000000001
• Mobile app share shortlinks: http://xhslink.com/a/xxxxxx

Each hydrated post returns full caption text (desc), likedCount, collectedCount, commentCount, shareCount, high-resolution carousel images, watermark-free videoUrl (for video notes), tags, publish timestamp, and author metadata starting at $1.50 / 1,000 notes ($0.0015 Gold+; $0.0022 Free).

Python (apify-client) — Bare /explore/<id> Hydration

pip install apify-client

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

# Pass bare /explore/<24-hex> URLs or xhslink.com shortlinks — NO xsec_token needed
run_input = {
    "mode": "notes",
    "startUrls": [
        {"url": "https://www.xiaohongshu.com/explore/660000000000000000000001"},
        {"url": "https://www.xiaohongshu.com/explore/660000000000000000000002"},
    ],
    "maxItems": 2,
    "enrichDetails": True,
}

run = client.actor("unitbytes/xiaohongshu-rednote-trend-scraper").call(run_input=run_input)

for note in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(
        note["noteId"],
        note.get("title"),
        f"likes={note.get('likedCount')} saves={note.get('collectedCount')} comments={note.get('commentCount')}",
    )

Synchronous REST cURL — Bare URL to JSON in One Request

curl -s -X POST \
  "https://api.apify.com/v2/acts/unitbytes~xiaohongshu-rednote-trend-scraper/run-sync-get-dataset-items?format=json&clean=true" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "notes",
    "startUrls": [
      {"url": "https://www.xiaohongshu.com/explore/660000000000000000000001"}
    ],
    "maxItems": 1,
    "enrichDetails": true
  }'

3. Run 300+ Note Keyword Searches Without Login (-100 Bypass)#

If your goal is pure keyword discovery, share-of-voice tracking, or D2C competitor monitoring, the dedicated RedNote Keyword Search Scraper (Run on Apify Store) exposes a streamlined 5-field JSON schema with no mode selector required:

• keywords: Array of Chinese or English search queries (e.g. ["skincare", "早C晚A", "Lululemon"])
• sort: "popularity_descending" (most liked), "general" (relevance), or "time_descending" (newest)
• noteType: "all", "video_only", or "image_only"
• maxItems: Up to 300+ unique notes per keyword
• enrichDetails: Hydrates full post descriptions, tags, high-res image carousels, and MP4 video streams (true by default)

Python (apify-client) — 5-Field Keyword Search API

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

search_input = {
    "keywords": ["skincare", "早C晚A"],
    "sort": "popularity_descending",
    "noteType": "all",
    "maxItems": 120,
    "enrichDetails": True,
}

run = client.actor("unitbytes/rednote-xiaohongshu-search-scraper").call(run_input=search_input)
notes = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(f"Retrieved {len(notes)} unique Xiaohongshu notes")

Synchronous REST cURL — Keyword Search API

curl -s -X POST \
  "https://api.apify.com/v2/acts/unitbytes~rednote-xiaohongshu-search-scraper/run-sync-get-dataset-items?format=json&clean=true" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["敏感肌防晒"],
    "sort": "popularity_descending",
    "noteType": "video_only",
    "maxItems": 50,
    "enrichDetails": true
  }'

4. Scrape 250–1,000+ Xiaohongshu Comments & Inline Replies in Python#

Standard web scrapers hit a login wall after the first 10 preview comments—or fail outright with 300031 when given a bare post URL.

The RedNote Comments & Replies Scraper (Run on Apify Store) paginates 250 to 1,000+ engagement-ranked root comments per post directly from bare /explore/<24-hex> URLs, xhslink.com links, or search keywords, starting at $1.99 / 1,000 comments ($0.00199 Gold+; $0.00249 Free).

Python (apify-client) — Multi-Page Comments from Bare URL

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

comments_input = {
    "mode": "comments",
    "startUrls": [
        {"url": "https://www.xiaohongshu.com/explore/660000000000000000000001"}
    ],
    "maxCommentsPerNote": 300,
    "includeSubComments": True,
    "maxSubCommentsPerComment": 3,
}

run = client.actor("unitbytes/xiaohongshu-rednote-comments-scraper").call(run_input=comments_input)
comments = list(client.dataset(run["defaultDatasetId"]).iterate_items())

buyer_questions = [
    c for c in comments if (c.get("sentiment") or {}).get("isBuyerIntent")
]
print(f"Scraped {len(comments)} comments ({len(buyer_questions)} buyer-intent questions)")

Synchronous REST cURL — Multi-Page Comments

curl -s -X POST \
  "https://api.apify.com/v2/acts/unitbytes~xiaohongshu-rednote-comments-scraper/run-sync-get-dataset-items?format=json&clean=true" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "comments",
    "startUrls": [
      {"url": "https://www.xiaohongshu.com/explore/660000000000000000000001"}
    ],
    "maxCommentsPerNote": 100,
    "includeSubComments": true,
    "maxSubCommentsPerComment": 3
  }'

5. Connect Claude Code, Cursor & Windsurf via Hosted MCP (mcp.apify.com)#

Building an AI research agent in Claude Code, Cursor, Windsurf, or VS Code? Instead of installing a 1.5 GB local browser MCP wrapper that breaks on 300031, point your MCP client directly at Apify's official Streamable HTTP MCP gateway pre-loaded with all 6 UnitBytes RedNote tools:

Cursor (~/.cursor/mcp.json) / Windsurf Config

{
  "mcpServers": {
    "rednote-xiaohongshu": {
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,unitbytes/rednote-xiaohongshu-search-scraper,unitbytes/xiaohongshu-rednote-trend-scraper,unitbytes/xiaohongshu-rednote-comments-scraper,unitbytes/xiaohongshu-rednote-profile-scraper,unitbytes/xiaohongshu-rednote-live-scraper,unitbytes/xiaohongshu-scraper",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

Claude Code CLI One-Liner

claude mcp add --transport http rednote-xiaohongshu \
  "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,unitbytes/rednote-xiaohongshu-search-scraper,unitbytes/xiaohongshu-rednote-trend-scraper,unitbytes/xiaohongshu-rednote-comments-scraper,unitbytes/xiaohongshu-rednote-profile-scraper,unitbytes/xiaohongshu-rednote-live-scraper,unitbytes/xiaohongshu-scraper" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

6. Choosing the Right Engine Across the 6-Actor RedNote Suite#

Every engine below runs 100% cookieless in the cloud, includes ready-to-import n8n AI Workflow Templates, and bills strictly Pay-Per-Event:

For broader social commerce strategy and live-shopping breakdowns, explore our companion playbooks: How to Scrape Xiaohongshu (RedNote) Without Login and How to Scrape Xiaohongshu Live Streams, 1080p Video & KOL Leads.

Frequently Asked Questions (FAQ)