# Is there an API for Xiaohongshu PGY (Pugongying) creator data and rates?

> What Xiaohongshu's PGY (蒲公英) creator marketplace offers developers, and how to read PGY creators' rates, followers and median reads by API. Cost and code.

Canonical page: https://okdata.online/answers/xiaohongshu-pgy-creator-data-api/

**Short answer: **Xiaohongshu does not publish a public API for browsing PGY creators; the official route is the PGY web console with a brand account. okdata reads the creator data PGY shows advertisers: one search returns 20 creators with image and video note rates for $0.04, and one creator's full PGY profile costs $0.04.

A skincare brand's growth team keeps its creator pipeline in an internal tool. Every Friday someone exports PGY search results by hand and pastes rates and median reads into it, and by the next campaign half the numbers are out of date. What they want is simple: the tool searches PGY by topic on its own, and fetches a creator's current rate card the moment someone adds them to a campaign.

## What Xiaohongshu offers officially

PGY (蒲公英) is Xiaohongshu's marketplace where brands book creators. In the console, a brand with a professional account searches creators, filters by category, price and audience, and places orders. Xiaohongshu's open platform serves merchants and approved partners for their own shops and campaigns; it has no public endpoint for searching PGY creators. So if the data has to live in your own code, you either copy it out of the console or read it through a third-party API.

## Two endpoints

- [Xiaohongshu PGY creator search](/apis/xiaohongshu/pgy/creators/search/) finds creators by what their notes are about (`search_by=notes`, the default) or by name. Filter with `followers_min`, `followers_max` and `type` (mostly image or mostly video notes), and sort by followers, engagements, reads or rate (`lowest_rate`, `highest_rate`). Each result has followers, median reads and engagements of everyday notes, content categories, and what an image note and a video note cost in yuan.
- [Xiaohongshu PGY creator detail](/apis/xiaohongshu/pgy/creators/get/) returns one creator's PGY profile: followers, likes and saves, median reads and engagements, content and feature tags, both note prices and whether each is open for orders.

The PGY creator ID is the same 24-character ID as the Xiaohongshu user ID. If you already hold an author ID from [Xiaohongshu note search](/apis/xiaohongshu/notes/search/), you can ask for that creator's PGY profile straight away.

Median reads are worth more than they look. Xiaohongshu hides view counts on public notes, so the median reads PGY shows advertisers (returned as `median_views`) are the closest thing to a reach figure you will get.

## What it costs

| Job | Calls | Cost |
|---|---|---|
| 5 topic searches, one page each | 5 | $0.20 |
| Full profile for 30 shortlisted creators | 30 | $1.20 |
| Total | 35 | $1.40 |

Every further page of search results is one more call at the same price; 1,000 creators from search come to $2.00.

## Code

```python
import os, requests

API = "https://api.okdata.online"
H = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}

def get(path, **params):
    body = requests.get(API + path, headers=H, params=params, timeout=60).json()
    if body["code"] != "ok":
        raise RuntimeError(f"{body['code']}: {body['message']}")
    return body["data"]

found = get("/v1/xiaohongshu/pgy/creators/search", query="敏感肌",
            followers_min=10000, followers_max=100000, sort="lowest_rate")["items"]
for c in found[:5]:
    p = get("/v1/xiaohongshu/pgy/creators/get", id=c["id"])["item"]
    video = next((r for r in p["rates"] or [] if r["type"] == "video_note"), None)
    cpm = video and p["median_views"] and round(video["price"] / p["median_views"] * 1000)
    print(p["name"], p["followers"], video and video["price"], "yuan per 1k reads:", cpm)
```

## Limits worth knowing

- **Listed rates.** PGY shows what the creator lists; platform fees and negotiated discounts are settled in PGY when you order.
- **Only creators on PGY.** Someone who has not joined PGY has no profile to return. That call fails, and failed calls are not charged.
- **What stays in the console.** Audience profile, past sponsored notes and PGY's own CPM and CPE panels are not in these fields. Anything PGY does not show for a creator comes back null and is listed in `meta.unavailable`.
- **Read-only, public data.** No login to your PGY account, no messages, no orders.

## Other ways

To book, you still use the PGY console, and its audience data is what you check before signing. PGY's official agencies can shortlist and negotiate for you. Analytics tools such as 千瓜 or 新红 show creator rankings and trends without code. An API makes sense when PGY numbers need to sit inside your own tool, sheet or agent; over [MCP](/mcp/) an agent can run the same search. More in [creator discovery](/solutions/creator-discovery/).

## Endpoints used

- [Xiaohongshu PGY creator search](https://okdata.online/apis/xiaohongshu/pgy/creators/search/) `xiaohongshu.pgy.creators.search`: $0.04 per call · about 20 creators per page
- [Xiaohongshu PGY creator detail](https://okdata.online/apis/xiaohongshu/pgy/creators/get/) `xiaohongshu.pgy.creators.get`: $0.04 per call

Updated 2026-11-12