RedNote (Xiaohongshu) Profile Posts Scraper

Collect the public posts published by one RedNote or Xiaohongshu profile and save each post as a structured dataset row.

From profile to dataset

Paste a public profile URL or send the profile ID directly in profile_id_or_url. URL extraction is handled by the ToolzerHub API.

{
  "profile_id_or_url": "61b46d790000000010008153",
  "maxItems": 100
}

maxItems defaults to 100. The Store form is prefilled with 20. Set it to 0 when you want the Actor to keep paginating until RedNote has no more public rows.

Fields you can use

Field	Contents
id	Post ID
title, display_title	Post title fields returned by RedNote
likes	Like count
comments_count	Comment count
collected_count	Save or collect count
share_count	Share count
type	Post type
create_time	Unix creation timestamp
user	Author data attached to the post
post_detail	Full post detail, only present when addonPostDetails is on

{
  "id": "68b39115000000001c037dad",
  "title": "Trail day 3",
  "display_title": "Trail day 3",
  "likes": 2007,
  "comments_count": 89,
  "collected_count": 115,
  "type": "video",
  "create_time": 1756598549
}

Add full post detail

Set addonPostDetails to true and every row gets a post_detail field merged in — the same fields RedNote Post Scraper returns for that post, fetched with one extra request per row. Image and video posts route to the matching detail endpoint automatically based on the post's own type.

{
  "profile_id_or_url": "61b46d790000000010008153",
  "maxItems": 20,
  "addonPostDetails": true
}

This adds a charged event per enriched row, on top of the per-row result charge. If a post's detail request fails, the row is still saved without post_detail — nothing is skipped and nothing is charged for that row's enrichment.

Pagination behavior

The Actor follows RedNote's opaque continuation cursor. It stops at your cap, an empty page, the end of the public post list, or a repeated cursor. That last guard prevents a stalled run from looping forever.

Common questions

Why did the run stop below maxItems?

The cap limits saved rows; it can't make RedNote expose more posts. A profile with fewer public posts produces fewer rows.

Is a cookie required for profile posts?

No. You don't provide a login, cookie, or session token.

Does turning on addonPostDetails slow the run down?

Yes, a little — each row now costs one extra request. Leave it off if you only need the feed-level fields already listed above.

Use RedNote Profile Scraper for the account record itself. RedNote Favorites Scraper checks publicly visible saved posts, with an important visibility limitation.