Just One APIPugongyingAdvertising

Search Pugongying creators by keyword, audience, and price

justoneapi.x.xiaohongshu-pgysolar-cooperator-blogger-v2-v1

Search Xiaohongshu Pugongying creators with keyword, audience, location, content, pricing, performance, cooperation, live, and similarity filters.

Price
$0.0738/successAt list price
Success rate
—No success-rate data yetNo success-rate data yet
Latency p50
——
Last verified
Jul 28, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-pgysolar-cooperator-blogger-v2-v1?page=1&sort=FANS&gender=ALL&fansAge=ALL&keyword=coffee&location=%E6%B5%99%E6%B1%9F+%E5%AE%81%E6%B3%A2+%E6%85%88%E6%BA%AA%E5%B8%82&noteType=ALL&tradeType=3c%E5%8F%8A%E7%94%B5%E5%99%A8+%E9%A3%9F%E5%93%81%E9%A5%AE%E6%96%99+%E6%9C%8D%E8%A3%85%E9%85%8D%E9%A5%B0+%E9%A4%90%E9%A5%AE+%E4%BA%92%E8%81%94%E7%BD%91&contentTag=%E7%BE%8E%E9%A3%9F&fansGender=ALL&searchType=NICKNAMEBeta
  • Uses platform quota
  • Synchronous response
  • Reads public data

Parameters

