小红书蒲公英创作者搜索 API (V1)
GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…
获取小红书蒲公英创作者搜索数据，包括过滤器、返回的档案和受众，用于发现、比较和候选名单构建。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 用户鉴权令牌。 |
searchType | query | string | 否 | NICKNAME | 搜索条件类型。 可用值： - NICKNAME：按昵称搜索- NOTE：按备注内容搜索 |
keyword | query | string | 否 | - | 搜索关键词。 |
page | query | integer | 否 | 1 | 页码。 |
sort | query | string | 否 | FANS | 创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用蒲公英智能排序。 可选值： - DEFAULT：平台默认智能排序- FANS：按粉丝数降序排序 |
fansNumberLower | query | integer | 否 | - | 最低粉丝数。 |
fansNumberUpper | query | integer | 否 | - | 最大粉丝数。 |
fansAge | query | string | 否 | ALL | 目标粉丝年龄群体。 可用值： - ALL: 所有年龄段- LT_18: 18岁以下- AGE_18_24: 18至24岁- AGE_25_34: 25至34岁- AGE_35_44: 35至44岁- GT_44: 44岁以上 |
fansGender | query | string | 否 | ALL | 目标粉丝性别。 可用值： - ALL: 所有性别- MALE_HIGH: 主要男性- FE_MALE_HIGH: 主要女性 |
fansChildAgeInfo | query | string | 否 | - | 母婴人群阶段筛选。传入蒲公英标签或数字编码，用英文或中文逗号分隔。 可选值： - 1: 备孕 - 2: 0-6月 - 3: 7-12月 - 4: 1-3岁 - 5: 4-6岁 - 6: 7-12岁 - 7: 孕早期 - 8: 孕晚期 示例： - 2,5 |
gender | query | string | 否 | ALL | KOL的性别。 可选值： - ALL: 所有性别- MALE: 男性- FEMALE: 女性 |
location | query | string | 否 | - | 博主位置筛选。传入蒲公英位置标签，用英文或中文逗号分隔。中国省份或地区短标签会规范化为完整的蒲公英值。 可用值： - 中国 - 美国 - 日本 - 澳大利亚 - 英国 - 加拿大 - 韩国 - 法国 - 德国 - 新加坡 - 其他 - 中国 北京 - 中国 天津 - 中国 河北 - 中国 山西 - 中国 内蒙古 - 中国 辽宁 - 中国 吉林 - 中国 黑龙江 - 中国 上海 - 中国 江苏 - 中国 浙江 - 中国 安徽 - 中国 福建 - 中国 江西 - 中国 山东 - 中国 河南 - 中国 湖北 - 中国 湖南 - 中国 广东 - 中国 广西 - 中国 海南 - 中国 重庆 - 中国 四川 - 中国 贵州 - 中国 云南 - 中国 西藏 - 中国 陕西 - 中国 甘肃 - 中国 青海 - 中国 宁夏 - 中国 新疆 - 中国 澳门 - 中国 台湾 - 中国 香港 示例： - 广东,中国 上海 示例： - 广东,中国 上海 |
contentTag | query | string | 否 | - | 内容分类筛选。传入蒲公英一级或二级分类标签，用逗号分隔。 可选值： - 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他 - 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他 - 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他 - 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才艺, 宝宝写真, 母婴其他 - 时尚: 穿搭, 配饰, 发型, 箱包, 鞋靴, 时尚其他 - 美食: 美食教程, 美食探店, 美食展示, 美食测评, 吃播, 美食其他 - 家居家装: 装修, 家居用品, 家居装饰, 家具, 家电, 室内设计, 居家经验, 家居家装其他 - 影视综资讯: 动漫, 电影, 电视, 娱乐资讯, 影视, 民生资讯, 综艺, 影视综其他 - 运动健身: 健身减肥, 健身塑形, 滑雪, 滑板, 水上活动, 运动其他, 足球, 篮球, 跑步, 游泳 - 宠物: 猫, 狗, 动物其他 - 文化艺术: 社科, 文化, 艺术, 文化艺术其他 - 兴趣爱好: 绘画, 手工, 阅读, 文具手账, 舞蹈, 益智玩具, 潮流玩具, 兴趣爱好其他 - 生活记录: 接地气生活, 日常片段, 中外生活, 品质生活, 校园生活 - 教育: 大学教育, k12教育, 家庭教育, 学习日常, 职场教育, 教育其他 - 情感: 情感知识, 情感日常, 情感其他 - 摄影: 人文风光摄影, 摄影技巧, 胶片摄影, 人像摄影, 摄影其他 - 游戏: 手机游戏, 主机游戏, 游戏其他, 线下游戏 - 科技数码: 数码, 玩机攻略, 数码科技其他 - 出行: 城市出行, 户外, 旅行 - 音乐 - 搞笑 - 健康养生 - 汽车 - 婚嫁: 婚礼造型, 婚礼记录, 婚礼经验, 婚礼用品 - 商业财经 - 素材 - 其他 示例： - 美妆,护肤,美食教程 |
contentSceneLabel | query | string | 否 | - | 内容场景标签筛选。传入完整的蒲公英笔记分类场景标签路径，用英文或中文逗号分隔。 可选值： - 汽车 理性决策 选车攻略 政策 - 汽车 理性决策 选车攻略 购车顾虑 - 汽车 理性决策 选车攻略 配置 - 汽车 理性决策 选车攻略 能源类型优势对比 - 汽车 理性决策 选车攻略 攻略 - 汽车 理性决策 新车测评 - 汽车 理性决策 探店试驾 - 汽车 理性决策 车主心得 - 汽车 用车场景 远行近游 近郊探索 - 汽车 用车场景 远行近游 长途自驾 - 汽车 用车场景 远行近游 硬核越野 - 汽车 用车场景 提车/交付场景 场地布置与礼遇 - 汽车 用车场景 提车/交付场景 仪式感记录 - 汽车 用车场景 商务用车 移动头等舱 - 汽车 用车场景 商务用车 商务接待 - 汽车 用车场景 亲子家庭 家庭采购日 - 汽车 用车场景 亲子家庭 接送孩子 - 汽车 用车场景 亲子家庭 三代同堂 - 汽车 用车场景 亲子家庭 周末溜娃 - 汽车 用车场景 亲子家庭 车内学习室 - 汽车 用车场景 亲子家庭 车内育婴室 - 汽车 用车场景 朋友社交 后备箱经济 - 汽车 用车场景 朋友社交 移动娱乐屋 - 汽车 用车场景 礼赠场景 毕业礼物 - 汽车 用车场景 礼赠场景 送给父母 - 汽车 用车场景 礼赠场景 适合送男友 - 汽车 用车场景 礼赠场景 适合送女友 - 汽车 用车场景 户外兴趣 钓鱼/野营 - 汽车 用车场景 户外兴趣 骑行 - 汽车 用车场景 户外兴趣 徒步 - 汽车 用车场景 户外兴趣 硬核竞速 - 汽车 用车场景 宠物出行 大型宠物 - 汽车 用车场景 宠物出行 短途出行 - 汽车 用车场景 宠物出行 小型宠物 - 汽车 用车场景 宠物出行 长途出行 - 汽车 用车场景 城市通勤 车内小憩 - 汽车 用车场景 城市通勤 健身储物 - 汽车 用车场景 城市通勤 日常通勤 - 汽车 用车场景 城市通勤 生活圈代步 - 汽车 用车场景 城市通勤 移动美容舱 - 汽车 个性化美化 个性改装 - 汽车 个性化美化 储物收纳 - 汽车 个性化美化 车内装饰 - 汽车 个性化美化 车外装饰 - 汽车 个性化美化 车衣保护 - 汽车 个性化美化 汽车用品 - 汽车 车型品类 轿车 - 汽车 车型品类 SUV - 汽车 车型品类 MPV - 汽车 车型品类 跑车 - 汽车 车型品类 微型车 - 汽车 车型品类 微面 - 汽车 车型品类 房车 - 汽车 车型品类 越野车 - 汽车 车型品类 旅行车 - 汽车 圈层属性 改装圈层 - 汽车 圈层属性 痛车圈层 - 汽车 圈层属性 跑山圈层 - 汽车 品牌倾向 自主 - 汽车 品牌倾向 豪华 - 汽车 品牌倾向 集团 - 汽车 品牌倾向 新势力 - 汽车 能源类型 纯电车 - 汽车 能源类型 新能源 - 汽车 能源类型 油车 - 汽车 人生阶段 单身 - 汽车 人生阶段 多娃&大家庭阶段 - 汽车 人生阶段 银发退休阶段 - 游戏 游戏品类 网页游戏 - 游戏 游戏品类 电脑游戏 - 游戏 游戏品类 手机游戏 - 游戏 游戏类型 动作格斗游戏 永劫无间 - 游戏 游戏类型 即时制二次元游戏 境界刀鸣 - 游戏 游戏类型 即时制二次元游戏 黑色信标 - 游戏 游戏类型 即时制二次元游戏 物华弥新 - 游戏 游戏类型 即时制二次元游戏 无期迷途 - 游戏 游戏类型 即时制二次元游戏 新月同行 - 游戏 游戏类型 即时制二次元游戏 绝区零 - 游戏 游戏类型 即时制角色扮演 诛仙2 - 游戏 游戏类型 即时制角色扮演 诛仙 - 游戏 游戏类型 即时制角色扮演 明日之后 - 游戏 游戏类型 即时制角色扮演 超自然行动组 - 游戏 游戏类型 即时制角色扮演 永恒之塔2 - 游戏 游戏类型 回合制二次元游戏 未定事件簿 - 游戏 游戏类型 回合制二次元游戏 雷索纳斯 - 游戏 游戏类型 回合制二次元游戏 浮生忆玲珑 - 游戏 游戏类型 回合制二次元游戏 重返未来1999 - 游戏 游戏类型 回合制角色扮演 梦幻西游手游 - 游戏 游戏类型 回合制角色扮演 龙魂旅人 - 游戏 游戏类型 回合制角色扮演 最终幻想14 - 游戏 游戏类型 塔防游戏 保卫向日葵 - 游戏 游戏类型 塔防游戏 全境守卫 - 游戏 游戏类型 塔防游戏 向僵尸开炮 - 游戏 游戏类型 开放世界角色扮演 燕云十六声 - 游戏 游戏类型 开放世界角色扮演 王者荣耀世界 - 游戏 游戏类型 恋爱游戏 如鸢 - 游戏 游戏类型 恋爱游戏 银与绯 - 游戏 游戏类型 恋爱游戏 时空中的绘旅人 - 游戏 游戏类型 恋爱游戏 光与夜之恋 - 游戏 游戏类型 恋爱游戏 恋与深空 - 游戏 游戏类型 恋爱游戏 恋与制作人 - 游戏 游戏类型 战略游戏 率土之滨 - 游戏 游戏类型 战略游戏 群星纪元 - 游戏 游戏类型 战略游戏 阿瓦隆之王 - 游戏 游戏类型 战略游戏 快来当领主 - 游戏 游戏类型 战略游戏 冒险之星 - 游戏 游戏类型 战略游戏 无尽的拉格朗日 - 游戏 游戏类型 放置类二次元游戏 花花与幕间剧 - 游戏 游戏类型 放置类角色扮演 发条总动员 - 游戏 游戏类型 放置类角色扮演 遮天凡尘一叶 - 游戏 游戏类型 模拟养成 美人传 - 游戏 游戏类型 模拟养成 盲盒派对 - 游戏 游戏类型 模拟养成 闪耀暖暖 - 游戏 游戏类型 模拟养成 以闪亮之名 - 游戏 游戏类型 模拟养成 无限暖暖 - 游戏 游戏类型 模拟家园建造 江南百景图 - 游戏 游戏类型 模拟家园建造 动物森友会 - 游戏 游戏类型 模拟家园建造 星露谷物语 - 游戏 游戏类型 模拟经营 暴吵萌厨 - 游戏 游戏类型 模拟经营 肥鹅健身房 - 游戏 游戏类型 模拟经营 杜拉拉升职记 - 游戏 游戏类型 消除游戏 四季合合 - 游戏 游戏类型 生存沙盒游戏 无尽冬日 - 游戏 游戏类型 聚会游戏 蛋仔派对 - 游戏 游戏类型 聚会游戏 代号砰砰 - 游戏 游戏类型 解谜游戏 晴空之下 - 游戏 游戏类型 抓宠类游戏 洛克王国手游 - 游戏 游戏类型 射击游戏 三角洲行动 - 游戏 游戏类型 射击游戏 codm（使命召唤） - 母婴 婴童洗护 安全防晒 - 母婴 婴童洗护 浴后护理 - 母婴 婴童洗护 敏感修护 - 母婴 婴童洗护 屏障树立 - 母婴 婴童洗护 泳后护理 - 母婴 婴童洗护 口周干裂 - 母婴 婴童洗护 分区清洁 - 母婴 婴童洗护 头皮问题 - 母婴 婴童洗护 驱虫驱蚊 - 母婴 婴童洗护 洁面清洁 - 母婴 婴童洗护 红屁股 - 母婴 婴童洗护 湿疹皮炎 - 母婴 婴童洗护 痱子热疹 - 母婴 婴童洗护 抚触链接 - 母婴 婴童洗护 趣味洗护 - 母婴 母婴纸品 精算育儿 - 母婴 母婴纸品 颜值派 - 母婴 母婴纸品 汗宝宝 - 母婴 母婴纸品 囤货党 - 母婴 母婴纸品 敏感肌 - 母婴 母婴纸品 肉腿娃 - 母婴 母婴纸品 功课党 - 母婴 母婴纸品 好动宝 - 母婴 母婴纸品 安睡整夜 - 母婴 母婴纸品 出行便携 - 母婴 母婴纸品 贵妇体验 - 母婴 母婴纸品 红屁屁 - 母婴 母婴小家电 空间收纳 - 母婴 母婴小家电 滋补养生 - 母婴 母婴小家电 温度把控 - 母婴 母婴小家电 夜奶操作 - 母婴 母婴小家电 新手喂养 - 母婴 母婴小家电 材质挑选 - 母婴 母婴小家电 三代同育 - 母婴 母婴小家电 户外喂养 - 母婴 母婴小家电 通乳攻略 - 母婴 母婴小家电 洁癖爸妈 - 母婴 母婴小家电 精准喂养 - 母婴 母婴小家电 职场妈妈 - 母婴 婴童辅食 吞咽能力 - 母婴 婴童辅食 多元辅食 - 母婴 婴童辅食 零食分享 - 母婴 婴童辅食 健康零食 - 母婴 婴童辅食 放学加餐 - 母婴 婴童辅食 出牙磨牙 - 母婴 婴童辅食 居家囤货 - 母婴 婴童辅食 节日礼包 - 母婴 婴童辅食 零食训练 - 母婴 婴童辅食 宝宝挑食 - 母婴 婴童辅食 户外零食 - 母婴 婴童辅食 低敏辅食 - 母婴 婴童辅食 入园社交 - 母婴 婴童辅食 居家辅食 - 母婴 婴童辅食 入园准备 - 母婴 婴童辅食 敏敏零食 - 母婴 婴童辅食 抓握训练 - 母婴 婴童辅食 外出口粮 - 母婴 婴童辅食 营养均衡 - 母婴 婴童辅食 自主进食 - 母婴 婴童辅食 第一口辅食 - 母婴 母婴营养品 开胃因子 - 母婴 母婴营养品 视力保护 - 母婴 母婴营养品 营养补充 - 母婴 母婴营养品 防护因子 - 母婴 母婴营养品 高钙因子 - 母婴 母婴营养品 自护构建 - 母婴 母婴营养品 发育表现 - 母婴 母婴营养品 助眠安睡 - 母婴 婴童奶粉 丝滑转奶 - 母婴 婴童奶粉 益生组合 - 母婴 婴童奶粉 眼脑体发育 - 母婴 婴童奶粉 选奶功课 - 母婴 婴童奶粉 防敏脱敏 - 母婴 婴童奶粉 助力聪明脑 - 母婴 婴童奶粉 乳铁自护 - 母婴 婴童奶粉 黄金长高 - 母婴 婴童奶粉 内修外护 - 母婴 婴童奶粉 肚肚吸收 - 母婴 婴童奶粉 断奶攻略 - 母婴 婴童奶粉 混合喂养 - 母婴 婴童奶粉 母源黄金HMO - 母婴 婴童奶粉 长肉多肉 - 母婴 哺乳喂养工具 萌娃穿搭 - 母婴 哺乳喂养工具 安全材质 - 母婴 哺乳喂养工具 奶瓶喂养 - 母婴 哺乳喂养工具 颜值发育 - 母婴 哺乳喂养工具 哄娃安抚 - 母婴 哺乳喂养工具 餐具选购 - 母婴 哺乳喂养工具 学饮指南 - 母婴 哺乳喂养工具 换季保温 - 母婴 母婴孕产 职场孕妇 - 母婴 母婴孕产 产后复工 - 母婴 母婴孕产 顺产 - 母婴 母婴孕产 孕期变化 - 母婴 母婴孕产 孕期学习 - 母婴 母婴孕产 剖腹产 - 母婴 母婴家居 护脊深睡 - 母婴 母婴家居 安全翻滚 - 母婴 母婴家居 进食习惯 - 母婴 母婴家居 早教启蒙 - 母婴 母婴家居 学习角落 - 母婴 母婴家居 自主入睡 - 母婴 母婴家居 爬行探索 - 母婴 母婴家居 防惊跳 - 母婴 母婴出行&用品 长线旅途 - 母婴 母婴出行&用品 户外探索 - 母婴 母婴出行&用品 二胎/双胎 - 母婴 母婴出行&用品 新贵消费 - 母婴 母婴出行&用品 备产研究 - 母婴 母婴出行&用品 短途旅行 - 母婴 母婴出行&用品 高频出行 - 母婴 母婴出行&用品 新生出行 - 母婴 母婴出行&用品 务实精算 - 母婴 母婴出行&用品 遛娃必备 示例： - 母婴 婴童辅食 吞咽能力,母婴 婴童辅食 多元辅食 |
personalTags | query | string | 否 | - | 博主人物标签筛选。传入一个或多个蒲公英人物标签，用英文或中文逗号分隔。 可选值： - 妈妈 - 萌娃 - 爸爸 - 奶奶 - 情侣 - 夫妻 - 家庭 - 闺蜜 - 兄弟 - 备孕中 - 孕期中 - 12岁以上 - 传统行业 - 互联网 - 教育科研 - 金融法律 - 企业创业 - 时尚美妆 - 食品饮料 - 文化传媒 - 医疗健康 - 艺术设计 - 影视娱乐 - 运动健身 - 专业服务 - 工程师 - 销售 - HR - 教练 - 运动员 - 舞蹈老师 - 生活背景 - 备考经验 - 兴趣爱好 - 留学背景 - 海外华人 - 铲屎官 - 孕妈 - 独居人群 - 外国人 - 混血儿 示例： - 妈妈,教练,运动员,舞蹈老师,留学背景 示例： - 妈妈,教练,运动员,舞蹈老师,留学背景 |
marketTarget | query | string | 否 | - | 营销目标筛选。传入一个蒲公英营销目标值。 可用值： - estimateAllCpm：曝光 - 曝光表现 - 成本 - mAccumImpNum：曝光 - 曝光表现 - 规模 - readCost：曝光 - 阅读表现 - 成本 - mValidRawReadFeedNum：曝光 - 阅读表现 - 规模 - estimateEngageCost：种草 - 互动表现 - 成本 - mEngagementNum90d：种草 - 互动表现 - 规模 - estimateCpuv：转化 - 站外访问表现 - 成本 - mCpuvNum：转化 - 站外访问表现 - 规模 示例： - estimateAllCpm 示例： - estimateAllCpm |
audienceGroup | query | string | 否 | - | 受众定向筛选。传入蒲公英受众群体ID（dmpGroupId），用英文或中文逗号分隔。这些ID是动态且特定于账号的，因此没有固定的全局值列表。使用蒲公英受众管理中显示的受众群体名称来识别每个ID的含义。示例： - 123456,789012 示例： - 123456,789012 |
top20CrowdsLabel | query | string | 否 | - | Top-20受众筛选。传入一级或子级受众标签，用逗号分隔；子级标签会转换为蒲公英请求值。 示例： - 自在户外,挑战极限者 |
industrySpecificCrowdsMotorDom | query | string | 否 | - | 行业画像筛选。传入蒲公英画像值ID或标签值，用逗号分隔。 示例： - 科技爱好者人群,14247197 |
featureTags | query | string | 否 | - | 擅长内容标签筛选。传入标签值，用逗号分隔。 示例： - vlog,探店 |
contentThemeLabel | query | string | 否 | - | 内容主题筛选。传入蒲公英值ID或标签值，用逗号分隔；标签会转换为值ID。 示例： - 沉浸式开车,汽车美图 |
excludeLowActive | query | boolean | 否 | - | 是否排除低活跃度博主。 示例： - true |
fansNumUp | query | boolean | 否 | - | 是否排除粉丝数下降的博主。 示例： - true |
noteType | query | string | 否 | ALL | 笔记类型筛选。值：ALL=所有笔记类型，PHOTO_TEXT=图文笔记为主，VIDEO=视频笔记为主。 可用值： - ALL：所有笔记类型- PHOTO_TEXT：图文笔记为主- VIDEO：视频笔记为主 |
industry | query | string | 否 | - | 蒲公英行业预设，用于行业助手风格的创作者推荐。 可用值： - 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：教育培训 - K12教育- EDUCATION_TRAINING_DEGREE_EDUCATION：教育培训 - 学历教育- EDUCATION_TRAINING_CORPORATE_DEVELOPMENT：教育培训 - 企业团建- EDUCATION_TRAINING_OTHER：教育培训 - 其他- GAMES：游戏- TRAVEL_TOURISM：旅游出行 |
accumCommonImpMedinNum30d | query | string | 否 | - | 日常笔记曝光量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。 示例： - 50000,-1 |
readMidNor30 | query | string | 否 | - | 日常笔记阅读量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。 示例： - 10000,50000 |
interMidNor30 | query | string | 否 | - | 日常笔记互动量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。 示例： - 1000,2000 |
thousandLikePercent30 | query | string | 否 | - | 千赞笔记比例范围。传入小数比例如 0.4,null 或百分比值如 40,null。 示例： - 0.4,null |
notePrice | query | string | 否 | - | 图文合作报价范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。 示例： - 10000,50000 |
videoPrice | query | string | 否 | - | 视频合作报价范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。 示例： - 10000,50000 |
inviteReply48hNumRatio | query | string | 否 | - | 48小时邀约回复率范围。传入小数比例如 0.9,0.95 或百分比值如 90,95。 示例： - 0.9,0.95 |
progressOrderCnt | query | string | 否 | - | 当前合作订单数量范围。传入两个逗号分隔的数值边界。 示例： - 1,10 |
tradeType | query | string | 否 | - | 来自蒲公英的近期合作行业筛选。 示例： - 美妆个护 |
tradeReportBrandIds | query | string | 否 | - | 近期合作品牌ID，以英文或中文逗号分隔。 示例： - brandUserId1,brandUserId2 |
excludeTradeReportBrandIds | query | boolean | 否 | - | 是否排除与所选近期合作品牌合作过的创作者。 示例： - true |
accumCoopImpMedinNum30d | query | string | 否 | - | 合作笔记曝光量中位数范围。传入两个逗号分隔的数值边界。 示例： - 50000,-1 |
readMidCoop30 | query | string | 否 | - | 合作笔记阅读量中位数范围。传入两个逗号分隔的数值边界。 示例： - 10000,50000 |
interMidCoop30 | query | string | 否 | - | 合作笔记互动量中位数范围。传入两个逗号分隔的数值边界。 示例： - 1000,2000 |
mCpuvNum30d | query | string | 否 | - | 合作笔记外站中位数范围。传入两个逗号分隔的数值边界。 示例： - 5000,10000 |
estimatePictureCpm | query | string | 否 | - | 预估图文CPM范围。传入两个逗号分隔的数值边界。 示例： - 50,100 |
estimateVideoCpm | query | string | 否 | - | 预估视频CPM范围。传入两个逗号分隔的数值边界。 示例： - 50,100 |
estimatePicReadPrice | query | string | 否 | - | 预估图文阅读单价范围。传入两个逗号分隔的数值边界。 示例： - 0.5,1 |
estimateVideoReadPrice | query | string | 否 | - | 预估视频阅读单价范围。传入两个逗号分隔的数值边界。 示例： - 1.5,2 |
estimatePictureEngageCost | query | string | 否 | - | 预估图文互动单价范围。传入两个逗号分隔的数值边界。 示例： - 0.5,1 |
estimateVideoEngageCost | query | string | 否 | - | 预估视频互动单价范围。传入两个逗号分隔的数值边界。 示例： - 1,2 |
estimateCpuv30d | query | string | 否 | - | 预估外店访问单价范围。传入两个逗号分隔的数值边界。 示例： - 0,0.5 |
kliveCnt30d | query | string | 否 | - | 近30天直播次数范围。传入两个逗号分隔的数值边界。 示例： - 1,5 |
avgLiveViewerNum | query | string | 否 | - | 平均直播观看人数范围。传入两个逗号分隔的数值边界。 示例： - 5000,10000 |
avgAgmv90d | query | string | 否 | - | 平均直播销售额范围。传入两个逗号分隔的数值边界。 示例： - 10000,100000 |
similarUserId | query | string | 否 | - | 相似创作者用户ID。similarUserId 和 similarWord 必须同时提供。示例： - 5ff1a4160000000001008edc |
similarWord | query | string | 否 | - | 蒲公英显示的相似创作者关键词。similarUserId 和 similarWord 必须同时提供。示例： - 小菜刀微服私访 |
代码示例
💡 环境说明
默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
bash
curl -X GET "https://api.justoneapi.com/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY"text
我想使用 Just One API 提供的“创作者搜索 (V1)”接口。
接入地址: 默认使用 https://api.justoneapi.com；中国大陆用户也可以改用 http://47.117.133.51:30015。
接口路径: /api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY
接口地址: BASE_URL + /api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/xiaohongshu-creator-marketplace-pugongying/creator-search-v1-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- searchType (query): 搜索条件类型。
可用值：
- `NICKNAME`：按昵称搜索
- `NOTE`：按备注内容搜索
- keyword (query): 搜索关键词。
- page (query): 页码。
- sort (query): 创作者搜索排序。可选值：FANS 按粉丝数降序排序，DEFAULT 使用蒲公英智能排序。
可选值：
- `DEFAULT`：平台默认智能排序
- `FANS`：按粉丝数降序排序
- fansNumberLower (query): 最低粉丝数。
- fansNumberUpper (query): 最大粉丝数。
- fansAge (query): 目标粉丝年龄群体。
可用值：
- `ALL`: 所有年龄段
- `LT_18`: 18岁以下
- `AGE_18_24`: 18至24岁
- `AGE_25_34`: 25至34岁
- `AGE_35_44`: 35至44岁
- `GT_44`: 44岁以上
- fansGender (query): 目标粉丝性别。
可用值：
- `ALL`: 所有性别
- `MALE_HIGH`: 主要男性
- `FE_MALE_HIGH`: 主要女性
- fansChildAgeInfo (query): 母婴人群阶段筛选。传入蒲公英标签或数字编码，用英文或中文逗号分隔。
可选值：
- 1: 备孕
- 2: 0-6月
- 3: 7-12月
- 4: 1-3岁
- 5: 4-6岁
- 6: 7-12岁
- 7: 孕早期
- 8: 孕晚期
- gender (query): KOL的性别。
可选值：
- `ALL`: 所有性别
- `MALE`: 男性
- `FEMALE`: 女性
- location (query): 博主位置筛选。传入蒲公英位置标签，用英文或中文逗号分隔。中国省份或地区短标签会规范化为完整的蒲公英值。
可用值：
- 中国
- 美国
- 日本
- 澳大利亚
- 英国
- 加拿大
- 韩国
- 法国
- 德国
- 新加坡
- 其他
- 中国 北京
- 中国 天津
- 中国 河北
- 中国 山西
- 中国 内蒙古
- 中国 辽宁
- 中国 吉林
- 中国 黑龙江
- 中国 上海
- 中国 江苏
- 中国 浙江
- 中国 安徽
- 中国 福建
- 中国 江西
- 中国 山东
- 中国 河南
- 中国 湖北
- 中国 湖南
- 中国 广东
- 中国 广西
- 中国 海南
- 中国 重庆
- 中国 四川
- 中国 贵州
- 中国 云南
- 中国 西藏
- 中国 陕西
- 中国 甘肃
- 中国 青海
- 中国 宁夏
- 中国 新疆
- 中国 澳门
- 中国 台湾
- 中国 香港
示例：
- 广东,中国 上海
- contentTag (query): 内容分类筛选。传入蒲公英一级或二级分类标签，用逗号分隔。
可选值：
- 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他
- 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他
- 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他
- 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才艺, 宝宝写真, 母婴其他
- 时尚: 穿搭, 配饰, 发型, 箱包, 鞋靴, 时尚其他
- 美食: 美食教程, 美食探店, 美食展示, 美食测评, 吃播, 美食其他
- 家居家装: 装修, 家居用品, 家居装饰, 家具, 家电, 室内设计, 居家经验, 家居家装其他
- 影视综资讯: 动漫, 电影, 电视, 娱乐资讯, 影视, 民生资讯, 综艺, 影视综其他
- 运动健身: 健身减肥, 健身塑形, 滑雪, 滑板, 水上活动, 运动其他, 足球, 篮球, 跑步, 游泳
- 宠物: 猫, 狗, 动物其他
- 文化艺术: 社科, 文化, 艺术, 文化艺术其他
- 兴趣爱好: 绘画, 手工, 阅读, 文具手账, 舞蹈, 益智玩具, 潮流玩具, 兴趣爱好其他
- 生活记录: 接地气生活, 日常片段, 中外生活, 品质生活, 校园生活
- 教育: 大学教育, k12教育, 家庭教育, 学习日常, 职场教育, 教育其他
- 情感: 情感知识, 情感日常, 情感其他
- 摄影: 人文风光摄影, 摄影技巧, 胶片摄影, 人像摄影, 摄影其他
- 游戏: 手机游戏, 主机游戏, 游戏其他, 线下游戏
- 科技数码: 数码, 玩机攻略, 数码科技其他
- 出行: 城市出行, 户外, 旅行
- 音乐
- 搞笑
- 健康养生
- 汽车
- 婚嫁: 婚礼造型, 婚礼记录, 婚礼经验, 婚礼用品
- 商业财经
- 素材
- 其他
- contentSceneLabel (query): 内容场景标签筛选。传入完整的蒲公英笔记分类场景标签路径，用英文或中文逗号分隔。
可选值：
- 汽车 理性决策 选车攻略 政策
- 汽车 理性决策 选车攻略 购车顾虑
- 汽车 理性决策 选车攻略 配置
- 汽车 理性决策 选车攻略 能源类型优势对比
- 汽车 理性决策 选车攻略 攻略
- 汽车 理性决策 新车测评
- 汽车 理性决策 探店试驾
- 汽车 理性决策 车主心得
- 汽车 用车场景 远行近游 近郊探索
- 汽车 用车场景 远行近游 长途自驾
- 汽车 用车场景 远行近游 硬核越野
- 汽车 用车场景 提车/交付场景 场地布置与礼遇
- 汽车 用车场景 提车/交付场景 仪式感记录
- 汽车 用车场景 商务用车 移动头等舱
- 汽车 用车场景 商务用车 商务接待
- 汽车 用车场景 亲子家庭 家庭采购日
- 汽车 用车场景 亲子家庭 接送孩子
- 汽车 用车场景 亲子家庭 三代同堂
- 汽车 用车场景 亲子家庭 周末溜娃
- 汽车 用车场景 亲子家庭 车内学习室
- 汽车 用车场景 亲子家庭 车内育婴室
- 汽车 用车场景 朋友社交 后备箱经济
- 汽车 用车场景 朋友社交 移动娱乐屋
- 汽车 用车场景 礼赠场景 毕业礼物
- 汽车 用车场景 礼赠场景 送给父母
- 汽车 用车场景 礼赠场景 适合送男友
- 汽车 用车场景 礼赠场景 适合送女友
- 汽车 用车场景 户外兴趣 钓鱼/野营
- 汽车 用车场景 户外兴趣 骑行
- 汽车 用车场景 户外兴趣 徒步
- 汽车 用车场景 户外兴趣 硬核竞速
- 汽车 用车场景 宠物出行 大型宠物
- 汽车 用车场景 宠物出行 短途出行
- 汽车 用车场景 宠物出行 小型宠物
- 汽车 用车场景 宠物出行 长途出行
- 汽车 用车场景 城市通勤 车内小憩
- 汽车 用车场景 城市通勤 健身储物
- 汽车 用车场景 城市通勤 日常通勤
- 汽车 用车场景 城市通勤 生活圈代步
- 汽车 用车场景 城市通勤 移动美容舱
- 汽车 个性化美化 个性改装
- 汽车 个性化美化 储物收纳
- 汽车 个性化美化 车内装饰
- 汽车 个性化美化 车外装饰
- 汽车 个性化美化 车衣保护
- 汽车 个性化美化 汽车用品
- 汽车 车型品类 轿车
- 汽车 车型品类 SUV
- 汽车 车型品类 MPV
- 汽车 车型品类 跑车
- 汽车 车型品类 微型车
- 汽车 车型品类 微面
- 汽车 车型品类 房车
- 汽车 车型品类 越野车
- 汽车 车型品类 旅行车
- 汽车 圈层属性 改装圈层
- 汽车 圈层属性 痛车圈层
- 汽车 圈层属性 跑山圈层
- 汽车 品牌倾向 自主
- 汽车 品牌倾向 豪华
- 汽车 品牌倾向 集团
- 汽车 品牌倾向 新势力
- 汽车 能源类型 纯电车
- 汽车 能源类型 新能源
- 汽车 能源类型 油车
- 汽车 人生阶段 单身
- 汽车 人生阶段 多娃&大家庭阶段
- 汽车 人生阶段 银发退休阶段
- 游戏 游戏品类 网页游戏
- 游戏 游戏品类 电脑游戏
- 游戏 游戏品类 手机游戏
- 游戏 游戏类型 动作格斗游戏 永劫无间
- 游戏 游戏类型 即时制二次元游戏 境界刀鸣
- 游戏 游戏类型 即时制二次元游戏 黑色信标
- 游戏 游戏类型 即时制二次元游戏 物华弥新
- 游戏 游戏类型 即时制二次元游戏 无期迷途
- 游戏 游戏类型 即时制二次元游戏 新月同行
- 游戏 游戏类型 即时制二次元游戏 绝区零
- 游戏 游戏类型 即时制角色扮演 诛仙2
- 游戏 游戏类型 即时制角色扮演 诛仙
- 游戏 游戏类型 即时制角色扮演 明日之后
- 游戏 游戏类型 即时制角色扮演 超自然行动组
- 游戏 游戏类型 即时制角色扮演 永恒之塔2
- 游戏 游戏类型 回合制二次元游戏 未定事件簿
- 游戏 游戏类型 回合制二次元游戏 雷索纳斯
- 游戏 游戏类型 回合制二次元游戏 浮生忆玲珑
- 游戏 游戏类型 回合制二次元游戏 重返未来1999
- 游戏 游戏类型 回合制角色扮演 梦幻西游手游
- 游戏 游戏类型 回合制角色扮演 龙魂旅人
- 游戏 游戏类型 回合制角色扮演 最终幻想14
- 游戏 游戏类型 塔防游戏 保卫向日葵
- 游戏 游戏类型 塔防游戏 全境守卫
- 游戏 游戏类型 塔防游戏 向僵尸开炮
- 游戏 游戏类型 开放世界角色扮演 燕云十六声
- 游戏 游戏类型 开放世界角色扮演 王者荣耀世界
- 游戏 游戏类型 恋爱游戏 如鸢
- 游戏 游戏类型 恋爱游戏 银与绯
- 游戏 游戏类型 恋爱游戏 时空中的绘旅人
- 游戏 游戏类型 恋爱游戏 光与夜之恋
- 游戏 游戏类型 恋爱游戏 恋与深空
- 游戏 游戏类型 恋爱游戏 恋与制作人
- 游戏 游戏类型 战略游戏 率土之滨
- 游戏 游戏类型 战略游戏 群星纪元
- 游戏 游戏类型 战略游戏 阿瓦隆之王
- 游戏 游戏类型 战略游戏 快来当领主
- 游戏 游戏类型 战略游戏 冒险之星
- 游戏 游戏类型 战略游戏 无尽的拉格朗日
- 游戏 游戏类型 放置类二次元游戏 花花与幕间剧
- 游戏 游戏类型 放置类角色扮演 发条总动员
- 游戏 游戏类型 放置类角色扮演 遮天凡尘一叶
- 游戏 游戏类型 模拟养成 美人传
- 游戏 游戏类型 模拟养成 盲盒派对
- 游戏 游戏类型 模拟养成 闪耀暖暖
- 游戏 游戏类型 模拟养成 以闪亮之名
- 游戏 游戏类型 模拟养成 无限暖暖
- 游戏 游戏类型 模拟家园建造 江南百景图
- 游戏 游戏类型 模拟家园建造 动物森友会
- 游戏 游戏类型 模拟家园建造 星露谷物语
- 游戏 游戏类型 模拟经营 暴吵萌厨
- 游戏 游戏类型 模拟经营 肥鹅健身房
- 游戏 游戏类型 模拟经营 杜拉拉升职记
- 游戏 游戏类型 消除游戏 四季合合
- 游戏 游戏类型 生存沙盒游戏 无尽冬日
- 游戏 游戏类型 聚会游戏 蛋仔派对
- 游戏 游戏类型 聚会游戏 代号砰砰
- 游戏 游戏类型 解谜游戏 晴空之下
- 游戏 游戏类型 抓宠类游戏 洛克王国手游
- 游戏 游戏类型 射击游戏 三角洲行动
- 游戏 游戏类型 射击游戏 codm（使命召唤）
- 母婴 婴童洗护 安全防晒
- 母婴 婴童洗护 浴后护理
- 母婴 婴童洗护 敏感修护
- 母婴 婴童洗护 屏障树立
- 母婴 婴童洗护 泳后护理
- 母婴 婴童洗护 口周干裂
- 母婴 婴童洗护 分区清洁
- 母婴 婴童洗护 头皮问题
- 母婴 婴童洗护 驱虫驱蚊
- 母婴 婴童洗护 洁面清洁
- 母婴 婴童洗护 红屁股
- 母婴 婴童洗护 湿疹皮炎
- 母婴 婴童洗护 痱子热疹
- 母婴 婴童洗护 抚触链接
- 母婴 婴童洗护 趣味洗护
- 母婴 母婴纸品 精算育儿
- 母婴 母婴纸品 颜值派
- 母婴 母婴纸品 汗宝宝
- 母婴 母婴纸品 囤货党
- 母婴 母婴纸品 敏感肌
- 母婴 母婴纸品 肉腿娃
- 母婴 母婴纸品 功课党
- 母婴 母婴纸品 好动宝
- 母婴 母婴纸品 安睡整夜
- 母婴 母婴纸品 出行便携
- 母婴 母婴纸品 贵妇体验
- 母婴 母婴纸品 红屁屁
- 母婴 母婴小家电 空间收纳
- 母婴 母婴小家电 滋补养生
- 母婴 母婴小家电 温度把控
- 母婴 母婴小家电 夜奶操作
- 母婴 母婴小家电 新手喂养
- 母婴 母婴小家电 材质挑选
- 母婴 母婴小家电 三代同育
- 母婴 母婴小家电 户外喂养
- 母婴 母婴小家电 通乳攻略
- 母婴 母婴小家电 洁癖爸妈
- 母婴 母婴小家电 精准喂养
- 母婴 母婴小家电 职场妈妈
- 母婴 婴童辅食 吞咽能力
- 母婴 婴童辅食 多元辅食
- 母婴 婴童辅食 零食分享
- 母婴 婴童辅食 健康零食
- 母婴 婴童辅食 放学加餐
- 母婴 婴童辅食 出牙磨牙
- 母婴 婴童辅食 居家囤货
- 母婴 婴童辅食 节日礼包
- 母婴 婴童辅食 零食训练
- 母婴 婴童辅食 宝宝挑食
- 母婴 婴童辅食 户外零食
- 母婴 婴童辅食 低敏辅食
- 母婴 婴童辅食 入园社交
- 母婴 婴童辅食 居家辅食
- 母婴 婴童辅食 入园准备
- 母婴 婴童辅食 敏敏零食
- 母婴 婴童辅食 抓握训练
- 母婴 婴童辅食 外出口粮
- 母婴 婴童辅食 营养均衡
- 母婴 婴童辅食 自主进食
- 母婴 婴童辅食 第一口辅食
- 母婴 母婴营养品 开胃因子
- 母婴 母婴营养品 视力保护
- 母婴 母婴营养品 营养补充
- 母婴 母婴营养品 防护因子
- 母婴 母婴营养品 高钙因子
- 母婴 母婴营养品 自护构建
- 母婴 母婴营养品 发育表现
- 母婴 母婴营养品 助眠安睡
- 母婴 婴童奶粉 丝滑转奶
- 母婴 婴童奶粉 益生组合
- 母婴 婴童奶粉 眼脑体发育
- 母婴 婴童奶粉 选奶功课
- 母婴 婴童奶粉 防敏脱敏
- 母婴 婴童奶粉 助力聪明脑
- 母婴 婴童奶粉 乳铁自护
- 母婴 婴童奶粉 黄金长高
- 母婴 婴童奶粉 内修外护
- 母婴 婴童奶粉 肚肚吸收
- 母婴 婴童奶粉 断奶攻略
- 母婴 婴童奶粉 混合喂养
- 母婴 婴童奶粉 母源黄金HMO
- 母婴 婴童奶粉 长肉多肉
- 母婴 哺乳喂养工具 萌娃穿搭
- 母婴 哺乳喂养工具 安全材质
- 母婴 哺乳喂养工具 奶瓶喂养
- 母婴 哺乳喂养工具 颜值发育
- 母婴 哺乳喂养工具 哄娃安抚
- 母婴 哺乳喂养工具 餐具选购
- 母婴 哺乳喂养工具 学饮指南
- 母婴 哺乳喂养工具 换季保温
- 母婴 母婴孕产 职场孕妇
- 母婴 母婴孕产 产后复工
- 母婴 母婴孕产 顺产
- 母婴 母婴孕产 孕期变化
- 母婴 母婴孕产 孕期学习
- 母婴 母婴孕产 剖腹产
- 母婴 母婴家居 护脊深睡
- 母婴 母婴家居 安全翻滚
- 母婴 母婴家居 进食习惯
- 母婴 母婴家居 早教启蒙
- 母婴 母婴家居 学习角落
- 母婴 母婴家居 自主入睡
- 母婴 母婴家居 爬行探索
- 母婴 母婴家居 防惊跳
- 母婴 母婴出行&用品 长线旅途
- 母婴 母婴出行&用品 户外探索
- 母婴 母婴出行&用品 二胎/双胎
- 母婴 母婴出行&用品 新贵消费
- 母婴 母婴出行&用品 备产研究
- 母婴 母婴出行&用品 短途旅行
- 母婴 母婴出行&用品 高频出行
- 母婴 母婴出行&用品 新生出行
- 母婴 母婴出行&用品 务实精算
- 母婴 母婴出行&用品 遛娃必备
- personalTags (query): 博主人物标签筛选。传入一个或多个蒲公英人物标签，用英文或中文逗号分隔。
可选值：
- 妈妈
- 萌娃
- 爸爸
- 奶奶
- 情侣
- 夫妻
- 家庭
- 闺蜜
- 兄弟
- 备孕中
- 孕期中
- 12岁以上
- 传统行业
- 互联网
- 教育科研
- 金融法律
- 企业创业
- 时尚美妆
- 食品饮料
- 文化传媒
- 医疗健康
- 艺术设计
- 影视娱乐
- 运动健身
- 专业服务
- 工程师
- 销售
- HR
- 教练
- 运动员
- 舞蹈老师
- 生活背景
- 备考经验
- 兴趣爱好
- 留学背景
- 海外华人
- 铲屎官
- 孕妈
- 独居人群
- 外国人
- 混血儿
示例：
- 妈妈,教练,运动员,舞蹈老师,留学背景
- marketTarget (query): 营销目标筛选。传入一个蒲公英营销目标值。
可用值：
- estimateAllCpm：曝光 - 曝光表现 - 成本
- mAccumImpNum：曝光 - 曝光表现 - 规模
- readCost：曝光 - 阅读表现 - 成本
- mValidRawReadFeedNum：曝光 - 阅读表现 - 规模
- estimateEngageCost：种草 - 互动表现 - 成本
- mEngagementNum90d：种草 - 互动表现 - 规模
- estimateCpuv：转化 - 站外访问表现 - 成本
- mCpuvNum：转化 - 站外访问表现 - 规模
示例：
- estimateAllCpm
- audienceGroup (query): 受众定向筛选。传入蒲公英受众群体ID（`dmpGroupId`），用英文或中文逗号分隔。这些ID是动态且特定于账号的，因此没有固定的全局值列表。使用蒲公英受众管理中显示的受众群体名称来识别每个ID的含义。
示例：
- 123456,789012
- top20CrowdsLabel (query): Top-20受众筛选。传入一级或子级受众标签，用逗号分隔；子级标签会转换为蒲公英请求值。
- industrySpecificCrowdsMotorDom (query): 行业画像筛选。传入蒲公英画像值ID或标签值，用逗号分隔。
- featureTags (query): 擅长内容标签筛选。传入标签值，用逗号分隔。
- contentThemeLabel (query): 内容主题筛选。传入蒲公英值ID或标签值，用逗号分隔；标签会转换为值ID。
- excludeLowActive (query): 是否排除低活跃度博主。
- fansNumUp (query): 是否排除粉丝数下降的博主。
- noteType (query): 笔记类型筛选。值：ALL=所有笔记类型，PHOTO_TEXT=图文笔记为主，VIDEO=视频笔记为主。
可用值：
- `ALL`：所有笔记类型
- `PHOTO_TEXT`：图文笔记为主
- `VIDEO`：视频笔记为主
- industry (query): 蒲公英行业预设，用于行业助手风格的创作者推荐。
可用值：
- `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`：教育培训 - K12教育
- `EDUCATION_TRAINING_DEGREE_EDUCATION`：教育培训 - 学历教育
- `EDUCATION_TRAINING_CORPORATE_DEVELOPMENT`：教育培训 - 企业团建
- `EDUCATION_TRAINING_OTHER`：教育培训 - 其他
- `GAMES`：游戏
- `TRAVEL_TOURISM`：旅游出行
- accumCommonImpMedinNum30d (query): 日常笔记曝光量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。
- readMidNor30 (query): 日常笔记阅读量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。
- interMidNor30 (query): 日常笔记互动量中位数范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。
- thousandLikePercent30 (query): 千赞笔记比例范围。传入小数比例如 0.4,null 或百分比值如 40,null。
- notePrice (query): 图文合作报价范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。
- videoPrice (query): 视频合作报价范围。传入两个逗号分隔的数值边界；使用 -1 或 null 表示无上限。
- inviteReply48hNumRatio (query): 48小时邀约回复率范围。传入小数比例如 0.9,0.95 或百分比值如 90,95。
- progressOrderCnt (query): 当前合作订单数量范围。传入两个逗号分隔的数值边界。
- tradeType (query): 来自蒲公英的近期合作行业筛选。
- tradeReportBrandIds (query): 近期合作品牌ID，以英文或中文逗号分隔。
- excludeTradeReportBrandIds (query): 是否排除与所选近期合作品牌合作过的创作者。
- accumCoopImpMedinNum30d (query): 合作笔记曝光量中位数范围。传入两个逗号分隔的数值边界。
- readMidCoop30 (query): 合作笔记阅读量中位数范围。传入两个逗号分隔的数值边界。
- interMidCoop30 (query): 合作笔记互动量中位数范围。传入两个逗号分隔的数值边界。
- mCpuvNum30d (query): 合作笔记外站中位数范围。传入两个逗号分隔的数值边界。
- estimatePictureCpm (query): 预估图文CPM范围。传入两个逗号分隔的数值边界。
- estimateVideoCpm (query): 预估视频CPM范围。传入两个逗号分隔的数值边界。
- estimatePicReadPrice (query): 预估图文阅读单价范围。传入两个逗号分隔的数值边界。
- estimateVideoReadPrice (query): 预估视频阅读单价范围。传入两个逗号分隔的数值边界。
- estimatePictureEngageCost (query): 预估图文互动单价范围。传入两个逗号分隔的数值边界。
- estimateVideoEngageCost (query): 预估视频互动单价范围。传入两个逗号分隔的数值边界。
- estimateCpuv30d (query): 预估外店访问单价范围。传入两个逗号分隔的数值边界。
- kliveCnt30d (query): 近30天直播次数范围。传入两个逗号分隔的数值边界。
- avgLiveViewerNum (query): 平均直播观看人数范围。传入两个逗号分隔的数值边界。
- avgAgmv90d (query): 平均直播销售额范围。传入两个逗号分隔的数值边界。
- similarUserId (query): 相似创作者用户ID。`similarUserId` 和 `similarWord` 必须同时提供。
- similarWord (query): 蒲公英显示的相似创作者关键词。`similarUserId` 和 `similarWord` 必须同时提供。
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为 120 秒；如果 120 秒偏长，请至少设置为 60 秒，但可能会有少量请求因超时而未接收到结果。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 账户余额不足
- 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨，多个 TOKEN 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 大陆用户可改为 "http://47.117.133.51:30015"
url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY"
response = requests.get(url)
print(response.json())js
const BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
const url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY";
const response = await fetch(url, {
method: "GET"
});
const data = await response.json();
console.log(data);java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
final String url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
package main
import (
"fmt"
"io"
"net/http"
)
const BASE_URL = "https://api.justoneapi.com" // 大陆用户可改为 "http://47.117.133.51:30015"
func main() {
client := &http.Client{}
url := BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
<?php
$BASE_URL = "https://api.justoneapi.com"; // 大陆用户可改为 "http://47.117.133.51:30015"
$url = $BASE_URL . "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果示例
正在加载最新成功示例…