Which APIs support a RedNote creator shortlist?
Which APIs support a RedNote creator shortlist? Follow concrete contracts, examples and reviewable steps using Xiaohongshu (RedNote).
Copy the agent prompt manually
Answer
Start by inspecting the contracts and local samples for Xiaohongshu PGY creator search, Xiaohongshu PGY creator audience profile, Xiaohongshu PGY creator costs and data summary. Establish the input for xiaohongshu.pgy.creators.search, then check whether its creator object contains the fields your task needs.
Build a candidate set with search, then inspect profiles, audiences or costs. Record follower size, activity and rates separately; do not infer reachability, authenticity or collaboration intent when no field supports it.
Relevant contracts
| Capability | Object | Shape | Pagination |
|---|---|---|---|
| xiaohongshu.pgy.creators.search | Creator | items | Explicit cursor |
| xiaohongshu.pgy.creators.audience.get | Audience distribution | item | No cursor |
| xiaohongshu.pgy.creators.costs.metrics | Pgy creator costs | item | No cursor |
Input contract
Inspect meanings, examples and conditional rules for the selected method. view and fields control the response without changing the TEST unit price.
- Only send fields defined for this method; unknown fields are rejected before execution.
| Method | Field | Type | Requirement | Meaning | Enum or bound | Example |
|---|---|---|---|---|---|---|
| GET | query | string | Optional / conditional | Search terms, matched against what creators' notes are about; for terms no creator matches the platform still returns loosely related creators, not an empty result. Leave out to find by the filters alone | — | — |
| GET | sort | string | Optional / conditional | Order: relevance (the default); most_followers; lowest_rate, highest_rate; most_reads, most_engagements, most_impressions (medians of everyday notes); most_sponsored_reads, most_sponsored_engagements, most_sponsored_impressions; most_shop_visits; lowest_read_cost_image, lowest_read_cost_video (estimated cost per read); highest_reply_rate; fastest_growth; most_active_followers; most_thousand_like_notes; highest_completion_rate (of videos) | ["relevance","most_followers","lowest_rate","highest_rate","most_reads","most_engagements","most_impressions","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"] | — |
| GET | followers_min | integer | Optional / conditional | At least this many followers | 1 … ∞ | — |
| GET | followers_max | integer | Optional / conditional | At most this many followers | 1 … ∞ | — |
| GET | rate_min | integer | Optional / conditional | Rate at least this, in yuan: of an image note, or of a video note with type=video | 1 … ∞ | — |
| GET | rate_max | integer | Optional / conditional | Rate at most this, in yuan: of an image note, or of a video note with type=video | 1 … ∞ | — |
| GET | cpm_min | integer | Optional / conditional | Estimated CPM at least this, in yuan: of an image note, or of a video note with type=video | 1 … ∞ | — |
| GET | cpm_max | integer | Optional / conditional | Estimated CPM at most this, in yuan: of an image note, or of a video note with type=video | 1 … ∞ | — |
| GET | median_reads_min | integer | Optional / conditional | Median reads of everyday notes at least this | 1 … ∞ | — |
| GET | median_engagements_min | integer | Optional / conditional | Median interactions of everyday notes at least this | 1 … ∞ | — |
| GET | sponsored_median_reads_min | integer | Optional / conditional | Median reads of sponsored notes at least this | 1 … ∞ | — |
| GET | type | string | Optional / conditional | Creators mostly of image notes (image) or of video notes (video); both when left out | ["image","video"] | — |
| GET | category | string | Optional / conditional | Content category, top or second level (such as 护肤 or 面部保养), in PGY's own words; only a value of its dictionary is taken, anything else is a 400 | — | — |
| GET | feature_tag | string | Optional / conditional | Content feature, top or second level (such as vlog or 探店), in PGY's own words; only a value of its dictionary is taken, anything else is a 400 | — | — |
| GET | persona | string | Optional / conditional | Persona, any level (such as 妈妈 or 职业身份), in PGY's own words; only a value of its dictionary is taken, anything else is a 400 | — | — |
| GET | location | string | Optional / conditional | Where the creator is, a province or a city (such as 上海 or 杭州), in PGY's own words; only a value of its dictionary is taken, anything else is a 400 | — | — |
| GET | gender | string | Optional / conditional | The creator's gender: female or male | ["female","male"] | — |
| GET | audience_gender | string | Optional / conditional | Creators whose followers are mostly women (female) or men (male) | ["female","male"] | — |
| GET | audience_age | string | Optional / conditional | The age band most of the followers are in: under_18, 18_24, 25_34, 35_44, over_44 | ["under_18","18_24","25_34","35_44","over_44"] | — |
| GET | industry | string | Optional / conditional | Creators who worked with this industry lately: beauty, food_drink, mother_baby, electronics, household, fashion, internet, local_services, home_building, auto | ["beauty","food_drink","mother_baby","electronics","household","fashion","internet","local_services","home_building","auto"] | — |
| GET | exclude | string | Optional / conditional | Creators to leave out: low_active, the inactive; follower_drop, those losing followers; both | ["low_active","follower_drop","both"] | — |
| GET | cursor | string | Optional / conditional | The `next_cursor` of the previous page. A new page is a new call. | — | — |
| GET | view | string | Optional / conditional | How much of each item: compact (the most used fields, long text cut short), standard, or full (adds `ext`). | ["compact","standard","full"] | — |
| GET | fields | array | Optional / conditional | Return only these fields of each item, by path (`author.name`). | maxItems: 64 | — |
Complete one verification
Run one local fixture for a listed capability and inspect the object structure. Then filter, classify or export according to the question. A local sample cannot replace evidence for a real-platform conclusion.
{
"capability": "xiaohongshu.pgy.creators.search",
"method": "GET",
"params": {}
}Clear inputs. Inspectable output.
Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.
Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.
Download contract example (no execution) ↗For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