PGY creator follower summary object

The PGY creator follower summary object has 16 fields and is returned by 1 endpoint on Xiaohongshu (RedNote). A call costs $0.0400. It is a preview structure and may still change.

Preview object · Updated 2026-11-10Open in ChatGPTOpen in Claude

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

creator_id text

PGY creator ID

followers integer

Followers

gained integer

Net followers gained over the last 30 days; negative when followers were lost

growth number

Follower growth over the last 30 days: 0.008 is 0.8% more; negative when followers were lost

growth_percentile number standard

Share of comparable creators whose follower growth it exceeds, 0 to 1

active_followers integer

Active followers: followers active on Xiaohongshu in the last 28 days

active_share number

Active followers as a share of all followers, 0 to 1

active_percentile number standard

Share of comparable creators whose share of active followers it exceeds, 0 to 1

engaged_followers integer

Engaged followers: followers who interacted with the creator's notes in the last 30 days

engaged_share number

Engaged followers as a share of all followers, 0 to 1

engaged_percentile number standard

Share of comparable creators whose share of engaged followers it exceeds, 0 to 1

reading_followers integer

Reading followers: followers who read the creator's notes in the last 30 days

reading_share number

Reading followers as a share of all followers, 0 to 1

reading_percentile number standard

Share of comparable creators whose share of reading followers it exceeds, 0 to 1

buying_followers integer

Buying followers: followers who bought something on Xiaohongshu in the last 30 days

buying_share number

Buying followers as a share of all followers, 0 to 1

Endpoints that return PGY creator follower summary

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
Xiaohongshu PGY creator follower summaryGET/v1/xiaohongshu/pgy/creators/followers/metrics$0.0400

Example

One item from xiaohongshu.pgy.creators.followers.metrics, as recorded 2026-11-10 09:54 UTC. Names, text, IDs and links are examples; the figures are as recorded.

PGY creator follower summary · xiaohongshu.pgy.creators.followers.metrics
{
  "creator_id": "636dd0de0000000011c5a60b",
  "followers": 248737,
  "gained": 8966,
  "growth": 0.037,
  "growth_percentile": 0.936,
  "active_followers": 193190,
  "active_share": 0.777,
  "active_percentile": 0.909,
  "engaged_followers": 15180,
  "engaged_share": 0.061,
  "engaged_percentile": 0.946,
  "reading_followers": 115890,
  "reading_share": 0.466,
  "reading_percentile": 0.988,
  "buying_followers": 45706,
  "buying_share": 0.184
}

The whole response is on the endpoint's page →

Related

Other objects