PGY creator core figures history object

The PGY creator core figures history object has 21 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

days integer

How many of the most recent days the figures cover

currency text

Currency of the costs

date time

The day the period's figures run to: a calendar day in China time (UTC+8), written as midnight UTC of its date

cpm amount

CPM: the cost of a thousand impressions, in yuan; null where there is none

cpe amount

CPE: the cost of one interaction, in yuan; null where there is none

cpv amount

CPV: the cost of one read, in yuan, as PGY's trend chart works it out; null where there is none

shop_visit_cost amount

Cost per shop visitor a note brings (PGY's spillover store visits), in yuan; null where there is none

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_shop_visits integer

Median shop visitors a note brings (PGY's spillover store visits); a note that brought none counts as 0

points list of object

The figures day by day, one entry a day, oldest first: each the figures PGY worked out that day

points[].date time

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

points[].cpm amount

CPM: the cost of a thousand impressions, in yuan; null where there is none

points[].cpe amount

CPE: the cost of one interaction, in yuan; null where there is none

points[].cpv amount

CPV: the cost of one read, in yuan, as PGY's trend chart works it out; null where there is none

points[].shop_visit_cost amount

Cost per shop visitor a note brings (PGY's spillover store visits), in yuan; null where there is none

points[].median_impressions integer

Median impressions of a note

points[].median_reads integer

Median reads of a note

points[].median_engagements integer

Median interactions of a note

points[].median_shop_visits integer

Median shop visitors a note brings (PGY's spillover store visits); a note that brought none counts as 0

Endpoints that return PGY creator core figures history

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

EndpointPathPrice
Xiaohongshu PGY creator core figures historyGET/v1/xiaohongshu/pgy/creators/costs/history$0.0400

Example

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

PGY creator core figures history · xiaohongshu.pgy.creators.costs.history
{
  "creator_id": "6db7d6c4000000008ff2aa80",
  "days": 30,
  "currency": "CNY",
  "date": "2026-11-09T00:00:00Z",
  "cpm": "6.2482",
  "cpe": "0.8591",
  "cpv": "0.0153",
  "shop_visit_cost": null,
  "median_impressions": 4801380,
  "median_reads": 4570345,
  "median_engagements": 34920,
  "median_shop_visits": 0,
  "points": [
    {
      "date": "2026-10-11T00:00:00Z",
      "cpm": "4.4683",
      "cpe": "0.8324",
      "cpv": "0.0108",
      "shop_visit_cost": null,
      "median_impressions": 6713899,
      "median_reads": 6511479,
      "median_engagements": 36041,
      "median_shop_visits": 0
    },
    {
      "date": "2026-10-12T00:00:00Z",
      "cpm": "4.1886",
      "cpe": "0.5148",
      "cpv": "0.0104",
      "shop_visit_cost": null,
      "median_impressions": 7162338,
      "median_reads": 6749230,
      "median_engagements": 58279,
      "median_shop_visits": 0
    },
    // … 28 more
  ]
}

The whole response is on the endpoint's page →

Related

Other objects