Xiaohongshu (RedNote) API - Notes, Users, Comments

Use this Actor as an API-first RedNote/Xiaohongshu data connector on Apify. It wraps JustOneAPI endpoints so you can search notes and users, fetch profiles, published posts, note details, comments, replies, hot-search data, keyword suggestions, topic notes, and resolve xhslink share URLs from one Actor.

This Actor is built for users who want structured RedNote data without maintaining browser scrapers, request signing, proxies, or RedNote cookies. Bring your own JustOneAPI token from https://justoneapi.com/.

Why Use This Actor

• One Actor for 12 RedNote/Xiaohongshu API operations.
• No RedNote login, QR code, browser session, or cookie input required.
• Secret JustOneAPI token input. Tokens are not logged, stored in output, shared, or reused.
• Normalized Dataset rows for notes, users, comments, topics, keyword suggestions, and summary results.
• Full original JustOneAPI response saved in the OUTPUT key-value store for debugging and advanced use.
• Default setupGuide run returns a non-empty Dataset row without consuming a JustOneAPI token, so Apify Store auto-tests stay safe.

Common Workflows

• Keyword research: searchNotes -> noteDetails -> noteComments
• Creator discovery: searchUsers -> userProfile -> userNotes
• Shared post analysis: resolveShareUrl -> noteDetails -> noteComments
• Trend monitoring: hotSearch -> searchNotes -> keywordSuggestions
• Topic tracking: topicNotes -> noteDetails
• Video workflows: noteVideoDetails for video-oriented note detail responses

Quick Start

1. Run the Actor with the default setupGuide operation. This needs no token and explains the setup.
2. Register at JustOneAPI and create your API token.
3. Choose an operation in the input form.
4. Paste your token into the secret JustOneAPI token field.
5. Fill only the fields required by the selected operation. Unused fields are ignored.

API operations are billed by JustOneAPI against the token supplied for that run. This Actor does not include a shared token.

Supported Operations

Operation	What it does	Main required input
setupGuide	Returns setup instructions without calling JustOneAPI	None
hotSearch	Gets RedNote hot-search or trending note data	Optional searchWord
searchNotes	Searches notes by keyword	keyword
searchUsers	Searches users by keyword	keyword
userNotes	Gets notes published by a user	userId
noteDetails	Gets note detail with engagement metrics	noteId
noteVideoDetails	Gets video-oriented note detail data	noteId
noteComments	Gets top-level comments for a note	noteId
commentReplies	Gets replies under a comment	noteId, commentId
userProfile	Gets public user profile data	userId
keywordSuggestions	Gets platform keyword suggestions	keyword
topicNotes	Gets notes under a topic	topicId
resolveShareUrl	Resolves copied RedNote/xhslink share links	shareUrl

Input Examples

Setup Guide

{
  "operation": "setupGuide"
}

Search Notes

{
  "operation": "searchNotes",
  "token": "<YOUR_JUSTONEAPI_TOKEN>",
  "keyword": "coffee",
  "page": 1,
  "sortType": "general",
  "noteType": "ALL",
  "timeFilter": "ALL"
}

Note Details

{
  "operation": "noteDetails",
  "token": "<YOUR_JUSTONEAPI_TOKEN>",
  "noteId": "<NOTE_ID>"
}

Note Comments

{
  "operation": "noteComments",
  "token": "<YOUR_JUSTONEAPI_TOKEN>",
  "noteId": "<NOTE_ID>",
  "sort": "latest"
}

User Profile

{
  "operation": "userProfile",
  "token": "<YOUR_JUSTONEAPI_TOKEN>",
  "userId": "<USER_ID>"
}

Resolve Share URL

{
  "operation": "resolveShareUrl",
  "token": "<YOUR_JUSTONEAPI_TOKEN>",
  "shareUrl": "https://xhslink.com/m/..."
}

Use a real copied RedNote share link or xhslink.com short link. Canonical URLs such as https://www.xiaohongshu.com/explore/{noteId} are not accepted by the upstream share-link endpoint.

Output

Each run stores data in two places:

• Default Dataset: normalized rows. List operations produce one row per note, user, comment, topic item, keyword suggestion, or hot-search item. Detail and share-link operations produce one summary row.
• Default key-value store OUTPUT: run metadata, normalized items, and the complete original JustOneAPI response.

Common normalized fields include:

• operation, itemType, itemIndex, requestId, recordTime
• noteId, noteUrl, title, description, noteType, publishedAt
• userId, userNickname, userRedId, userAvatar
• commentId, parentCommentId, content, createdAt
• likedCount, commentCount, collectedCount, sharedCount, replyCount
• imageUrls, coverUrl, tags
• raw, containing the original source item

The stored request metadata excludes the access token.

Pricing

This Actor is not monetized in Apify Store. You may still pay normal Apify platform usage costs when running Actors on Apify, depending on your Apify plan and usage.

JustOneAPI usage is billed separately by JustOneAPI against the token you provide. Register and manage your token at https://justoneapi.com/.

Notes and Limits

• noteDetails returns engagement metrics.
• noteVideoDetails is intended for video download workflows and does not include the same engagement metrics.
• Pagination fields such as lastCursor, cursor, searchId, and sessionId should be copied from the previous API response.
• The Actor uses public or recommended JustOneAPI versions and does not expose deprecated or documentation-hidden versions.
• This Actor is not affiliated with Xiaohongshu or RedNote. Use exported data in line with applicable laws, platform terms, and privacy requirements.