Skip to main content

GET /v1/xiaohongshu_pgy/user/solar_cooperator_blogger_v2_v1

Xiaohongshu Creator Marketplace Creator Search API (V1)

stable · 30 credits per success

Search Xiaohongshu creator-marketplace creators using keyword, audience, location, content, pricing, performance, collaboration, livestream and similarity filters. Use it to build a campaign creator shortlist.

Sign up for 500 credits and run with your own API key. Sign up free

Request

curl
curl -s 'https://api.wellbyte.net/v1/xiaohongshu_pgy/user/solar_cooperator_blogger_v2_v1?page=1&sort=FANS&gender=ALL&fansAge=ALL&keyword=%E5%92%96%E5%95%A1&industry=BEAUTY_PERSONAL_CARE_BEAUTY&location=demo&noteType=ALL&fansNumUp=false&notePrice=demo&tradeType=demo&avgAgmv90d=demo&contentTag=demo&fansGender=ALL&searchType=NICKNAME&videoPrice=demo&featureTags=demo&kliveCnt30d=demo&mCpuvNum30d=demo&similarWord=demo&fansLocation=demo&marketTarget=demo&personalTags=demo&readMidNor30=demo&audienceGroup=demo&interMidNor30=demo&readMidCoop30=demo&similarUserId=demo&interMidCoop30=demo&estimateCpuv30d=demo&fansNumberLower=0&fansNumberUpper=0&avgLiveViewerNum=demo&estimateVideoCpm=demo&excludeLowActive=false&fansChildAgeInfo=demo&progressOrderCnt=demo&top20CrowdsLabel=demo&contentSceneLabel=demo&contentThemeLabel=demo&estimatePictureCpm=demo&tradeReportBrandIds=demo&estimatePicReadPrice=demo&thousandLikePercent30=demo&estimateVideoReadPrice=demo&inviteReply48hNumRatio=demo&accumCoopImpMedinNum30d=demo&estimateVideoEngageCost=demo&accumCommonImpMedinNum30d=demo&estimatePictureEngageCost=demo&excludeTradeReportBrandIds=false&industrySpecificCrowdsMotorDom=demo' \
  -H "Authorization: Bearer dg_live_…"
Sign up free

Response

Sample captured 2026-09-23

