Follower history object

The Follower history object has 6 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-07Open 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

The creator ID: the one the request gave

days integer

How many of the most recent days the figures cover

gained integer

Net followers gained over the period; negative when followers were lost

growth number

The net gain as a share of the followers at the start: 0.01 is 1% more

points list of object

The follower count day by day, one entry a day, oldest first

points[].date time

The day: a calendar day in China time (UTC+8), written as midnight UTC of its date

points[].followers integer

Followers that day

Endpoints that return Follower history

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

EndpointPathPrice
Xiaohongshu PGY creator follower historyGET/v1/xiaohongshu/pgy/creators/followers/history$0.0400

Example

One item from xiaohongshu.pgy.creators.followers.history, as recorded 2026-11-07 04:28 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Follower history · xiaohongshu.pgy.creators.followers.history
{
  "creator_id": "608564b2000000000ebdd43b",
  "days": 30,
  "gained": 11,
  "growth": 0.0009,
  "points": [
    { "date": "2026-10-08T00:00:00Z", "followers": 11043 },
    { "date": "2026-10-09T00:00:00Z", "followers": 11044 },
    // … 28 more
  ]
}

The whole response is on the endpoint's page →

Related

Other objects