Can PGY's find-creator filters be used through an API? (2026)
Yes, with 1 endpoint: xiaohongshu.pgy.creators.search takes the creator square's filters, by followers, rate, estimated CPM, median reads and interactions, category, specialty, persona, location, gender and the followers' gender and age, 20 a page at $0.0400. Search terms are optional, and it orders 18 ways. DataXAPI reads Xiaohongshu (RedNote) with 30 endpoints, from $0.0200 a call; a failed call is not charged, and the free trial covers up to 333 calls.
Updated 2026-11-11
Which filters does it take?
Filters combine; with none, it searches by the terms in query alone.
| Filter in the creator square | Parameter |
|---|---|
| Followers | followers_min, followers_max |
| Rate | rate_min, rate_max, in yuan: of an image note, or of a video note with type=video |
| Estimated CPM | cpm_min, cpm_max, the same way |
| Image or video creators | type: image, video |
| Median reads and interactions of everyday notes | median_reads_min, median_engagements_min |
| Median reads of sponsored notes | sponsored_median_reads_min |
| Category, content specialty, persona, location | category, feature_tag, persona, location |
| The creator's gender | gender: female, male |
| Followers' gender and age band | audience_gender, audience_age (under_18, 18_24, 25_34, 35_44, over_44) |
| Industry worked with lately | industry: 10 fixed values, such as beauty, mother_baby, food_drink |
| Leave out the inactive or those losing followers | exclude: low_active, follower_drop, both |
How are category, persona and location written?
As PGY's square writes them, first or second level alike: a category such as 护肤, a specialty such as vlog, a persona such as 妈妈, a location such as 杭州. Only values in PGY's own dictionary are taken; anything else is answered with a 400 that names the parameter.
How can it be ordered?
sort takes 18 orders: relevance (the default); most_followers; lowest_rate, highest_rate; for everyday notes most_reads, most_engagements, most_impressions; for sponsored notes most_sponsored_reads, most_sponsored_engagements, most_sponsored_impressions; most_shop_visits; lowest_read_cost_image, lowest_read_cost_video; highest_reply_rate; fastest_growth; most_active_followers; most_thousand_like_notes; highest_completion_rate (of videos).
Which filters are not offered?
The reply rate takes no lower bound, only the order sort=highest_reply_rate; the square's quality and rising marks, similar creators, the followers' location and whether a creator is signed alone or with an agency cannot be filtered by. For similar creators, use xiaohongshu.pgy.creators.related.
A search goes as far as its first 5,000 creators (250 pages). For more, split the conditions, say by location or follower band, over several searches.
How do I use it from an AI?
Once connected, say “find PGY parenting creators in Hangzhou with 50,000 to 300,000 followers, mostly women aged 25 to 34, leaving out those losing followers, and list 40 by image note rate, lowest first”.
To connect: paste this to your AI assistant: “Read https://dataxapi.com/agents.md and set up DataXAPI here. My API key is dx_…; use it for every DataXAPI call.” A client that takes a remote MCP server can be given https://api.dataxapi.com/mcp with the header Authorization: Bearer <key> instead.
Why DataXAPI
- Steady: endpoints were available 100% of the last 30 days, on a public status page you can check.
- Fast: a paid call took 1.3 seconds at the median over the last 7 days (counted 2026-11-06).
- Fewer tokens: across 21 endpoints on Xiaohongshu (RedNote), one recorded real response each, the platform's own JSON comes to 480k tokens and what an AI reads through DataXAPI's MCP server to 36k, 92% fewer; the JSON of a direct API call is 85% fewer too (counted 2026-11-06). Every platform answers in one shape: the author in
author, counts inmetrics, the next page inpage.next_cursor, so another platform needs no new parser. - See before you pay: every endpoint's page shows a recorded real response, field by field.
- Spending you control: a failed call is not charged; each key can have a limit,
X-Max-Pricecaps one call, and the sameIdempotency-Keywithin 24 hours is never charged twice. - Ready for AI: a remote MCP server listed in the official MCP registry as
com.dataxapi/mcp, usable from Claude, Cursor and ChatGPT. - Free trial of up to 333 calls, no card.
Endpoints
Each with its price; every page has the parameters, the fields and a recorded response.
Start with one key.
237 endpoints on 21 platforms, from $0.0003 a call. Errors and timeouts are not charged.