蒲公英-达人列表（筛选）（v14）

鉴权

请求头 X-API-Key（也可用 pi_key）。

状态码

状态码	说明
-1	failed
0	success
400	参数错误
1001	账户余额不足
1002	邮箱/手机号或密码错误
1003	请求频率超过上限
1004	邮箱或手机号已注册
1005	无效的 API Key
1006	用户不存在
1007	登录凭证无效
1008	缺少 API Key
1009	手机或邮箱已存在
1010	需要管理员授权
1011	原密码错误
1012	新密码不能与原密码相同
1013	手机号和uid不能都为空
1014	请填写验证码
1015	验证码错误或已过期
1016	登录失败次数过多，请输入验证码
1017	请填写手机号
1018	请填写邮箱
1019	接口不存在，请检查
5000	服务暂时不可用，请稍后重试
5003	网络连接失败，请稍后重试

曝光/报价怎么传（最常用）

直接传档位中文字符串即可，例如：

json
{
  "accum_common_imp_medin_num_30d": "1万～5万",
  "note_price": "0.1万～0.5万",
  "video_price": "0.5万～1万"
}

需要自定义再传数组，如 [2000, 8000]。

常用入参

字段	说明
search_type	0 搜昵称（keyword 必填）/ 1 搜笔记关键词（keyword 可空）
content_tag	博主类目多选
accum_common_imp_medin_num_30d	曝光中位数档位字符串，或 [min,max]
note_price / video_price	合作报价档位字符串，或 [min,max]

返回结果

