RedNote Xiaohongshu Search Scraper

Search RedNote (Xiaohongshu / 小红书) notes by one keyword through an authorized logged-in browser session. The actor returns a clean, one-row-per-note dataset with the note URL, title, creator, displayed and normalized likes, cover image, search keyword, result position, and collection time.

Use it for China-market research, trend discovery, brand monitoring, and gathering public content examples. Do not use it for full note-detail extraction, profile cataloguing, comments, private content, or account automation.

Output

Field	Meaning
id	Public note identifier from the rendered URL
sourceUrl	Canonical public Xiaohongshu note URL
resultPosition	One-based position in the rendered search result cards
title	Title text when rendered
authorName / authorUrl	Public creator identity when rendered
likesText / likesCount	Engagement text as displayed plus a normalized number when parseable
coverImageUrl	Public cover image URL when present
searchQuery / scrapedAt	Query provenance and ISO collection time

Price

• Actor start: $0.00005 per run
• Search result: $0.006 per validated note card saved
• Platform usage: charged separately under Pay per event + usage

The actor never charges for an invalid, duplicate, or unsaved card. A typical 20-result run has up to $0.12 in event charges plus platform usage.

Input

{
    "searchQuery": "护肤",
    "maxResults": 20,
    "sessionCookie": "web_session=..."
}

sessionCookie is required because Xiaohongshu currently shows "log in to view search results" to anonymous browser sessions. Pass a current cookie header from an account you are authorized to use. It is treated as a secret and is never written to results or summaries.

Run outcomes

Every run writes both OUTPUT and RUN_SUMMARY in the default key-value store.

• COMPLETE: validated search cards were returned.
• PARTIAL: useful cards were saved, but an explicit cap or card-parse issue occurred.
• INVALID_INPUT: change the query or result cap and retry.
• UPSTREAM_FAILED: Xiaohongshu did not render extractable public cards after browser retries; retry later or use an authorized session cookie.

API and agent use

The actor is a regular Apify Actor, so it is available through the Apify API and Apify MCP after deployment. It accepts a single query and returns a flat, concise dataset designed for agent consumption.

Limitations

Xiaohongshu can change its browser rendering, rate limits, login rules, and access controls without notice. Results reflect only note cards your authorized session is able to render. Engagement text is preserved as displayed, and likesCount is present only when the rendered text can be parsed.

TikHub currently documents a Xiaohongshu App V2 search-notes API, but the configured local TIKHUB_API_KEY is a placeholder, so this actor does not advertise no-cookie provider mode yet.

Legal notice

Use this actor only for lawful collection and analysis of public data, in compliance with applicable law and the rights and platform rules relevant to your use case. Do not use it to access private data or bypass access controls.