ParameterTypeRequiredDescriptionExample
Query parameters
pageintegerOptionalPage number.1
sortstringOptionalCreator 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.FANS
genderstringOptionalKOL's gender. Available Values: - `ALL`: All genders - `MALE`: Male - `FEMALE`: Female One of: ALL, MALE, FEMALE.ALL
fansAgestringOptionalTarget 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.ALL
keywordstringOptionalSearch keyword.coffee
industrystringOptionalPugongying 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_HEALTH_FOOD, FOOD_BEVERAGE_DAIRY, FOOD_BEVERAGE_ALCOHOL, FOOD_BEVERAGE_GRAINS_OIL, FOOD_BEVERAGE_CROSS_BORDER_FOOD, FOOD_BEVERAGE_FRESH_FOOD.
locationstringOptionalCreator 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浙江 宁波 慈溪市
noteTypestringOptionalNote 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.ALL
fansNumUpbooleanOptionalWhether to exclude bloggers whose fan count is dropping.
notePricestringOptionalPhoto-text cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
tradeTypestringOptionalRecent cooperation industry filter from Pugongying.3c及电器 食品饮料 服装配饰 餐饮 互联网
avgAgmv90dstringOptionalAverage live sales amount range. Pass two comma-separated numeric bounds.
contentTagstringOptionalContent category filter. Pass first-level or second-level category labels from Pugongying, separated by commas. Available values: - 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他 - 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他 - 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他 - 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才美食
fansGenderstringOptionalTarget fans gender. Available Values: - `ALL`: All genders - `MALE_HIGH`: Mainly Male - `FE_MALE_HIGH`: Mainly Female One of: ALL, MALE_HIGH, FE_MALE_HIGH.ALL
searchTypestringOptionalSearch criteria type. Available Values: - `NICKNAME`: Search by nickname - `NOTE`: Search by note content One of: NICKNAME, NOTE.NICKNAME
videoPricestringOptionalVideo cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
featureTagsstringOptionalGood-at content tag filter. Pass label values separated by commas.
kliveCnt30dstringOptionalLive count in the last 30 days range. Pass two comma-separated numeric bounds.
mCpuvNum30dstringOptionalCooperation note outer-store median range. Pass two comma-separated numeric bounds.
similarWordstringOptionalSimilar creator keyword shown by Pugongying. `similarUserId` and `similarWord` must be provided together.
fansLocationstringOptionalFollower 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
marketTargetstringOptionalMarketing 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 -
personalTagsstringOptionalBlogger persona tag filter. Pass one or more Pugongying persona labels separated by English or Chinese commas. Available values: - 妈妈 - 萌娃 - 爸爸 - 奶奶 - 情侣 - 夫妻 - 家庭 - 闺蜜 - 兄弟 - 备孕中 - 孕期中 - 12岁以上 - 传统行业 - 互联网 - 教育科研 - 金融法律 - 企业创业 - 时尚美妆 - 食品饮料 - 文化传媒 - 医疗健康 - 艺术设计 - 影视娱乐 - 运动健身 - 专业服务 - 工程师 - 销售 - HR
readMidNor30stringOptionalDaily note read median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
audienceGroupstringOptionalAudience 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.
interMidNor30stringOptionalDaily note interaction median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
readMidCoop30stringOptionalCooperation note read median range. Pass two comma-separated numeric bounds.
similarUserIdstringOptionalSimilar creator user ID. `similarUserId` and `similarWord` must be provided together.
interMidCoop30stringOptionalCooperation note interaction median range. Pass two comma-separated numeric bounds.
estimateCpuv30dstringOptionalEstimated outer-store visit unit price range. Pass two comma-separated numeric bounds.
fansNumberLowerintegerOptionalMinimum number of fans.
fansNumberUpperintegerOptionalMaximum number of fans.
avgLiveViewerNumstringOptionalAverage live viewer count range. Pass two comma-separated numeric bounds.
estimateVideoCpmstringOptionalEstimated video CPM range. Pass two comma-separated numeric bounds.
excludeLowActivebooleanOptionalWhether to exclude low-activity bloggers.
fansChildAgeInfostringOptionalMother-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: 孕晚期
progressOrderCntstringOptionalCurrent cooperation order count range. Pass two comma-separated numeric bounds.
top20CrowdsLabelstringOptionalTop-20 audience filter. Pass top-level or child audience labels separated by commas; child labels are converted to Pugongying request values.
contentSceneLabelstringOptionalContent scene label filter. Pass full Pugongying note category scene label paths separated by English or Chinese commas. Available values: - 汽车 理性决策 选车攻略 政策 - 汽车 理性决策 选车攻略 购车顾虑 - 汽车 理性决策 选车攻略 配置 - 汽车 理性决策 选车攻略 能源类型优势对比 - 汽车 理性决策 选车攻略 攻略 - 汽车 理性决策 新车测评 - 汽车 理性决策 探店试驾 - 汽车 理性决策 车主心得 - 汽车 用车场景 远行近游 近郊探
contentThemeLabelstringOptionalContent theme filter. Pass Pugongying value IDs or label values separated by commas; labels are converted to value IDs.
estimatePictureCpmstringOptionalEstimated photo-text CPM range. Pass two comma-separated numeric bounds.
tradeReportBrandIdsstringOptionalRecent cooperation brand IDs, separated by English or Chinese commas.
estimatePicReadPricestringOptionalEstimated photo-text read unit price range. Pass two comma-separated numeric bounds.
thousandLikePercent30stringOptionalThousand-like note ratio range. Pass fractional ratios such as 0.4,null or percentage values such as 40,null.
estimateVideoReadPricestringOptionalEstimated video read unit price range. Pass two comma-separated numeric bounds.
inviteReply48hNumRatiostringOptional48-hour invite reply ratio range. Pass fractional ratios such as 0.9,0.95 or percentage values such as 90,95.
accumCoopImpMedinNum30dstringOptionalCooperation note exposure median range. Pass two comma-separated numeric bounds.
estimateVideoEngageCoststringOptionalEstimated video engagement unit price range. Pass two comma-separated numeric bounds.
accumCommonImpMedinNum30dstringOptionalDaily note exposure median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.
estimatePictureEngageCoststringOptionalEstimated photo-text engagement unit price range. Pass two comma-separated numeric bounds.
excludeTradeReportBrandIdsbooleanOptionalWhether to exclude creators who cooperated with the selected recent cooperation brands.
industrySpecificCrowdsMotorDomstringOptionalIndustry-specific portrait filter. Pass Pugongying portrait value IDs or label values separated by commas.
  • Query parameters
  • pageintegerOptional

    Page number.

    Example: 1

  • sortstringOptional

    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.

    Example: FANS

  • genderstringOptional

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

    Example: ALL

  • fansAgestringOptional

    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.

    Example: ALL

  • keywordstringOptional

    Search keyword.

    Example: coffee

  • industrystringOptional

    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_HEALTH_FOOD, FOOD_BEVERAGE_DAIRY, FOOD_BEVERAGE_ALCOHOL, FOOD_BEVERAGE_GRAINS_OIL, FOOD_BEVERAGE_CROSS_BORDER_FOOD, FOOD_BEVERAGE_FRESH_FOOD.

  • locationstringOptional

    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

    Example: 浙江 宁波 慈溪市

  • noteTypestringOptional

    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.

    Example: ALL

  • fansNumUpbooleanOptional

    Whether to exclude bloggers whose fan count is dropping.

  • notePricestringOptional

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

  • tradeTypestringOptional

    Recent cooperation industry filter from Pugongying.

    Example: 3c及电器 食品饮料 服装配饰 餐饮 互联网

  • avgAgmv90dstringOptional

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

  • contentTagstringOptional

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

    Example: 美食

  • fansGenderstringOptional

    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.

    Example: ALL

  • searchTypestringOptional

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

    Example: NICKNAME

  • videoPricestringOptional

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

  • featureTagsstringOptional

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

  • kliveCnt30dstringOptional

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

  • mCpuvNum30dstringOptional

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

  • similarWordstringOptional

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

  • fansLocationstringOptional

    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

  • marketTargetstringOptional

    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 -

  • personalTagsstringOptional

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

  • readMidNor30stringOptional

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

  • audienceGroupstringOptional

    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.

  • interMidNor30stringOptional

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

  • readMidCoop30stringOptional

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

  • similarUserIdstringOptional

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

  • interMidCoop30stringOptional

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

  • estimateCpuv30dstringOptional

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

  • fansNumberLowerintegerOptional

    Minimum number of fans.

  • fansNumberUpperintegerOptional

    Maximum number of fans.

  • avgLiveViewerNumstringOptional

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

  • estimateVideoCpmstringOptional

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

  • excludeLowActivebooleanOptional

    Whether to exclude low-activity bloggers.

  • fansChildAgeInfostringOptional

    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: 孕晚期

  • progressOrderCntstringOptional

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

  • top20CrowdsLabelstringOptional

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

  • contentSceneLabelstringOptional

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

  • contentThemeLabelstringOptional

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

  • estimatePictureCpmstringOptional

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

  • tradeReportBrandIdsstringOptional

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

  • estimatePicReadPricestringOptional

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

  • thousandLikePercent30stringOptional

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

  • estimateVideoReadPricestringOptional

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

  • inviteReply48hNumRatiostringOptional

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

  • accumCoopImpMedinNum30dstringOptional

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

  • estimateVideoEngageCoststringOptional

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

  • accumCommonImpMedinNum30dstringOptional

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

  • estimatePictureEngageCoststringOptional

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

  • excludeTradeReportBrandIdsbooleanOptional

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

  • industrySpecificCrowdsMotorDomstringOptional

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

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Beta
curl -X GET 'https://toolswitch.dev/v1/tools/justoneapi.x.xiaohongshu-pgysolar-cooperator-blogger-v2-v1?page=1&sort=FANS&gender=ALL&fansAge=ALL&keyword=coffee&location=%E6%B5%99%E6%B1%9F+%E5%AE%81%E6%B3%A2+%E6%85%88%E6%BA%AA%E5%B8%82&noteType=ALL&tradeType=3c%E5%8F%8A%E7%94%B5%E5%99%A8+%E9%A3%9F%E5%93%81%E9%A5%AE%E6%96%99+%E6%9C%8D%E8%A3%85%E9%85%8D%E9%A5%B0+%E9%A4%90%E9%A5%AE+%E4%BA%92%E8%81%94%E7%BD%91&contentTag=%E7%BE%8E%E9%A3%9F&fansGender=ALL&searchType=NICKNAME' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

This gateway API is in beta; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.0738/success, including the service fee.