PGY creator metrics object

The PGY creator metrics object has 17 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-10-17Open in ChatGPTOpen in Claude

PGY creator metrics is how a Xiaohongshu creator's everyday notes did over the last 30 or 90 days, as PGY (蒲公英) sums it up: median impressions, reads and interactions, the engagement rate, and the share of notes past 100 and 1,000 likes. The _percentile fields say what share of comparable creators it exceeds.

creator_id is the PGY creator ID from the creator search. The notes one by one are PGY creator notes, and who follows the creator is their Audience.

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

notes integer

Notes in the period

median_impressions integer

Median impressions of a note

median_reads integer

Median reads of a note

median_engagements integer

Median interactions of a note

median_likes integer standard

Median likes of a note

median_favorites integer standard

Median saves of a note

median_comments integer standard

Median comments of a note

median_shares integer standard

Median shares of a note

engagement_rate number

Engagement rate, 0 to 1

video_completion_rate number standard

Completion rate of video notes, 0 to 1

image_3s_read_rate number standard

Share of image-note reads that last 3 seconds, 0 to 1

hundred_like_share number standard

Share of notes with 100 likes or more, 0 to 1

thousand_like_share number standard

Share of notes with 1,000 likes or more, 0 to 1

impressions_percentile number standard

Share of comparable creators whose median impressions it exceeds, 0 to 1

reads_percentile number standard

Share of comparable creators whose median reads it exceeds, 0 to 1

engagements_percentile number standard

Share of comparable creators whose median interactions it exceeds, 0 to 1

Endpoints that return PGY creator metrics

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

EndpointPathPrice
Xiaohongshu PGY creator metricsGET/v1/xiaohongshu/pgy/creators/metrics$0.0400

Example

One item from xiaohongshu.pgy.creators.metrics, as recorded 2026-10-12 21:53 UTC. Names, text, IDs and links are examples; the figures are as recorded.

PGY creator metrics · xiaohongshu.pgy.creators.metrics
{
  "creator_id": "622bd7c00000000007bc9f1a",
  "notes": 34,
  "median_impressions": 3535,
  "median_reads": 533,
  "median_engagements": 12,
  "median_likes": 10,
  "median_favorites": 2,
  "median_comments": 0,
  "median_shares": 3,
  "engagement_rate": 0.032,
  "video_completion_rate": 0.321,
  "image_3s_read_rate": 0.798,
  "hundred_like_share": 0.088,
  "thousand_like_share": 0,
  "impressions_percentile": 0.523,
  "reads_percentile": 0.476,
  "engagements_percentile": 0.333
}

The whole response is on the endpoint's page →

Related

Other objects