DataNavoAPI / ANSWERS / REDNOTE

How do I combine filters in a Pgy creator search?

How do I combine filters in a Pgy creator search? Follow concrete contracts, examples and reviewable steps using Xiaohongshu (RedNote).

LOCAL SIMULATIONAll displayed records are fictional fixtures. Live APIs, payments and external email are disabled.中文版 ↗
01

Answer

Start by inspecting the contracts and local samples for Xiaohongshu PGY creator search. 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.

02

Relevant contracts

CapabilityObjectShapePagination
xiaohongshu.pgy.creators.searchCreatoritemsExplicit cursor
03

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.
MethodFieldTypeRequirementMeaningEnum or boundExample
GETquerystringOptional / conditionalSearch 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——
GETsortstringOptional / conditionalOrder: 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"]—
GETfollowers_minintegerOptional / conditionalAt least this many followers1 … ∞—
GETfollowers_maxintegerOptional / conditionalAt most this many followers1 … ∞—
GETrate_minintegerOptional / conditionalRate at least this, in yuan: of an image note, or of a video note with type=video1 … ∞—
GETrate_maxintegerOptional / conditionalRate at most this, in yuan: of an image note, or of a video note with type=video1 … ∞—
GETcpm_minintegerOptional / conditionalEstimated CPM at least this, in yuan: of an image note, or of a video note with type=video1 … ∞—
GETcpm_maxintegerOptional / conditionalEstimated CPM at most this, in yuan: of an image note, or of a video note with type=video1 … ∞—
GETmedian_reads_minintegerOptional / conditionalMedian reads of everyday notes at least this1 … ∞—
GETmedian_engagements_minintegerOptional / conditionalMedian interactions of everyday notes at least this1 … ∞—
GETsponsored_median_reads_minintegerOptional / conditionalMedian reads of sponsored notes at least this1 … ∞—
GETtypestringOptional / conditionalCreators mostly of image notes (image) or of video notes (video); both when left out["image","video"]—
GETcategorystringOptional / conditionalContent 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——
GETfeature_tagstringOptional / conditionalContent 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——
GETpersonastringOptional / conditionalPersona, any level (such as 妈妈 or 职业身份), in PGY's own words; only a value of its dictionary is taken, anything else is a 400——
GETlocationstringOptional / conditionalWhere 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——
GETgenderstringOptional / conditionalThe creator's gender: female or male["female","male"]—
GETaudience_genderstringOptional / conditionalCreators whose followers are mostly women (female) or men (male)["female","male"]—
GETaudience_agestringOptional / conditionalThe 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"]—
GETindustrystringOptional / conditionalCreators 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"]—
GETexcludestringOptional / conditionalCreators to leave out: low_active, the inactive; follower_drop, those losing followers; both["low_active","follower_drop","both"]—
GETcursorstringOptional / conditionalThe `next_cursor` of the previous page. A new page is a new call.——
GETviewstringOptional / conditionalHow much of each item: compact (the most used fields, long text cut short), standard, or full (adds `ext`).["compact","standard","full"]—
GETfieldsarrayOptional / conditionalReturn only these fields of each item, by path (`author.name`).maxItems: 64—
04

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.

json
{
  "capability": "xiaohongshu.pgy.creators.search",
  "method": "GET",
  "params": {}
}
TRY THE CONTRACT

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 ↗