字段	说明
code	状态码，0 表示成功
msg	状态信息，成功时为 success
data.cost	本次请求消耗的积分/费用
data.balance	账户剩余余额
data.highlightWords	搜索高亮词列表，如 `["奶粉"]`
data.kols	博主列表数组，核心数据
data.kols[].accumCommonImpMedinNum30d	近30天日常笔记曝光中位数
data.kols[].accumCoopImpMedinNum30d	近30天合作笔记曝光中位数
data.kols[].accumPicCommonImpMedinNum30d	近30天日常图文笔记曝光中位数
data.kols[].accumVideoCommonImpMedinNum30d	近30天日常视频笔记曝光中位数
data.kols[].activityList	参与的活动列表
data.kols[].algoRecommendReasons	算法推荐理由
data.kols[].authorityList	权威资质列表
data.kols[].avgAgmv90d	近90天平均直播GMV
data.kols[].avgLiveViewerNum	场均观看人数
data.kols[].businessNoteCount	商业笔记数量
data.kols[].buyerType	买手类型
data.kols[].classifyCode	分类编码
data.kols[].clickMidNum	点击中位数
data.kols[].clickMidNumMcn	MCN点击中位数
data.kols[].clothingIndustryPrice	服装行业报价对象
data.kols[].clothingIndustryPrice.bizType	业务类型
data.kols[].clothingIndustryPrice.industryId	行业ID
data.kols[].clothingIndustryPrice.picturePrice	图文报价
data.kols[].clothingIndustryPrice.pictureState	图文报价状态
data.kols[].clothingIndustryPrice.videoPrice	视频报价
data.kols[].clothingIndustryPrice.videoState	视频报价状态
data.kols[].contentTags	内容标签数组
data.kols[].contentTags[].taxonomy1Tag	一级内容类目
data.kols[].contentTags[].taxonomy2Tags	二级内容类目列表
data.kols[].controlState	控制状态
data.kols[].coopNoteNum30d	近30天合作笔记数
data.kols[].cooperType	合作类型
data.kols[].cooperateState	合作状态
data.kols[].cpc	CPC 信息
data.kols[].cps	CPS 信息
data.kols[].currentLevel	当前等级
data.kols[].efficiencyValidUser	有效用户效率
data.kols[].estimateCpuv30d	近30天预估CPUV
data.kols[].estimatePictureCpm	预估图文CPM
data.kols[].estimatePictureCpmCompare	预估图文CPM对比值
data.kols[].estimatePictureEngageCost	预估图文互动成本
data.kols[].estimatePictureEngageCostCompare	预估图文互动成本对比值
data.kols[].estimateVideoCpm	预估视频CPM
data.kols[].estimateVideoCpmCompare	预估视频CPM对比值
data.kols[].estimateVideoEngageCost	预估视频互动成本
data.kols[].estimateVideoEngageCostCompare	预估视频互动成本对比值
data.kols[].fans30GrowthNum	近30天粉丝增长数
data.kols[].fans30GrowthRate	近30天粉丝增长率
data.kols[].fansActiveIn28dLv	近28天粉丝活跃度等级
data.kols[].fansCount	粉丝数
data.kols[].fansEngageNum	粉丝互动数
data.kols[].fansEngageNum30dLv	近30天粉丝互动等级
data.kols[].fansNum	粉丝数量
data.kols[].fansRiseNum	粉丝增长数
data.kols[].fbState	报备状态
data.kols[].featureTags	擅长内容标签列表
data.kols[].forecastGroupCoverRateLower	预估人群覆盖下限
data.kols[].forecastGroupCoverRateUpper	预估人群覆盖上限
data.kols[].forecastReadUvLower	预估阅读UV下限
data.kols[].forecastReadUvUpper	预估阅读UV上限
data.kols[].gender	博主性别
data.kols[].goodRecommendPermission	好物推荐权限
data.kols[].hasBuyerAuth	是否具有买手认证
data.kols[].headPhoto	头像地址
data.kols[].homePageDisplay	主页展示状态
data.kols[].hundredLikePercent30	近30天百赞笔记比例
data.kols[].industryTag	行业标签
data.kols[].intentionInfo	合作意向信息
data.kols[].intentionInfo.intentionText	合作意向文本
data.kols[].intentionInfo.intentionType	合作意向类型
data.kols[].interMidCoop30	近30天合作互动中位数
data.kols[].interMidNum	互动中位数
data.kols[].inviteReply48hNumRatio	48小时邀约回复率
data.kols[].isCollect	是否已收藏
data.kols[].isIndustryRecommend	是否行业推荐
data.kols[].isStar	是否星标
data.kols[].kliveCnt30d	近30天直播场次
data.kols[].kolHeadLabel	博主头部标签
data.kols[].kolType	博主类型
data.kols[].likeCollectCountInfo	点赞收藏数信息
data.kols[].live	直播信息
data.kols[].liveCooperateLimit	直播合作限制
data.kols[].liveGMV	直播GMV
data.kols[].liveId	直播ID
data.kols[].liveImg	直播图片
data.kols[].liveSign	直播标识
data.kols[].location	所在地域
data.kols[].lowActive	是否低活跃
data.kols[].lowerPrice	最低报价
data.kols[].mCpuvNum30d	近30天MCN CPUV
data.kols[].mEngagementNum	MCN互动数
data.kols[].mEngagementNumMcn	MCN互动数（MCN）
data.kols[].marketTarget	营销目标
data.kols[].matchNoteNumber	匹配笔记数
data.kols[].mcpuvNum30d	近30天MCN CPUV
data.kols[].mengagementNum	MCN互动数
data.kols[].mengagementNumMcn	MCN互动数（MCN）
data.kols[].name	博主昵称
data.kols[].newHighQuality	是否新优质
data.kols[].nextLevel	下一等级
data.kols[].nextPicturePrice	下一档图文报价
data.kols[].nextVideoPrice	下一档视频报价
data.kols[].note	备注
data.kols[].noteList	笔记列表
data.kols[].noteList[].bind	是否绑定
data.kols[].noteList[].contentTag	内容标签
data.kols[].noteList[].featureTags	笔记特征标签列表
data.kols[].noteList[].imageUrl	笔记图片地址
data.kols[].noteList[].industryTags	行业标签
data.kols[].noteList[].noteId	笔记ID
data.kols[].noteList[].noteType	笔记类型
data.kols[].noteSign	笔记标识
data.kols[].overflowNum	溢出数量
data.kols[].personalTags	博主人设标签列表
data.kols[].picPriceRemind	图文价格提醒
data.kols[].pictureClickMidNum	图文点击中位数
data.kols[].pictureCpcBasePrice	图文CPC底价
data.kols[].pictureCpcEstimateNum	图文CPC预估数
data.kols[].pictureCpcInCart	图文CPC加购数
data.kols[].pictureCpcPerPrice	图文CPC单价
data.kols[].pictureHundredLikePercent30	图文近30天百赞笔记比例
data.kols[].pictureInCart	图文加购数
data.kols[].pictureInterMidNum	图文互动中位数
data.kols[].picturePrice	图文报价
data.kols[].picturePriceGtZero	图文报价是否大于0
data.kols[].pictureReadCost	图文阅读成本
data.kols[].pictureShowState	图文展示状态
data.kols[].pictureState	图文状态
data.kols[].pictureThousandLikePercent30	图文近30天千赞笔记比例
data.kols[].predictiveExposure	预估曝光量
data.kols[].priceState	报价状态
data.kols[].processingAuthorities	处理权限
data.kols[].promiseImpNum	承诺曝光量
data.kols[].readMidCoop30	近30天合作阅读中位数
data.kols[].recommend	推荐信息
data.kols[].recommendReason	推荐理由
data.kols[].redId	小红书号
data.kols[].resemblance	是否相似
data.kols[].seedAndHarcest	种草与收割
data.kols[].sellerRealIncomeAmt90d	近90天卖家实际收入
data.kols[].showPrice	是否展示价格
data.kols[].showPromiseTag	是否展示承诺标签
data.kols[].specialIndustryLimit	特殊行业限制
data.kols[].thousandLikePercent30	近30天千赞笔记比例
data.kols[].top2CategoryList	前二类目列表
data.kols[].totalNoteCount	笔记总数
data.kols[].tradeType	交易类型/行业
data.kols[].travelAreaList	旅行区域列表
data.kols[].type	类型列表
data.kols[].userId	用户ID
data.kols[].userType	用户类型
data.kols[].valid	是否有效
data.kols[].videoClickMidNum	视频点击中位数
data.kols[].videoCpcBasePrice	视频CPC底价
data.kols[].videoCpcEstimateNum	视频CPC预估数
data.kols[].videoCpcInCart	视频CPC加购数
data.kols[].videoCpcPerPrice	视频CPC单价
data.kols[].videoCpcState	视频CPC状态
data.kols[].videoFinishRate	视频完播率
data.kols[].videoHundredLikePercent30	视频近30天百赞笔记比例
data.kols[].videoInCart	视频加购数
data.kols[].videoInterMidNum	视频互动中位数
data.kols[].videoPrice	视频报价
data.kols[].videoPriceGtZero	视频报价是否大于0
data.kols[].videoPriceRemind	视频价格提醒
data.kols[].videoReadCost	视频阅读成本
data.kols[].videoShowState	视频展示状态
data.kols[].videoState	视频状态
data.kols[].videoThousandLikePercent30	视频近30天千赞笔记比例
data.redirect2NickSearch	是否重定向到昵称搜索
data.resultType	结果类型
data.total	总结果数
data.trackId	追踪ID

