joshu

Search Pugongying creators by keyword, audience, and price

From Just One API, through Joshu Data Bodega.

Part of Pugongying — Xiaohongshu's creator marketplace search creators.

Price
$0.081 per call

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

  • pageinteger, optional

    Page number.

  • sortstring: DEFAULT, FANS, optional

    Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Pugongying intelligent ranking. Available Values: - `DEFAULT`: Platform default intelligent ranking - `FANS`: Sort by follower count descending One of: DEFAULT, FANS.

  • genderstring: ALL, MALE, FEMALE, optional

    KOL's gender. Available Values: - `ALL`: All genders - `MALE`: Male - `FEMALE`: Female One of: ALL, MALE, FEMALE.

  • fansAgestring: ALL, LT_18, AGE_18_24, AGE_25_34, AGE_35_44, GT_44, optional

    Target fans age group. Available Values: - `ALL`: All ages - `LT_18`: Under 18 - `AGE_18_24`: 18 to 24 - `AGE_25_34`: 25 to 34 - `AGE_35_44`: 35 to 44 - `GT_44`: Above 44 One of: ALL, LT_18, AGE_18_24, AGE_25_34, AGE_35_44, GT_44.

  • keywordstring, optional

    Search keyword.

  • industrystring: BEAUTY_PERSONAL_CARE_BEAUTY, BEAUTY_PERSONAL_CARE_SKINCARE, BEAUTY_PERSONAL_CARE_PERSONAL_CARE, BEAUTY_PERSONAL_CARE_FRAGRANCE, FOOD_BEVERAGE_SNACKS, FOOD_BEVERAGE_DRINKS, FOOD_BEVERAGE_HEALTH_FOOD, FOOD_BEVERAGE_DAIRY, FOOD_BEVERAGE_ALCOHOL, FOOD_BEVERAGE_GRAINS_OIL, FOOD_BEVERAGE_CROSS_BORDER_FOOD, FOOD_BEVERAGE_FRESH_FOOD, FOOD_BEVERAGE_MEAL_REPLACEMENT, FOOD_BEVERAGE_TRADITIONAL_NOURISHMENT, MOTHER_BABY_SUPPLIES, MOTHER_BABY_FORMULA_FOOD, DIGITAL_APPLIANCES_HOME_APPLIANCES, DIGITAL_APPLIANCES_DIGITAL_PRODUCTS, DAILY_GOODS_HOUSEHOLD_DAILY_USE, DAILY_GOODS_PET_SUPPLIES_FOOD, DAILY_GOODS_OFFICE_SUPPLIES, APPAREL_ACCESSORIES_CLOTHING_SHOES_HATS, APPAREL_ACCESSORIES_JEWELRY, APPAREL_ACCESSORIES_BAGS_GLASSES, APPAREL_ACCESSORIES_SPORTS_OUTDOOR, APPAREL_ACCESSORIES_WATCHES, APPAREL_ACCESSORIES_SECOND_HAND_LUXURY, HOME_BUILDING_MATERIALS_HOME_DECOR, HOME_BUILDING_MATERIALS_FURNITURE, HOME_BUILDING_MATERIALS_MAIN_MATERIALS, AUTOMOTIVE, INTERNET_ECOMMERCE, INTERNET_SOFTWARE_TOOLS, HEALTHCARE_MEDICAL_DEVICES, HEALTHCARE_MEDICAL_BEAUTY, CULTURE_SPORTS_ENTERTAINMENT_SPORTS_GOODS, CULTURE_SPORTS_ENTERTAINMENT_STATIONERY_TOYS_GIFTS, CULTURE_SPORTS_ENTERTAINMENT_OUTDOOR_PRODUCTS, CULTURE_SPORTS_ENTERTAINMENT_ART_COLLECTIBLES, LIFE_SERVICES_OFFLINE_RETAIL, LIFE_SERVICES_BEAUTY_HAIR, CATERING_RESTAURANTS, CATERING_DRINKS_DESSERTS, BUSINESS_SERVICES, EDUCATION_TRAINING_LANGUAGE_STUDY_ABROAD, EDUCATION_TRAINING_VOCATIONAL_EDUCATION, EDUCATION_TRAINING_INTEREST_TRAINING, EDUCATION_TRAINING_K12_EDUCATION, EDUCATION_TRAINING_DEGREE_EDUCATION, EDUCATION_TRAINING_CORPORATE_DEVELOPMENT, EDUCATION_TRAINING_OTHER, GAMES, TRAVEL_TOURISM, optional

    Pugongying industry preset for industry assistant style creator recommendations. Available Values: - `BEAUTY_PERSONAL_CARE_BEAUTY`: Beauty and personal care - beauty - `BEAUTY_PERSONAL_CARE_SKINCARE`: Beauty and personal care - skincare - `BEAUTY_PERSONAL_CARE_PERSONAL_CARE`: Beauty and personal car One of: BEAUTY_PERSONAL_CARE_BEAUTY, BEAUTY_PERSONAL_CARE_SKINCARE, BEAUTY_PERSONAL_CARE_PERSONAL_CARE, BEAUTY_PERSONAL_CARE_FRAGRANCE, FOOD_BEVERAGE_SNACKS, FOOD_BEVERAGE_DRINKS, FOOD_BEVERAGE_HEALT

  • locationstring, optional

    Creator profile location filter. Pass Pugongying location labels separated by English or Chinese commas. Country, China province or region, city-level paths, and district/county-level paths are supported. China province or region short labels are normalized to the full Pugongying value. Only paths p

  • noteTypestring: ALL, PHOTO_TEXT, VIDEO, optional

    Note type filter. Values: ALL=all note types, PHOTO_TEXT=mainly photo-text notes, VIDEO=mainly video notes. Available Values: - `ALL`: All note types - `PHOTO_TEXT`: Mainly photo-text notes - `VIDEO`: Mainly video notes One of: ALL, PHOTO_TEXT, VIDEO.

  • fansNumUpboolean, optional

    Whether to exclude bloggers whose fan count is dropping.

  • notePricestring, optional

    Photo-text cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.

  • tradeTypestring, optional

    Recent cooperation industry filter from Pugongying.

  • avgAgmv90dstring, optional

    Average live sales amount range. Pass two comma-separated numeric bounds.

  • contentTagstring, optional

    Content category filter. Pass first-level or second-level category labels from Pugongying, separated by commas. Available values: - 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他 - 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他 - 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他 - 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才

  • fansGenderstring: ALL, MALE_HIGH, FE_MALE_HIGH, optional

    Target fans gender. Available Values: - `ALL`: All genders - `MALE_HIGH`: Mainly Male - `FE_MALE_HIGH`: Mainly Female One of: ALL, MALE_HIGH, FE_MALE_HIGH.

  • searchTypestring: NICKNAME, NOTE, optional

    Search criteria type. Available Values: - `NICKNAME`: Search by nickname - `NOTE`: Search by note content One of: NICKNAME, NOTE.

  • videoPricestring, optional

    Video cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.

  • featureTagsstring, optional

    Good-at content tag filter. Pass label values separated by commas.

  • kliveCnt30dstring, optional

    Live count in the last 30 days range. Pass two comma-separated numeric bounds.

  • mCpuvNum30dstring, optional

    Cooperation note outer-store median range. Pass two comma-separated numeric bounds.

  • similarWordstring, optional

    Similar creator keyword shown by Pugongying. `similarUserId` and `similarWord` must be provided together.

  • fansLocationstring, optional

    Follower audience location filter. Pass Pugongying follower-region labels separated by English or Chinese commas. Country, China province, and city-level paths are supported; district/county-level paths are not accepted. Only paths present in the Pugongying follower-region tree are accepted. Use cit

  • marketTargetstring, optional

    Marketing target filter. Pass one Pugongying marketing target value. Available values: - estimateAllCpm: Exposure - exposure performance - cost - mAccumImpNum: Exposure - exposure performance - scale - readCost: Exposure - read performance - cost - mValidRawReadFeedNum: Exposure - read performance -

  • personalTagsstring, optional

    Blogger persona tag filter. Pass one or more Pugongying persona labels separated by English or Chinese commas. Available values: - 妈妈 - 萌娃 - 爸爸 - 奶奶 - 情侣 - 夫妻 - 家庭 - 闺蜜 - 兄弟 - 备孕中 - 孕期中 - 12岁以上 - 传统行业 - 互联网 - 教育科研 - 金融法律 - 企业创业 - 时尚美妆 - 食品饮料 - 文化传媒 - 医疗健康 - 艺术设计 - 影视娱乐 - 运动健身 - 专业服务 - 工程师 - 销售 - HR

  • readMidNor30string, optional

    Daily note read median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.

  • audienceGroupstring, optional

    Audience target filter. Pass Pugongying audience group IDs (`dmpGroupId`) separated by English or Chinese commas. These IDs are dynamic and account-specific, so there is no fixed global value list. Use the audience group name shown in Pugongying Audience Management to identify what each ID means.

  • interMidNor30string, optional

    Daily note interaction median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.

  • readMidCoop30string, optional

    Cooperation note read median range. Pass two comma-separated numeric bounds.

  • similarUserIdstring, optional

    Similar creator user ID. `similarUserId` and `similarWord` must be provided together.

  • interMidCoop30string, optional

    Cooperation note interaction median range. Pass two comma-separated numeric bounds.

  • estimateCpuv30dstring, optional

    Estimated outer-store visit unit price range. Pass two comma-separated numeric bounds.

  • fansNumberLowerinteger, optional

    Minimum number of fans.

  • fansNumberUpperinteger, optional

    Maximum number of fans.

  • avgLiveViewerNumstring, optional

    Average live viewer count range. Pass two comma-separated numeric bounds.

  • estimateVideoCpmstring, optional

    Estimated video CPM range. Pass two comma-separated numeric bounds.

  • excludeLowActiveboolean, optional

    Whether to exclude low-activity bloggers.

  • fansChildAgeInfostring, optional

    Mother-and-baby audience stage filter. Pass Pugongying labels or numeric codes separated by English or Chinese commas. Available values: - 1: 备孕 - 2: 0-6月 - 3: 7-12月 - 4: 1-3岁 - 5: 4-6岁 - 6: 7-12岁 - 7: 孕早期 - 8: 孕晚期

  • progressOrderCntstring, optional

    Current cooperation order count range. Pass two comma-separated numeric bounds.

  • top20CrowdsLabelstring, optional

    Top-20 audience filter. Pass top-level or child audience labels separated by commas; child labels are converted to Pugongying request values.

  • contentSceneLabelstring, optional

    Content scene label filter. Pass full Pugongying note category scene label paths separated by English or Chinese commas. Available values: - 汽车 理性决策 选车攻略 政策 - 汽车 理性决策 选车攻略 购车顾虑 - 汽车 理性决策 选车攻略 配置 - 汽车 理性决策 选车攻略 能源类型优势对比 - 汽车 理性决策 选车攻略 攻略 - 汽车 理性决策 新车测评 - 汽车 理性决策 探店试驾 - 汽车 理性决策 车主心得 - 汽车 用车场景 远行近游 近郊探

  • contentThemeLabelstring, optional

    Content theme filter. Pass Pugongying value IDs or label values separated by commas; labels are converted to value IDs.

  • estimatePictureCpmstring, optional

    Estimated photo-text CPM range. Pass two comma-separated numeric bounds.

  • tradeReportBrandIdsstring, optional

    Recent cooperation brand IDs, separated by English or Chinese commas.

  • estimatePicReadPricestring, optional

    Estimated photo-text read unit price range. Pass two comma-separated numeric bounds.

  • thousandLikePercent30string, optional

    Thousand-like note ratio range. Pass fractional ratios such as 0.4,null or percentage values such as 40,null.

  • estimateVideoReadPricestring, optional

    Estimated video read unit price range. Pass two comma-separated numeric bounds.

  • inviteReply48hNumRatiostring, optional

    48-hour invite reply ratio range. Pass fractional ratios such as 0.9,0.95 or percentage values such as 90,95.

  • accumCoopImpMedinNum30dstring, optional

    Cooperation note exposure median range. Pass two comma-separated numeric bounds.

  • estimateVideoEngageCoststring, optional

    Estimated video engagement unit price range. Pass two comma-separated numeric bounds.

  • accumCommonImpMedinNum30dstring, optional

    Daily note exposure median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.

  • estimatePictureEngageCoststring, optional

    Estimated photo-text engagement unit price range. Pass two comma-separated numeric bounds.

  • excludeTradeReportBrandIdsboolean, optional

    Whether to exclude creators who cooperated with the selected recent cooperation brands.

  • industrySpecificCrowdsMotorDomstring, optional

    Industry-specific portrait filter. Pass Pugongying portrait value IDs or label values separated by commas.

Call it

Router call with a router API key
curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "justoneapi.x.xiaohongshu-pgysolar-cooperator-blogger-v2-v1",
    "params": {
      "page": "1",
      "sort": "FANS",
      "gender": "ALL",
      "fansAge": "ALL",
      "keyword": "coffee",
      "location": "浙江 宁波 慈溪市",
      "noteType": "ALL",
      "tradeType": "3c及电器 食品饮料 服装配饰 餐饮 互联网",
      "contentTag": "美食",
      "fansGender": "ALL",
      "searchType": "NICKNAME"
    }
  }'