Xiaohongshu Pgy Creator Search
87.31 credits/call
ae_xiaohongshu_pgy_creator_search
通过关键词、受众画像、内容类目、互动表现、合作报价等多维度筛选小红书蒲公英创作者,助力品牌营销选人与建联。参数请放在必填的 request_body 对象中。支持 blogger、fans、note、coop、live、goal、flags 嵌套筛选;按当前参数 Schema 填写。
87.31 credits/call
Pricing
87.31 credits/call
| Condition | Charge |
|---|---|
| Each call | 87.31 credits/call |
Each call has a fixed fee of 87.31 credits.
The fee applies when a creator search request succeeds, including when no matching creators are returned.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.coop | object | null | No | 合作笔记数据筛选/Sponsored note metric filters | — |
request_body.coop.cpuv | object | null | No | 「传播规模」进店 UV 中位数:近 30 日跨域合作笔记的进店 UV 量中位数。**这是次数不是金额**(网页档位 500~1000 / 1000~2000 / 2000~5000 / 5000~10000 / 1万以上);想按「每次进店花多少钱」筛请用 estimate_cpuv/Median store-visit UV COUNT (not cost). For cost use estimate_cpuv | — |
request_body.coop.cpuv.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.cpuv.min | number | null | No | 最小值(含) | — |
request_body.coop.pic_cpm | object | null | No | 「预估CPM」图文 | — |
request_body.coop.pic_cpm.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.pic_cpm.min | number | null | No | 最小值(含) | — |
request_body.coop.industry | string | null | No | 「近期合作行业」 | — |
request_body.coop.brand_ids | array | null | No | 「近期合作品牌」:品牌 userId 列表 | — |
request_body.coop.pic_price | object | null | No | 「合作报价」图文笔记一口价(元) | — |
request_body.coop.pic_price.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.pic_price.min | number | null | No | 最小值(含) | — |
request_body.coop.video_cpm | object | null | No | 「预估CPM」视频 | — |
request_body.coop.video_cpm.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.video_cpm.min | number | null | No | 最小值(含) | — |
request_body.coop.imp_median | object | null | No | 「传播规模」曝光中位数(合作笔记) | — |
request_body.coop.imp_median.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.imp_median.min | number | null | No | 最小值(含) | — |
request_body.coop.order_count | object | null | No | 「合作订单数」:博主**已接受、尚未完成**的订单数量(单)。注意这是**在手订单**,不是历史累计合作数 —— 想找经验丰富的博主不该用它/Open (accepted but unfinished) orders, NOT lifetime collaboration count | — |
request_body.coop.order_count.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.order_count.min | number | null | No | 最小值(含) | — |
request_body.coop.read_median | object | null | No | 「传播规模」阅读中位数(合作笔记) | — |
request_body.coop.read_median.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.read_median.min | number | null | No | 最小值(含) | — |
request_body.coop.video_price | object | null | No | 「合作报价」视频笔记一口价(元) | — |
request_body.coop.video_price.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.video_price.min | number | null | No | 最小值(含) | — |
request_body.coop.inter_median | object | null | No | 「传播规模」互动中位数(合作笔记) | — |
request_body.coop.inter_median.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.inter_median.min | number | null | No | 最小值(含) | — |
request_body.coop.estimate_cpuv | object | null | No | 「外溢进店单价」 | — |
request_body.coop.estimate_cpuv.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.estimate_cpuv.min | number | null | No | 最小值(含) | — |
request_body.coop.exclude_brands | boolean | null | No | 配合 brand_ids:true=排除与这些品牌合作过的博主 | — |
request_body.coop.pic_read_price | object | null | No | 「预估阅读单价」图文 | — |
request_body.coop.pic_read_price.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.pic_read_price.min | number | null | No | 最小值(含) | — |
request_body.coop.pic_engage_cost | object | null | No | 「预估互动单价」图文 | — |
request_body.coop.pic_engage_cost.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.pic_engage_cost.min | number | null | No | 最小值(含) | — |
request_body.coop.reply_48h_ratio | object | null | No | 「合作信用度」48h 邀约回复率:按 0~100 的百分点填,`80` 表示 80%/48h invitation reply rate, fill 0-100 percent points | — |
request_body.coop.reply_48h_ratio.max | number | null | No | 最大值(含),百分点 0~100/Max percent 0-100 | — |
request_body.coop.reply_48h_ratio.min | number | null | No | 最小值(含),百分点 0~100/Min percent 0-100 | — |
request_body.coop.video_read_price | object | null | No | 「预估阅读单价」视频 | — |
request_body.coop.video_read_price.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.video_read_price.min | number | null | No | 最小值(含) | — |
request_body.coop.video_engage_cost | object | null | No | 「预估互动单价」视频 | — |
request_body.coop.video_engage_cost.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.coop.video_engage_cost.min | number | null | No | 最小值(含) | — |
request_body.fans | object | null | No | 粉丝画像筛选/Fans profile filters | — |
request_body.fans.age | integer | null | No | 「粉丝年龄」:0=不限 1=<18 2=18~24 3=25~34 4=35~44 5=>44 占比高 | — |
request_body.fans.count | object | null | No | 「粉丝量」区间 | — |
request_body.fans.count.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.fans.count.min | number | null | No | 最小值(含) | — |
request_body.fans.gender | integer | null | No | 「粉丝性别」:0=不限 1=男性占比高 2=女性占比高 | — |
request_body.fans.location | array | null | No | 「粉丝地域」:粉丝所在地。**直接填地名即可**(["上海"]、["杭州"]),上游会自动补成完整路径。也可以自己填完整路径 "中国 浙江 杭州"。注意这棵树**只到市**(没有区县),可选地名见 /get_blogger_filter_options 的 **fansAreas**/Fans location: plain place names work; this tree only goes down to city level | — |
request_body.fans.child_age | array | null | No | 「母婴阶段」:0=备孕 2=0-6月 3=7-12月 4=1-3岁 5=4-6岁 6=7-12岁 7=孕早期 8=孕晚期 | — |
request_body.fans.device_brand | array | null | No | 「手机品牌」 | — |
request_body.fans.device_price | array | null | No | 「手机价格」档位,如 3000-3999 / 8000+ | — |
request_body.fans.marital_status | integer | null | No | 「婚恋状态」:-1=不限 0=未婚 1=已婚 | — |
request_body.fans.consumption_level | integer | null | No | 「消费水平」:-1=不限 0=低消费 1=中消费 2=高消费 | — |
request_body.goal | object | null | No | 合作目标筛选/Cooperation goal filters | — |
request_body.goal.market_target | string | null | No | 「营销目标」:网页上是三级选择(目标 → 指标 → 统计方式),填最终叶子码 —— `estimateAllCpm` 曝光/曝光表现/成本、`mAccumImpNum` 曝光/曝光表现/规模、`readCost` 曝光/阅读表现/成本、`mValidRawReadFeedNum` 曝光/阅读表现/规模、`estimateEngageCost` 种草/互动表现/成本、`mEngagementNum90d` 种草/互动表现/规模、`estimateCpuv` 转化/外溢进店表现/成本、`mCpuvNum` 转化/外溢进店表现/规模 | — |
request_body.live | object | null | No | 直播数据筛选/Live metric filters | — |
request_body.live.avg_gmv | object | null | No | 「场均销售额」:博主**近 90 天**直播的场均销售额(元)。统计窗口同样是 90 天,与 live_count(30 天)不同/Avg GMV per live over the last **90 days** (live_count uses 30 days) | — |
request_body.live.avg_gmv.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.live.avg_gmv.min | number | null | No | 最小值(含) | — |
request_body.live.avg_viewer | object | null | No | 「场均观播人数」:博主**近 90 天**直播的场均观播人数(人)。注意统计窗口是 90 天,与 live_count(30 天)不同/Avg viewers per live over the last **90 days** (live_count uses 30 days) | — |
request_body.live.avg_viewer.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.live.avg_viewer.min | number | null | No | 最小值(含) | — |
request_body.live.live_count | object | null | No | 「近30天直播场次」 | — |
request_body.live.live_count.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.live.live_count.min | number | null | No | 最小值(含) | — |
request_body.note | object | null | No | 日常笔记数据筛选/Organic note metric filters | — |
request_body.note.note_type | integer | null | No | 「笔记类型」:0=不限 1=图文笔记为主 2=视频笔记为主 | — |
request_body.note.imp_median | object | null | No | 「曝光中位数」 | — |
request_body.note.imp_median.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.note.imp_median.min | number | null | No | 最小值(含) | — |
request_body.note.read_median | object | null | No | 「阅读中位数」 | — |
request_body.note.read_median.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.note.read_median.min | number | null | No | 最小值(含) | — |
request_body.note.inter_median | object | null | No | 「互动中位数」 | — |
request_body.note.inter_median.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.note.inter_median.min | number | null | No | 最小值(含) | — |
request_body.note.thousand_like_percent | object | null | No | 「千赞笔记比例」:按 0~100 的百分点填,`20` 表示 20%(**不是 0.2**)/1000-like note ratio, fill 0-100 percent points (20 means 20%) | — |
request_body.note.thousand_like_percent.max | number | null | No | 最大值(含),百分点 0~100/Max percent 0-100 | — |
request_body.note.thousand_like_percent.min | number | null | No | 最小值(含),百分点 0~100/Min percent 0-100 | — |
request_body.sort | enum (desc | asc) | No | 排序方向 desc/asc | desc |
request_body.flags | object | null | No | 开关类筛选/Boolean flag filters | — |
request_body.flags.is_star | boolean | null | No | 「明星」 | — |
request_body.flags.high_quality | boolean | null | No | 「优质博主」 | — |
request_body.flags.note_and_live | boolean | null | No | 「笔记+直播均可合作」 | — |
request_body.flags.activity_codes | array | null | No | 「热门活动」:填 `/blogger/filter-options` 里 activities 每项的 code | — |
request_body.flags.industry_first | string | null | No | 「行业推荐博主」一级行业名(如 美妆个护);平台会按该行业推荐专属博主 | — |
request_body.flags.exclude_invited | boolean | null | No | 「剔除已邀约博主」 | — |
request_body.flags.industry_second | string | null | No | 「行业推荐博主」二级行业名(配合 industry_first,取 `/blogger/filter-options` 里 industryTags 的 taxonomy2Tags) | — |
request_body.flags.filter_intention | boolean | null | No | 「意向行业匹配」 | — |
request_body.flags.new_high_quality | boolean | null | No | 「新锐博主」 | — |
request_body.flags.exclude_fans_down | boolean | null | No | 「剔除掉粉博主」 | — |
request_body.flags.exclude_cooperated | boolean | null | No | 「剔除已合作博主」 | — |
request_body.flags.exclude_low_active | boolean | null | No | 「剔除低活博主」 | — |
request_body.column | enum (comprehensiverank | fansCount | price | clickNum | mEngagementNum | accumCommonImpMedinNum30d | accumPicCommonImpMedinNum30d | accumVideoCommonImpMedinNum30d | pictureClickMidNum | videoClickMidNum | pictureInterMidNum | videoInterMidNum | thousandLikePercent30 | pictureThousandLikePercent30 | videoThousandLikePercent30 | hundredLikePercent30 | pictureHundredLikePercent30 | videoHundredLikePercent30 | videoFinishRate | accumCoopImpMedinNum30d | readMidCoop30 | interMidCoop30 | mCpuvNum30d | picturePrice | videoPrice | pictureReadCost | videoReadCost | inviteReply48hNumRatio | fans30GrowthRate | fansActiveIn28dLv | fansEngageNum30dLv | kliveCnt30d | avgLiveViewerNum | avgAgmv90d) | No | 排序字段,共 34 个,见接口说明的排序字段表/Sort column, 34 options, see endpoint docs | comprehensiverank |
request_body.blogger | object | null | No | 博主属性筛选/Blogger attribute filters | — |
request_body.blogger.gender | string | null | No | 「性别」:男 / 女(填中文,不是数字) | — |
request_body.blogger.signed | integer | null | No | 「签约情况」:-1=不限 0=个人博主 1=机构博主 | — |
request_body.blogger.location | array | null | No | 「地域」:博主所在地。**直接填地名即可**,省/市/区县任意层级都行 —— ["上海"]、["杭州"]、["上城区"] 都可以,多个之间是「或」。也可以填完整路径(如 "中国 浙江 杭州"),上游会自动转成地名。可选地名见 /get_blogger_filter_options 的 **areas**(到区县)/Blogger location: plain place names work (province/city/district), OR-ed together | — |
request_body.blogger.audience20 | array | null | No | 「二十大人群」:**不是扁平裸名**。一级填名字即可(如 `自在户外`,= 整个人群);**二级必须写成 `"一级 一级-二级"`**(如 `"自在户外 自在户外-挑战极限者"`)—— 一级名要出现两次。**照字典里的二级 label 直接填(如 `挑战极限者`)会静默返回 0 条**。一级与复合二级可以混在同一个数组里,多个之间是「或」。全量见 `/get_blogger_filter_options` 的 audience20(19 个一级 / 121 个二级) | — |
request_body.blogger.note_scene | array | null | No | 「笔记类目」:填**空格分隔的完整路径**(类目 一级 二级 三级),如 "汽车 理性决策 选车攻略 政策",路径可停在任意深度(越深越窄)。**只填末段(如 "选车攻略")会返回 0 条。** 取值查 `/get_blogger_filter_options` 的 **contentScenes**(实测:`["汽车"]`=75、`["汽车 理性决策"]`=23、四级路径=1、`["选车攻略"]`=0) | — |
request_body.blogger.content_tag | array | null | No | 「博主类目」:填类目名。一级共 28 个 —— 美妆/护肤/个人护理/母婴/时尚/美食/家居家装/影视综资讯/运动健身/宠物/文化艺术/兴趣爱好/生活记录/教育/职场/情感/摄影/游戏/科技数码/出行旅游/音乐/搞笑/健康养生/汽车/婚嫁/商业财经/素材/其他;也可填某一级下的二级名,**两级可以混在同一个数组里**,多个之间是「或」。某个类目要「全部」就填它的一级名,**不要展开成它的全部二级名**(有些博主只挂一级、没有二级标签,展开会漏掉他们)。**不限类目就不要传这个字段** —— 没有名为「全部」的类目,填了会静默返回 0 条。填错的名字同样不报错、只返回 0 条,务必从 contentTags 字典里原样复制。注意与「行业」(coop.industry) 不是同一套分类 | — |
request_body.blogger.feature_tags | array | null | No | 「擅长内容」:填 `/get_blogger_filter_options` 里 featureTags 的名字(裸名)。**一级(形式/风格/生活方式/肤质肤色/皮肤养护)和二级(如 vlog / 韩系)都能填、可混填**,多个之间是「或」;填一级就是那一组全要(实测:一级 `形式`=183,二级 `vlog`=136) | — |
request_body.blogger.content_theme | array | null | No | 「内容题材」:填 `/blogger/filter-options` 里 contentTheme 的**一级 label**(如 汽车特色 / 通用)。注意只支持一级,填子项 label 或 id 查不到结果 | — |
request_body.blogger.personal_tags | array | null | No | 「博主人设」:填 `/get_blogger_filter_options` 里 personalTagsV2 的 `tagName`(裸名)。这是三层树(家庭身份/职业身份/特色背景 → 分组 → 叶子),**三层任意一层都能填、可以混填**,多个之间是「或」;想要整组就填那一组的名字,不用把叶子一个个列出来(实测:一级 `职业身份`=91 条,二级 `互联网`=8 条,叶子 `妈妈`=31 条) | — |
request_body.blogger.industry_crowd | array | null | No | 「行业特色画像」:填 `/blogger/filter-options` 里 automotiveIndustryTag **最深层叶子的 value**(数字字符串 ID,如 15795914,共 1600+ 个)。填 label 或中间层 id 均无结果 | — |
request_body.blogger.consumer_behavior | array | null | No | 「预估消费行为」:**必须填含根节点的空格全路径**(如 `"内容行为预估 汽车"`),路径可停在任意深度。取值查 `/get_blogger_filter_options` 的 **consumerBehavior**(5 层树)。⚠️ **填裸的叶子名不会报错、也不会返回 0 条,而是整个筛选被静默忽略** —— 实测 `["保时捷911"]` 与 `["zzz不存在zzz"]` 都返回未经筛选的全量结果,只有全路径写法才真的生效(`["内容行为预估 汽车"]` 才筛出 54 条)。用它时请对比加/不加该筛选两次请求的 total 确认真的筛上了。另:该项按账号灰度开放,字典里为 null 时表示当前账号不可用 | — |
request_body.keyword | string | No | 搜索词;空=只筛选不搜索/Keyword | "" |
request_body.page_num | integer | No | 页码,1-250(上游只放出前 5000 条)/Page, 1-250 | 1 |
request_body.page_size | integer | No | 每页数量,1-20(网页固定 20,建议保持 20)/Page size, 1-20 | 20 |
request_body.search_type | enum (0 | 1) | No | 1=按笔记关键词找博主(默认) 0=按昵称搜/Search mode | 1 |
request_body.similar_word | string | null | No | 配合 similar_user_id 的博主昵称,仅用于回显、不影响结果/Nickname echo for similar_user_id; does not affect results | — |
request_body.brand_user_id | string | null | No | 品牌方/广告主用户ID,可不填/Brand user ID, optional | — |
request_body.similar_user_id | string | null | No | 找相似博主:填一个博主的 userId,返回与他相似的博主,**并且可以叠加下面所有筛选**(这是它与 /get_blogger_similar 的关键区别)/Find similar bloggers; unlike /get_blogger_similar it can be combined with all filters below | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_xiaohongshu_pgy_creator_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"blogger": {
"location": [
"苏州"
]
},
"column": "comprehensiverank",
"fans": {
"count": {
"min": 1000
}
},
"flags": {
"exclude_low_active": true
},
"keyword": "苏州探店",
"page_num": 1,
"page_size": 20,
"search_type": 1,
"sort": "desc"
}
}
}'Response exampleresponse.json
{
"code": 200,
"data": {
"code": 0,
"data": {
"highlightWords": [
"苏州探店"
],
"kols": [
{
"accumCommonImpMedinNum30d": 4276,
"accumCoopImpMedinNum30d": 0,
"accumPicCommonImpMedinNum30d": 4276,
"accumVideoCommonImpMedinNum30d": 0,
"avgAgmv90d": 0.0,
"avgLiveViewerNum": 0.0
}
],
"redirect2NickSearch": false,
"resultType": 1,
"total": 204,
"trackId": "kolGeneralSearch_0311ad6506ba4a739f17b1b065ce04aa"
},
"msg": "成功",
"success": true
},
"docs": "https://api.tikhub.io/#/Xiaohongshu-PGY-API/get_blogger_list_api_v1_xiaohongshu_pgy_get_blogger_list_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"router": "/api/v1/xiaohongshu/pgy/get_blogger_list"
}This example shows part of the response. Copied content is valid JSON.