请求参数

Header 参数

Body 参数application/json必填

示例

常用：档位字符串（1万～5万 / 0.1万～0.5万）按昵称搜索进阶：自定义数值区间 [min, max]

{
    "search_type": 1,
    "keyword": "",
    "page_num": 1,
    "page_size": 20,
    "column": "comprehensiverank",
    "sort": "desc",
    "content_tag": [
        "唇妆",
        "母婴日常"
    ],
    "accum_common_imp_medin_num_30d": "1万～5万",
    "note_price": "0.1万～0.5万",
    "video_price": "0.5万～1万"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "cost": 100,
        "balance": 2756345,
        "highlightWords": [
            "奶粉"
        ],
        "kols": [
            {
                "accumCommonImpMedinNum30d": 16393,
                "accumCoopImpMedinNum30d": 0,
                "accumPicCommonImpMedinNum30d": 16393,
                "accumVideoCommonImpMedinNum30d": 18479,
                "activityList": [],
                "algoRecommendReasons": null,
                "authorityList": null,
                "avgAgmv90d": 0.0,
                "avgLiveViewerNum": 0.0,
                "businessNoteCount": 76,
                "buyerType": 2,
                "classifyCode": 1,
                "clickMidNum": 2777,
                "clickMidNumMcn": 0,
                "clothingIndustryPrice": {
                    "bizType": null,
                    "industryId": 0,
                    "picturePrice": 0,
                    "pictureState": 0,
                    "videoPrice": 0,
                    "videoState": 0
                },
                "contentTags": [
                    {
                        "taxonomy1Tag": "美妆",
                        "taxonomy2Tags": [
                            "整体妆容"
                        ]
                    },
                    {
                        "taxonomy1Tag": "母婴",
                        "taxonomy2Tags": [
                            "孕产经验",
                            "母婴日常"
                        ]
                    }
                ],
                "controlState": 0,
                "coopNoteNum30d": 0,
                "cooperType": 1,
                "cooperateState": 1,
                "cpc": null,
                "cps": null,
                "currentLevel": 2,
                "efficiencyValidUser": 0,
                "estimateCpuv30d": 0.0,
                "estimatePictureCpm": 213.51,
                "estimatePictureCpmCompare": 82.4,
                "estimatePictureEngageCost": 34.31,
                "estimatePictureEngageCostCompare": 88.3,
                "estimateVideoCpm": 270.58,
                "estimateVideoCpmCompare": 68.5,
                "estimateVideoEngageCost": 26.95,
                "estimateVideoEngageCostCompare": 74.6,
                "fans30GrowthNum": 0,
                "fans30GrowthRate": -0.1,
                "fansActiveIn28dLv": 86.6,
                "fansCount": 0,
                "fansEngageNum": null,
                "fansEngageNum30dLv": 1.2,
                "fansNum": 59873,
                "fansRiseNum": null,
                "fbState": 0,
                "featureTags": [
                    "探店",
                    "plog"
                ],
                "forecastGroupCoverRateLower": 0.0,
                "forecastGroupCoverRateUpper": 0.0,
                "forecastReadUvLower": 0,
                "forecastReadUvUpper": 0,
                "gender": "男",
                "goodRecommendPermission": null,
                "hasBuyerAuth": true,
                "headPhoto": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31ho9qh08k20048lng6iokjpip6lvt8o?imageView2/2/w/120/format/jpg",
                "homePageDisplay": 1,
                "hundredLikePercent30": 62.5,
                "industryTag": null,
                "intentionInfo": {
                    "intentionText": "期待与「出行旅游」行业合作",
                    "intentionType": 2
                },
                "interMidCoop30": 0,
                "interMidNum": 125,
                "inviteReply48hNumRatio": 72.4,
                "isCollect": false,
                "isIndustryRecommend": false,
                "isStar": null,
                "kliveCnt30d": 0,
                "kolHeadLabel": 0,
                "kolType": 0,
                "likeCollectCountInfo": null,
                "live": null,
                "liveCooperateLimit": false,
                "liveGMV": null,
                "liveId": null,
                "liveImg": null,
                "liveSign": null,
                "location": "日本",
                "lowActive": false,
                "lowerPrice": 3500.0,
                "mCpuvNum30d": 0,
                "mEngagementNum": 132,
                "mEngagementNumMcn": 0,
                "marketTarget": null,
                "matchNoteNumber": 1,
                "mcpuvNum30d": 0,
                "mengagementNum": 132,
                "mengagementNumMcn": 0,
                "name": "东京小枝",
                "newHighQuality": 0,
                "nextLevel": -1,
                "nextPicturePrice": null,
                "nextVideoPrice": null,
                "note": null,
                "noteList": [
                    {
                        "bind": false,
                        "contentTag": null,
                        "featureTags": [
                            "奶粉"
                        ],
                        "imageUrl": "http://ci.xiaohongshu.com/1040g2sg325ir1485465g48lng6iokjpi64i2s5o?imageView2/2/w/540/form

🟠422

蒲公英-达人列表（筛选）（v14）

鉴权#

状态码#

曝光/报价怎么传（最常用）#

常用入参#

返回结果#