PGY creator costs and summary object

The PGY creator costs and summary object has 39 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

date time

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

currency text

Currency of the costs below

image_cpm amount

Estimated CPM of an image note (cost of a thousand impressions), in yuan; null where PGY has no estimate

image_cpm_percentile number standard

Share of comparable creators whose image-note CPM is higher (PGY's "better than peers"), 0 to 1

video_cpm amount

Estimated CPM of a video note (cost of a thousand impressions), in yuan; null where PGY has no estimate

video_cpm_percentile number standard

Share of comparable creators whose video-note CPM is higher (PGY's "better than peers"), 0 to 1

image_cpe amount

Estimated cost per interaction of an image note, in yuan; null where PGY has no estimate

image_cpe_percentile number standard

Share of comparable creators whose image-note cost per interaction is higher (PGY's "better than peers"), 0 to 1

video_cpe amount

Estimated cost per interaction of a video note, in yuan; null where PGY has no estimate

video_cpe_percentile number standard

Share of comparable creators whose video-note cost per interaction is higher (PGY's "better than peers"), 0 to 1

image_read_cost amount

Estimated cost per read of an image note, in yuan; null where PGY has no estimate

image_read_cost_percentile number standard

Share of comparable creators whose image-note cost per read is higher (PGY's "better than peers"), 0 to 1

video_read_cost amount

Estimated cost per read of a video note, in yuan; null where PGY has no estimate

video_read_cost_percentile number standard

Share of comparable creators whose video-note cost per read is higher (PGY's "better than peers"), 0 to 1

image_shop_visit_cost amount

Estimated cost per shop visitor an image note brings (PGY's spillover store visits), in yuan; null where PGY has no estimate

image_shop_visit_cost_percentile number standard

Share of comparable creators whose image-note cost per shop visitor is higher (PGY's "better than peers"), 0 to 1

video_shop_visit_cost amount

Estimated cost per shop visitor a video note brings (PGY's spillover store visits), in yuan; null where PGY has no estimate

video_shop_visit_cost_percentile number standard

Share of comparable creators whose video-note cost per shop visitor is higher (PGY's "better than peers"), 0 to 1

median_impressions integer

Median impressions of a note

median_impressions_percentile number standard

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

median_reads integer

Median reads of a note

median_reads_percentile number standard

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

median_engagements integer

Median interactions of a note

median_engagements_percentile number standard

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

median_shop_visits integer

Median shop visitors a note brings

median_shop_visits_percentile number standard

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

follower_growth number standard

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

follower_growth_percentile number standard

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

invite_reply_rate number standard

Share of collaboration invitations answered within 48 hours, 0 to 1

easy_to_reach yes/no standard

Whether PGY marks the creator "easy to reach" (好联系, the mark beside the invitation reply rate on the page)

active_days_7d integer standard

Days active in the last 7

is_active yes/no standard

Whether PGY marks the creator "active" (活跃, the mark beside the active days of the last 7 on the page)

notes_30d integer standard

Notes published in the last 30 days, everyday and sponsored alike (the page's "notes published"); the same in either tab

highlight text standard

The strength PGY marks the creator with, in its words (a title for a kind of creator); null when none

highlight_reason text standard

PGY's explanation of that strength, in its words (such as which figure ranks in what top share of peers)

content_mix list of object standard

The share of the creator's notes in each content category, largest first

content_mix[].category text standard

The content category, in the platform's words

content_mix[].share number standard

The share, 0 to 1

industries list of text standard

Industries the creator has worked with, in the platform's words

Endpoints that return PGY creator costs and summary

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

EndpointPathPrice
Xiaohongshu PGY creator costs and data summaryGET/v1/xiaohongshu/pgy/creators/costs/metrics$0.0400

Example

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

PGY creator costs and summary · xiaohongshu.pgy.creators.costs.metrics
{
  "creator_id": "64b916ab000000009bfb830e",
  "date": "2026-11-09T00:00:00Z",
  "currency": "CNY",
  "image_cpm": "1202.709",
  "image_cpm_percentile": 0.0998,
  "video_cpm": "11556.0641",
  "video_cpm_percentile": 0.0188,
  "image_cpe": "572.2222",
  "image_cpe_percentile": 0.0227,
  "video_cpe": "214.5833",
  "video_cpe_percentile": 0.0411,
  "image_read_cost": "25.2377",
  "image_read_cost_percentile": 0.7452,
  "video_read_cost": "76.313",
  "video_read_cost_percentile": 0.7667,
  "image_shop_visit_cost": null,
  "image_shop_visit_cost_percentile": null,
  "video_shop_visit_cost": null,
  "video_shop_visit_cost_percentile": null,
  "median_impressions": 2200,
  "median_impressions_percentile": 0.4551,
  "median_reads": 302,
  "median_reads_percentile": 0.4167,
  "median_engagements": 22,
  "median_engagements_percentile": 0.4319,
  "median_shop_visits": 0,
  "median_shop_visits_percentile": 0,
  "follower_growth": 0.001,
  "follower_growth_percentile": 0.683,
  "invite_reply_rate": 0.375,
  "easy_to_reach": false,
  "active_days_7d": 7,
  "is_active": true,
  "notes_30d": 38,
  "highlight": "周末的周末露营日常,随手记录一下",
  "highlight_reason": "周末露营|第一次尝试就爱上了,清单放评论区",
  "content_mix": [
    { "category": "周末露营|第一次尝试就爱上了,清单放评论区", "share": 0.395 },
    { "category": "周末露营这件事,越简单越好", "share": 0.395 }
  ],
  "industries": []
}

The whole response is on the endpoint's page →

Related

Other objects