data{
code:0
data{
kols[ 2 items ]
total:1470
trackId:"kolSearch_00fbc9950e0d451ba597c36cafd6b555"
resultType:2
highlightWords[ 0 items ]
redirect2NickSearch:false
}
meta{
endpoint:"xiaohongshu_pgy.user.solar_cooperator_blogger_v2_v1"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

History

Open full logs

No calls yet. Get one green run first, then switch to your own data.

    Request parameters

    NameTypeInRequiredDescriptionExample
    pageintegerqueryno页码。1
    sortstringqueryno创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用蒲公英智能排序。 可选值： - `DEFAULT`：平台默认智能排序 - `FANS`：按粉丝数降序排序FANS
    genderstringquerynoKOL的性别。 可选值： - `ALL`: 所有性别 - `MALE`: 男性 - `FEMALE`: 女性ALL
    fansAgestringqueryno目标粉丝年龄群体。 可用值： - `ALL`: 所有年龄段 - `LT_18`: 18岁以下 - `AGE_18_24`: 18至24岁 - `AGE_25_34`: 25至34岁 - `AGE_35_44`: 35至44岁 - `GT…ALL
    keywordstringqueryno搜索关键词。咖啡
    industrystringqueryno蒲公英行业预设，用于行业助手风格的创作者推荐。 可用值： - `BEAUTY_PERSONAL_CARE_BEAUTY`：美妆个护 - 美妆 - `BEAUTY_PERSONAL_CARE_SKINCARE`：美妆个护 - 护肤 - `…BEAUTY_PERSONAL_CARE_BEAUTY
    locationstringqueryno创作者所在地筛选。传入蒲公英所在地标签，用英文或中文逗号分隔。支持国家、中国省份或地区、城市级路径以及区县级路径。中国省份或地区的短标签会被规范化为完整的蒲公英值。仅接受蒲公英所在地树中存在的路径。诸如 `河北 秦皇岛`、`山西 长治 潞…demo
    noteTypestringqueryno笔记类型筛选。值：ALL=所有笔记类型，PHOTO_TEXT=图文笔记为主，VIDEO=视频笔记为主。 可用值： - `ALL`：所有笔记类型 - `PHOTO_TEXT`：图文笔记为主 - `VIDEO`：视频笔记为主ALL
    fansNumUpbooleanqueryno是否排除粉丝数下降的博主。false
    notePricestringqueryno图文合作报价范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。demo
    tradeTypestringqueryno来自蒲公英的近期合作行业筛选。demo
    avgAgmv90dstringqueryno平均直播销售额范围。传入两个逗号分隔的数值边界。demo
    contentTagstringqueryno内容分类筛选。传入蒲公英一级或二级分类标签，用逗号分隔。 可选值： - 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他 - 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他 - 个人护理: 头发产品…demo
    fansGenderstringqueryno目标粉丝性别。 可用值： - `ALL`: 所有性别 - `MALE_HIGH`: 主要男性 - `FE_MALE_HIGH`: 主要女性ALL
    searchTypestringqueryno搜索条件类型。 可用值： - `NICKNAME`：按昵称搜索 - `NOTE`：按备注内容搜索NICKNAME
    videoPricestringqueryno视频合作报价范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。demo
    featureTagsstringqueryno擅长内容标签筛选。传入标签值，用逗号分隔。demo
    kliveCnt30dstringqueryno近30天直播次数范围。传入两个逗号分隔的数值边界。demo
    mCpuvNum30dstringqueryno合作笔记外站中位数范围。传入两个逗号分隔的数值边界。demo
    similarWordstringqueryno蒲公英显示的相似创作者关键词。`similarUserId` 和 `similarWord` 必须同时提供。demo
    fansLocationstringqueryno粉丝受众所在地筛选。传入蒲公英粉丝地区标签，用英文或中文逗号分隔。支持国家、中国省份和城市级路径；不接受区县级路径。仅接受蒲公英粉丝地区树中存在的路径。使用城市路径，如 `福建 南平`、`福建-南平` 或 `中国 福建 南平`；它们会被规…demo
    marketTargetstringqueryno营销目标筛选。传入一个蒲公英营销目标值。 可选值： - estimateAllCpm：曝光 - 曝光表现 - 成本 - mAccumImpNum：曝光 - 曝光表现 - 规模 - readCost：曝光 - 阅读表现 - 成本 - mV…demo
    personalTagsstringqueryno博主人物标签筛选。传入一个或多个蒲公英人物标签，用英文或中文逗号分隔。 可选值： - 妈妈 - 萌娃 - 爸爸 - 奶奶 - 情侣 - 夫妻 - 家庭 - 闺蜜 - 兄弟 - 备孕中 - 孕期中 - 12岁以上 - 传统行业 - 互联网…demo
    readMidNor30stringqueryno日常笔记阅读量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。demo
    audienceGroupstringqueryno受众定向筛选。传入用英文或中文逗号分隔的蒲公英受众组ID（`dmpGroupId`）。这些ID是动态且与账户相关的，因此没有固定的全局值列表。使用蒲公英受众管理中显示的受众组名称来理解每个ID的含义。demo
    interMidNor30stringqueryno日常笔记互动量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。demo
    readMidCoop30stringqueryno合作笔记阅读量中位数范围。传入两个逗号分隔的数值边界。demo
    similarUserIdstringqueryno相似创作者用户ID。`similarUserId` 和 `similarWord` 必须同时提供。demo
    interMidCoop30stringqueryno合作笔记互动量中位数范围。传入两个逗号分隔的数值边界。demo
    estimateCpuv30dstringqueryno预估外店访问单价范围。传入两个逗号分隔的数值边界。demo
    fansNumberLowerintegerqueryno最低粉丝数。0
    fansNumberUpperintegerqueryno最大粉丝数。0
    avgLiveViewerNumstringqueryno平均直播观看人数范围。传入两个逗号分隔的数值边界。demo
    estimateVideoCpmstringqueryno预估视频CPM范围。传入两个逗号分隔的数值边界。demo
    excludeLowActivebooleanqueryno是否排除低活跃度博主。false
    fansChildAgeInfostringqueryno母婴人群阶段筛选。传入蒲公英标签或数字编码，用英文或中文逗号分隔。 可选值： - 1: 备孕 - 2: 0-6月 - 3: 7-12月 - 4: 1-3岁 - 5: 4-6岁 - 6: 7-12岁 - 7: 孕早期 - 8: 孕晚期demo
    progressOrderCntstringqueryno当前合作订单数量范围。传入两个逗号分隔的数值边界。demo
    top20CrowdsLabelstringquerynoTop-20受众筛选。传入一级或子级受众标签，用逗号分隔；子级标签会转换为蒲公英请求值。demo
    contentSceneLabelstringqueryno内容场景标签筛选。传入完整的蒲公英笔记分类场景标签路径，用英文或中文逗号分隔。 可选值： - 汽车 理性决策 选车攻略 政策 - 汽车 理性决策 选车攻略 购车顾虑 - 汽车 理性决策 选车攻略 配置 - 汽车 理性决策 选车攻略 能源…demo
    contentThemeLabelstringqueryno内容主题筛选。传入蒲公英值ID或标签值，用逗号分隔；标签会转换为值ID。demo
    estimatePictureCpmstringqueryno预估图文CPM范围。传入两个逗号分隔的数值边界。demo
    tradeReportBrandIdsstringqueryno近期合作品牌ID，以英文或中文逗号分隔。demo
    estimatePicReadPricestringqueryno预估图文阅读单价范围。传入两个逗号分隔的数值边界。demo
    thousandLikePercent30stringqueryno千赞笔记比例范围。传入小数比例如 0.4,null 或百分比值如 40,null。demo
    estimateVideoReadPricestringqueryno预估视频阅读单价范围。传入两个逗号分隔的数值边界。demo
    inviteReply48hNumRatiostringqueryno48小时邀约回复率范围。传入小数比例如 0.9,0.95 或百分比值如 90,95。demo
    accumCoopImpMedinNum30dstringqueryno合作笔记曝光量中位数范围。传入两个逗号分隔的数值边界。demo
    estimateVideoEngageCoststringqueryno预估视频互动单价范围。传入两个逗号分隔的数值边界。demo
    accumCommonImpMedinNum30dstringqueryno日常笔记曝光量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。demo
    estimatePictureEngageCoststringqueryno预估图文互动单价范围。传入两个逗号分隔的数值边界。demo
    excludeTradeReportBrandIdsbooleanqueryno是否排除与所选近期合作品牌合作过的创作者。false
    industrySpecificCrowdsMotorDomstringqueryno行业画像筛选。传入蒲公英画像值ID或标签值，用逗号分隔。demo

    Response fields

    Field dictionary coming soon — the executable panel shows the live shape.

    Errors

    codeHTTPMeaningBilled
    40001400Invalid parametersno
    40102401Invalid or revoked API Keyno
    40201402Insufficient creditsno
    40402404Resource not foundno
    42201422Quality gate failedno
    42901429Rate limit exceededno
    50401504Upstream timeoutno
    50201502Upstream errorno

    Billing

    Success costs 30 credits. Any failure — including a 200 that fails the quality gate — costs 0.

    More Xiaohongshu Creator Marketplace endpoints

    All Xiaohongshu Creator Marketplace endpoints →

    Search

    Search endpoints and docs