Xiaohongshu PGY API (蒲公英)
7 endpoints read Xiaohongshu PGY (蒲公英): creator search, rate cards, audience profiles, performance, keyword search index. $0.0400 a call. No Xiaohongshu login and no cookie; a failed call is free.
What you get
The first 8 rows of a response recorded 2026-10-12 21:53 UTC. Xiaohongshu PGY creator metrics API →
What this data is
蒲公英 (PGY) is Xiaohongshu's official creator marketplace, where brands book creators for sponsored notes. It holds each creator's rates for an image note and a video note, their audience profile and how their notes perform, and it has a keyword search index of its own.
Five endpoints read creators by PGY creator ID, which search returns. Two read keywords: a keyword's day-by-day search index over about the last three months, and what people search before and after it.
- Rates in yuan
- In the full view,
ext.rate_image_noteandext.rate_video_noteare the creator's listed prices for an image note and a video note, in CNY. - Medians over 30 or 90 days
- Performance is of everyday notes: median impressions, reads and interactions, the engagement rate, the share of notes past 100 and 1,000 likes, and the share of comparable creators it exceeds.
- Shares, not head counts
- The audience profile gives the share of each segment by gender, age, province, city, interest and device, with the day the figures are of in
measured_at. - A search index, not a count
- The keyword index is the platform's own index. The platform sets the period (about three months) and it cannot be chosen; days are calendar days in China time.
- Sponsored or not
- A creator's notes say whether each was sponsored and, when it was, for which brand.
{
"code": "ok",
"request_id": "5abe7682-8e5c-465c-b1ca-aaa0992dff54",
"data": {
"item": {
"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
}
},
"warnings": [],
"meta": {
"capability": "xiaohongshu.pgy.creators.metrics",
"result_status": "complete",
"fetched_at": "2026-10-12T21:53:24.000Z",
"cached": false,
"replayed": false,
"unavailable": {},
"billing": {
"amount": "0.04",
"currency": "USD",
"balance_after": "9.96"
}
}
}From a response recorded 2026-10-12 21:53 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.
Xiaohongshu PGY creator metrics API · This example as a JSON file
The 7 endpoints
Each row is an endpoint: what it returns and what one call costs.
A typical use, with its bill
Vet creators before a seeding campaign. One search in the full view already returns, for 20 creators, the two rates and the median reads and interactions. Read the audience profile and the recent notes only for the five you keep.
Use it in your AI
Connect once and your AI finds these endpoints, checks the price and calls them by itself.
Read https://dataxapi.com/agents.md and set up DataXAPI in this agent. My API key is dx_live_…; use it for every DataXAPI call.Questions about PGY data
Short answers. The details are on each endpoint's page.
Xiaohongshu PGY creator metrics API →How much does it cost?
Per call, no subscription. All 7 endpoints cost $0.0400 a call. You are charged when data comes back; a failed call costs nothing.
What currency are the rates in?
Chinese yuan, as the creator lists them on PGY. What DataXAPI charges for the call is in US dollars.
Can I choose the period of the keyword index?
No. The platform returns about the last three months, day by day, with each day's notes about the keyword and how often they were shown, read and engaged with.
Where does the creator ID come from?
From the search endpoint. It is PGY's own ID for the creator, and the other four creator endpoints take it.
Do I need a PGY or Xiaohongshu account?
No. You hold one DataXAPI key: no Xiaohongshu login, no cookie, no advertiser account.
The same kind of data elsewhere
The same key and the same response shape read these too.
Douyin Xingtu API
Douyin's creator marketplace: search, rate cards, audience, reach and conversion.
Douyin trend-index API
Douyin's keyword index returns the same structure as PGY's, so one piece of code reads both.
More named data products
How-to guides and answers
Read PGY with one key.
No platform login, no cookie, no subscription. A failed call is free.