# How to look up Xiaohongshu (RedNote) PGY creator rates and audience 2 endpoints do it: Xiaohongshu PGY creator search → Xiaohongshu PGY creator audience profile. The worked example below is 6 calls and costs $0.24 in all; a failed call is not charged. Find creators on PGY, Xiaohongshu (RedNote)'s own marketplace for sponsored notes, by what they post about, with each one's rate for an image note and a video note on the same page; then get the audience of the ones you pick: the share by gender, age, province, city, interest and device. ## Step by step ### Step 1: Xiaohongshu PGY creator search Search creators by terms matched against what they write about, 20 a page. Add `view=full` to see the rate for an image note (`ext.rate_image_note`) and a video note (`ext.rate_video_note`), with median reads and interactions. Each item's `id` is the PGY creator ID the next step takes; `account_id` is the Xiaohongshu user ID, for the account and note endpoints. ([Xiaohongshu PGY creator search](https://dataxapi.com/apis/xiaohongshu/pgy/creators/search/), $0.0400 / a call) cURL ```bash curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/creators/search" \ --data-urlencode "query=咖啡" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" ``` Python ```python from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.xiaohongshu.pgy.creators.search(query="咖啡") print(result["data"]["items"]) ``` TypeScript ```typescript import { DataXAPI } from "@dataxapi/sdk"; const dx = new DataXAPI(); // reads DATAXAPI_API_KEY const result = await dx.xiaohongshu.pgy.creators.search({ query: "咖啡" }); console.log(result.data.items); ``` CLI ```bash dataxapi call xiaohongshu.pgy.creators.search 'query=咖啡' ``` Recorded response: From a response recorded 2026-10-12 21:55 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. ```jsonc { "code": "ok", "request_id": "925f8cc7-d891-4f23-8d87-46f8515c35e9", "data": { "items": [ { "id": "6acd5beb00000000c8b10386", "account_id": "6d5583880000000059f95d40", "username": "ajie_diy", "name": "阿杰爱折腾", "avatar_url": "https://sns-avatar-qc.xhscdn.com/avatar/68d7218800000000a4989fa3.jpg", "location": "北京", "categories": ["生活"], "subcategories": ["咖啡", "家居好物"], "metrics": { "followers": 30634 } }, // … 19 more ] }, "page": { "next_cursor": "c1.tanuG8dT9ozo4D_Rnm44jKf3-2o-wxDT8ESWtMQB", "cursor_expires_at": "2026-10-12T22:55:09.000Z", "has_more": true, "returned": 20 }, "warnings": [], "meta": { "capability": "xiaohongshu.pgy.creators.search", "result_status": "complete", "fetched_at": "2026-10-12T21:55:09.000Z", "cached": false, "replayed": false, "unavailable": {}, "billing": { "amount": "0.04", "currency": "USD", "balance_after": "9.96" } } } ``` ### Step 2: Xiaohongshu PGY creator audience profile Put the PGY creator ID into `id` to get the audience: `gender`, `age`, `province`, `city`, `interest` and `device`, each segment with its `share`, and `measured_at`, the day the figures are of. ([Xiaohongshu PGY creator audience profile](https://dataxapi.com/apis/xiaohongshu/pgy/creators/audience/get/), $0.0400 / a call) cURL ```bash curl -G "https://api.dataxapi.com/v1/xiaohongshu/pgy/creators/audience/get" \ --data-urlencode "id=5c0017ef6b58b740c92463fb" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" ``` Python ```python from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.xiaohongshu.pgy.creators.audience.get(id="5c0017ef6b58b740c92463fb") print(result["data"]["item"]) ``` TypeScript ```typescript import { DataXAPI } from "@dataxapi/sdk"; const dx = new DataXAPI(); // reads DATAXAPI_API_KEY const result = await dx.xiaohongshu.pgy.creators.audience.get({ id: "5c0017ef6b58b740c92463fb" }); console.log(result.data.item); ``` CLI ```bash dataxapi call xiaohongshu.pgy.creators.audience.get id=5c0017ef6b58b740c92463fb ``` Recorded response: 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. ```jsonc { "code": "ok", "request_id": "2d7a912b-3bcf-4ee6-ac5b-131dc3a9a989", "data": { "item": { "creator_id": "63a117400000000061166ea6", "measured_at": "2026-10-10T16:00:00.000Z", "gender": [ { "name": "male", "share": 0.27827228950824456 }, { "name": "female", "share": 0.7217277104917554 } ], "age": [ { "name": "<18", "share": 0.009193054136874362 }, { "name": "18-24", "share": 0.10156135998832627 }, // … 3 more ], "province": [ { "name": "浙江", "share": 0.3215255771842463 }, { "name": "江苏", "share": 0.24728383884110458 }, // … 34 more ], "city": [ { "name": "温州", "share": 0.2359665006790403 }, { "name": "徐州", "share": 0.1805115436849253 }, // … 8 more ], "interest": [ { "name": "美食", "share": 0.15246001214820815 }, { "name": "旅游", "share": 0.1216170614834312 }, // … 18 more ], "device": [ { "name": "苹果", "share": 0.756649688737974 }, { "name": "小米", "share": 0.0622524052065648 }, // … 8 more ] } }, "warnings": [], "meta": { "capability": "xiaohongshu.pgy.creators.audience.get", "result_status": "complete", "fetched_at": "2026-10-12T21:53:02.000Z", "cached": false, "replayed": false, "unavailable": { "gender.count": "capability", "age.count": "capability", "province.count": "capability", "city.count": "capability", "interest.count": "capability", "device.count": "capability", "city_tier": "platform", "crowd": "platform", "purchase_category": "platform", "purchase_amount": "platform" }, "billing": { "amount": "0.04", "currency": "USD", "balance_after": "9.96" } } } ``` ## What the example costs One page of PGY creators (20, with their rates), then the audience of 5 of them | Endpoint | Calls | Price | Subtotal | | --- | --- | --- | --- | | [Xiaohongshu PGY creator search](https://dataxapi.com/apis/xiaohongshu/pgy/creators/search/) | 1 | $0.0400 | $0.0400 | | [Xiaohongshu PGY creator audience profile](https://dataxapi.com/apis/xiaohongshu/pgy/creators/audience/get/) | 5 | $0.0400 | $0.20 | | Total | 6 | | $0.24 | Prices are the prices in force when this page was built. A failed call, and an object that does not exist, cost nothing. ## In your AI (MCP) Connect DataXAPI to your AI client once. Then say what you want; the agent finds these endpoints, checks the price and calls them on your balance. Say: Search Xiaohongshu's PGY for creators who post about 咖啡 (coffee), list each one's image-note and video-note rates, then get the audience of the 5 with the lowest rates. What the agent sends to the call tool: ```json { "capability": "xiaohongshu.pgy.creators.search", "query": "咖啡", "idempotency_key": "" } ``` [About the MCP server](https://dataxapi.com/mcp/) ## Good to know - A PGY creator ID is 24 hexadecimal characters and is not the Xiaohongshu handle; every other PGY endpoint takes it. - For terms no creator matches, the platform still returns loosely related creators rather than nothing, so check their `categories` first. A page holds 20; a `page.next_cursor` is good for an hour. - The audience gives shares only, not the count in each segment (`count`); city tier, consumer groups and purchase breakdowns are not given by the platform. An audience that cannot be found is not charged. ## Endpoints - [Xiaohongshu PGY creator search](https://dataxapi.com/apis/xiaohongshu/pgy/creators/search/) - [Xiaohongshu PGY creator audience profile](https://dataxapi.com/apis/xiaohongshu/pgy/creators/audience/get/) ## More about Xiaohongshu (RedNote) - [Xiaohongshu (RedNote) API](https://dataxapi.com/apis/xiaohongshu/) - [Xiaohongshu PGY API](https://dataxapi.com/apis/xiaohongshu/pgy/) - [How to get Xiaohongshu (RedNote) note comments in bulk](https://dataxapi.com/guides/xiaohongshu-note-comments/) - [How to search and export Xiaohongshu (RedNote) notes by keyword](https://dataxapi.com/guides/xiaohongshu-search-export-notes/) - [How do I export Xiaohongshu (RedNote) data?](https://dataxapi.com/answers/export-xiaohongshu-data/) - [Can ChatGPT read Xiaohongshu (RedNote)?](https://dataxapi.com/answers/can-chatgpt-read-xiaohongshu/) --- Catalog revision c48ce454ae6c4c65. [HTML version](https://dataxapi.com/guides/xiaohongshu-pgy-creator-rates/)