Skip to content

小红书蒲公英创作者搜索 API (V1)

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

使用关键词、受众、位置、内容、定价、表现、合作、直播和相似度筛选条件搜索小红书蒲公英创作者。用于构建活动创作者候选名单。

请求参数

参数名位置类型必填默认值说明
tokenquerystring-用户鉴权令牌。
searchTypequerystringNICKNAME搜索条件类型。


可用值:

- NICKNAME:按昵称搜索

- NOTE:按备注内容搜索
keywordquerystring-搜索关键词。
pagequeryinteger1页码。
sortquerystringFANS创作者搜索排序。可选值:FANS 按粉丝数降序排序,DEFAULT 使用蒲公英智能排序。


可选值:

- DEFAULT:平台默认智能排序

- FANS:按粉丝数降序排序
fansNumberLowerqueryinteger-最低粉丝数。
fansNumberUpperqueryinteger-最大粉丝数。
fansAgequerystringALL目标粉丝年龄群体。


可用值:

- ALL: 所有年龄段

- LT_18: 18岁以下

- AGE_18_24: 18至24岁

- AGE_25_34: 25至34岁

- AGE_35_44: 35至44岁

- GT_44: 44岁以上
fansGenderquerystringALL目标粉丝性别。


可用值:

- ALL: 所有性别

- MALE_HIGH: 主要男性

- FE_MALE_HIGH: 主要女性
fansChildAgeInfoquerystring-母婴人群阶段筛选。传入蒲公英标签或数字编码,用英文或中文逗号分隔。


可选值:

- 1: 备孕

- 2: 0-6月

- 3: 7-12月

- 4: 1-3岁

- 5: 4-6岁

- 6: 7-12岁

- 7: 孕早期

- 8: 孕晚期
genderquerystringALLKOL的性别。


可选值:

- ALL: 所有性别

- MALE: 男性

- FEMALE: 女性
locationquerystring-创作者所在地筛选。传入蒲公英所在地标签,用英文或中文逗号分隔。支持国家、中国省份或地区、城市级路径以及区县级路径。中国省份或地区的短标签会被规范化为完整的蒲公英值。仅接受蒲公英所在地树中存在的路径。诸如 河北 秦皇岛山西 长治 潞州区中国 山西 长治 潞州区 的路径会被规范化为 中国 山西 长治 潞州区 等值。


可用的国家/省份基础值:

- 中国

- 美国

- 日本

- 澳大利亚

- 英国

- 加拿大

- 韩国

- 法国

- 德国

- 新加坡

- 其他

- 中国 北京

- 中国 天津

- 中国 河北

- 中国 山西

- 中国 内蒙古

- 中国 辽宁

- 中国 吉林

- 中国 黑龙江

- 中国 上海

- 中国 江苏

- 中国 浙江

- 中国 安徽

- 中国 福建

- 中国 江西

- 中国 山东

- 中国 河南

- 中国 湖北

- 中国 湖南

- 中国 广东

- 中国 广西

- 中国 海南

- 中国 重庆

- 中国 四川

- 中国 贵州

- 中国 云南

- 中国 西藏

- 中国 陕西

- 中国 甘肃

- 中国 青海

- 中国 宁夏

- 中国 新疆

- 中国 澳门

- 中国 台湾

- 中国 香港


示例:

- 广东,中国 上海,河北 秦皇岛,山西 长治 潞州区
contentTagquerystring-内容分类筛选。传入蒲公英一级或二级分类标签,用逗号分隔。


可选值:

- 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他

- 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他

- 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他

- 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才艺, 宝宝写真, 母婴其他

- 时尚: 穿搭, 配饰, 发型, 箱包, 鞋靴, 时尚其他

- 美食: 美食教程, 美食探店, 美食展示, 美食测评, 吃播, 美食其他

- 家居家装: 装修, 家居用品, 家居装饰, 家具, 家电, 室内设计, 居家经验, 家居家装其他

- 影视综资讯: 动漫, 电影, 电视, 娱乐资讯, 影视, 民生资讯, 综艺, 影视综其他

- 运动健身: 健身减肥, 健身塑形, 滑雪, 滑板, 水上活动, 运动其他, 足球, 篮球, 跑步, 游泳

- 宠物: 猫, 狗, 动物其他

- 文化艺术: 社科, 文化, 艺术, 文化艺术其他

- 兴趣爱好: 绘画, 手工, 阅读, 文具手账, 舞蹈, 益智玩具, 潮流玩具, 兴趣爱好其他

- 生活记录: 接地气生活, 日常片段, 中外生活, 品质生活, 校园生活

- 教育: 大学教育, k12教育, 家庭教育, 学习日常, 职场教育, 教育其他

- 情感: 情感知识, 情感日常, 情感其他

- 摄影: 人文风光摄影, 摄影技巧, 胶片摄影, 人像摄影, 摄影其他

- 游戏: 手机游戏, 主机游戏, 游戏其他, 线下游戏

- 科技数码: 数码, 玩机攻略, 数码科技其他

- 出行: 城市出行, 户外, 旅行

- 音乐

- 搞笑

- 健康养生

- 汽车

- 婚嫁: 婚礼造型, 婚礼记录, 婚礼经验, 婚礼用品

- 商业财经

- 素材

- 其他
contentSceneLabelquerystring-内容场景标签筛选。传入完整的蒲公英笔记分类场景标签路径,用英文或中文逗号分隔。


可选值:

- 汽车 理性决策 选车攻略 政策

- 汽车 理性决策 选车攻略 购车顾虑

- 汽车 理性决策 选车攻略 配置

- 汽车 理性决策 选车攻略 能源类型优势对比

- 汽车 理性决策 选车攻略 攻略

- 汽车 理性决策 新车测评

- 汽车 理性决策 探店试驾

- 汽车 理性决策 车主心得

- 汽车 用车场景 远行近游 近郊探索

- 汽车 用车场景 远行近游 长途自驾

- 汽车 用车场景 远行近游 硬核越野

- 汽车 用车场景 提车/交付场景 场地布置与礼遇

- 汽车 用车场景 提车/交付场景 仪式感记录

- 汽车 用车场景 商务用车 移动头等舱

- 汽车 用车场景 商务用车 商务接待

- 汽车 用车场景 亲子家庭 家庭采购日

- 汽车 用车场景 亲子家庭 接送孩子

- 汽车 用车场景 亲子家庭 三代同堂

- 汽车 用车场景 亲子家庭 周末溜娃

- 汽车 用车场景 亲子家庭 车内学习室

- 汽车 用车场景 亲子家庭 车内育婴室

- 汽车 用车场景 朋友社交 后备箱经济

- 汽车 用车场景 朋友社交 移动娱乐屋

- 汽车 用车场景 礼赠场景 毕业礼物

- 汽车 用车场景 礼赠场景 送给父母

- 汽车 用车场景 礼赠场景 适合送男友

- 汽车 用车场景 礼赠场景 适合送女友

- 汽车 用车场景 户外兴趣 钓鱼/野营

- 汽车 用车场景 户外兴趣 骑行

- 汽车 用车场景 户外兴趣 徒步

- 汽车 用车场景 户外兴趣 硬核竞速

- 汽车 用车场景 宠物出行 大型宠物

- 汽车 用车场景 宠物出行 短途出行

- 汽车 用车场景 宠物出行 小型宠物

- 汽车 用车场景 宠物出行 长途出行

- 汽车 用车场景 城市通勤 车内小憩

- 汽车 用车场景 城市通勤 健身储物

- 汽车 用车场景 城市通勤 日常通勤

- 汽车 用车场景 城市通勤 生活圈代步

- 汽车 用车场景 城市通勤 移动美容舱

- 汽车 个性化美化 个性改装

- 汽车 个性化美化 储物收纳

- 汽车 个性化美化 车内装饰

- 汽车 个性化美化 车外装饰

- 汽车 个性化美化 车衣保护

- 汽车 个性化美化 汽车用品

- 汽车 车型品类 轿车

- 汽车 车型品类 SUV

- 汽车 车型品类 MPV

- 汽车 车型品类 跑车

- 汽车 车型品类 微型车

- 汽车 车型品类 微面

- 汽车 车型品类 房车

- 汽车 车型品类 越野车

- 汽车 车型品类 旅行车

- 汽车 圈层属性 改装圈层

- 汽车 圈层属性 痛车圈层

- 汽车 圈层属性 跑山圈层

- 汽车 品牌倾向 自主

- 汽车 品牌倾向 豪华

- 汽车 品牌倾向 集团

- 汽车 品牌倾向 新势力

- 汽车 能源类型 纯电车

- 汽车 能源类型 新能源

- 汽车 能源类型 油车

- 汽车 人生阶段 单身

- 汽车 人生阶段 多娃&大家庭阶段

- 汽车 人生阶段 银发退休阶段

- 游戏 游戏品类 网页游戏

- 游戏 游戏品类 电脑游戏

- 游戏 游戏品类 手机游戏

- 游戏 游戏类型 动作格斗游戏 永劫无间

- 游戏 游戏类型 即时制二次元游戏 境界刀鸣

- 游戏 游戏类型 即时制二次元游戏 黑色信标

- 游戏 游戏类型 即时制二次元游戏 物华弥新

- 游戏 游戏类型 即时制二次元游戏 无期迷途

- 游戏 游戏类型 即时制二次元游戏 新月同行

- 游戏 游戏类型 即时制二次元游戏 绝区零

- 游戏 游戏类型 即时制角色扮演 诛仙2

- 游戏 游戏类型 即时制角色扮演 诛仙

- 游戏 游戏类型 即时制角色扮演 明日之后

- 游戏 游戏类型 即时制角色扮演 超自然行动组

- 游戏 游戏类型 即时制角色扮演 永恒之塔2

- 游戏 游戏类型 回合制二次元游戏 未定事件簿

- 游戏 游戏类型 回合制二次元游戏 雷索纳斯

- 游戏 游戏类型 回合制二次元游戏 浮生忆玲珑

- 游戏 游戏类型 回合制二次元游戏 重返未来1999

- 游戏 游戏类型 回合制角色扮演 梦幻西游手游

- 游戏 游戏类型 回合制角色扮演 龙魂旅人

- 游戏 游戏类型 回合制角色扮演 最终幻想14

- 游戏 游戏类型 塔防游戏 保卫向日葵

- 游戏 游戏类型 塔防游戏 全境守卫

- 游戏 游戏类型 塔防游戏 向僵尸开炮

- 游戏 游戏类型 开放世界角色扮演 燕云十六声

- 游戏 游戏类型 开放世界角色扮演 王者荣耀世界

- 游戏 游戏类型 恋爱游戏 如鸢

- 游戏 游戏类型 恋爱游戏 银与绯

- 游戏 游戏类型 恋爱游戏 时空中的绘旅人

- 游戏 游戏类型 恋爱游戏 光与夜之恋

- 游戏 游戏类型 恋爱游戏 恋与深空

- 游戏 游戏类型 恋爱游戏 恋与制作人

- 游戏 游戏类型 战略游戏 率土之滨

- 游戏 游戏类型 战略游戏 群星纪元

- 游戏 游戏类型 战略游戏 阿瓦隆之王

- 游戏 游戏类型 战略游戏 快来当领主

- 游戏 游戏类型 战略游戏 冒险之星

- 游戏 游戏类型 战略游戏 无尽的拉格朗日

- 游戏 游戏类型 放置类二次元游戏 花花与幕间剧

- 游戏 游戏类型 放置类角色扮演 发条总动员

- 游戏 游戏类型 放置类角色扮演 遮天凡尘一叶

- 游戏 游戏类型 模拟养成 美人传

- 游戏 游戏类型 模拟养成 盲盒派对

- 游戏 游戏类型 模拟养成 闪耀暖暖

- 游戏 游戏类型 模拟养成 以闪亮之名

- 游戏 游戏类型 模拟养成 无限暖暖

- 游戏 游戏类型 模拟家园建造 江南百景图

- 游戏 游戏类型 模拟家园建造 动物森友会

- 游戏 游戏类型 模拟家园建造 星露谷物语

- 游戏 游戏类型 模拟经营 暴吵萌厨

- 游戏 游戏类型 模拟经营 肥鹅健身房

- 游戏 游戏类型 模拟经营 杜拉拉升职记

- 游戏 游戏类型 消除游戏 四季合合

- 游戏 游戏类型 生存沙盒游戏 无尽冬日

- 游戏 游戏类型 聚会游戏 蛋仔派对

- 游戏 游戏类型 聚会游戏 代号砰砰

- 游戏 游戏类型 解谜游戏 晴空之下

- 游戏 游戏类型 抓宠类游戏 洛克王国手游

- 游戏 游戏类型 射击游戏 三角洲行动

- 游戏 游戏类型 射击游戏 codm(使命召唤)

- 母婴 婴童洗护 安全防晒

- 母婴 婴童洗护 浴后护理

- 母婴 婴童洗护 敏感修护

- 母婴 婴童洗护 屏障树立

- 母婴 婴童洗护 泳后护理

- 母婴 婴童洗护 口周干裂

- 母婴 婴童洗护 分区清洁

- 母婴 婴童洗护 头皮问题

- 母婴 婴童洗护 驱虫驱蚊

- 母婴 婴童洗护 洁面清洁

- 母婴 婴童洗护 红屁股

- 母婴 婴童洗护 湿疹皮炎

- 母婴 婴童洗护 痱子热疹

- 母婴 婴童洗护 抚触链接

- 母婴 婴童洗护 趣味洗护

- 母婴 母婴纸品 精算育儿

- 母婴 母婴纸品 颜值派

- 母婴 母婴纸品 汗宝宝

- 母婴 母婴纸品 囤货党

- 母婴 母婴纸品 敏感肌

- 母婴 母婴纸品 肉腿娃

- 母婴 母婴纸品 功课党

- 母婴 母婴纸品 好动宝

- 母婴 母婴纸品 安睡整夜

- 母婴 母婴纸品 出行便携

- 母婴 母婴纸品 贵妇体验

- 母婴 母婴纸品 红屁屁

- 母婴 母婴小家电 空间收纳

- 母婴 母婴小家电 滋补养生

- 母婴 母婴小家电 温度把控

- 母婴 母婴小家电 夜奶操作

- 母婴 母婴小家电 新手喂养

- 母婴 母婴小家电 材质挑选

- 母婴 母婴小家电 三代同育

- 母婴 母婴小家电 户外喂养

- 母婴 母婴小家电 通乳攻略

- 母婴 母婴小家电 洁癖爸妈

- 母婴 母婴小家电 精准喂养

- 母婴 母婴小家电 职场妈妈

- 母婴 婴童辅食 吞咽能力

- 母婴 婴童辅食 多元辅食

- 母婴 婴童辅食 零食分享

- 母婴 婴童辅食 健康零食

- 母婴 婴童辅食 放学加餐

- 母婴 婴童辅食 出牙磨牙

- 母婴 婴童辅食 居家囤货

- 母婴 婴童辅食 节日礼包

- 母婴 婴童辅食 零食训练

- 母婴 婴童辅食 宝宝挑食

- 母婴 婴童辅食 户外零食

- 母婴 婴童辅食 低敏辅食

- 母婴 婴童辅食 入园社交

- 母婴 婴童辅食 居家辅食

- 母婴 婴童辅食 入园准备

- 母婴 婴童辅食 敏敏零食

- 母婴 婴童辅食 抓握训练

- 母婴 婴童辅食 外出口粮

- 母婴 婴童辅食 营养均衡

- 母婴 婴童辅食 自主进食

- 母婴 婴童辅食 第一口辅食

- 母婴 母婴营养品 开胃因子

- 母婴 母婴营养品 视力保护

- 母婴 母婴营养品 营养补充

- 母婴 母婴营养品 防护因子

- 母婴 母婴营养品 高钙因子

- 母婴 母婴营养品 自护构建

- 母婴 母婴营养品 发育表现

- 母婴 母婴营养品 助眠安睡

- 母婴 婴童奶粉 丝滑转奶

- 母婴 婴童奶粉 益生组合

- 母婴 婴童奶粉 眼脑体发育

- 母婴 婴童奶粉 选奶功课

- 母婴 婴童奶粉 防敏脱敏

- 母婴 婴童奶粉 助力聪明脑

- 母婴 婴童奶粉 乳铁自护

- 母婴 婴童奶粉 黄金长高

- 母婴 婴童奶粉 内修外护

- 母婴 婴童奶粉 肚肚吸收

- 母婴 婴童奶粉 断奶攻略

- 母婴 婴童奶粉 混合喂养

- 母婴 婴童奶粉 母源黄金HMO

- 母婴 婴童奶粉 长肉多肉

- 母婴 哺乳喂养工具 萌娃穿搭

- 母婴 哺乳喂养工具 安全材质

- 母婴 哺乳喂养工具 奶瓶喂养

- 母婴 哺乳喂养工具 颜值发育

- 母婴 哺乳喂养工具 哄娃安抚

- 母婴 哺乳喂养工具 餐具选购

- 母婴 哺乳喂养工具 学饮指南

- 母婴 哺乳喂养工具 换季保温

- 母婴 母婴孕产 职场孕妇

- 母婴 母婴孕产 产后复工

- 母婴 母婴孕产 顺产

- 母婴 母婴孕产 孕期变化

- 母婴 母婴孕产 孕期学习

- 母婴 母婴孕产 剖腹产

- 母婴 母婴家居 护脊深睡

- 母婴 母婴家居 安全翻滚

- 母婴 母婴家居 进食习惯

- 母婴 母婴家居 早教启蒙

- 母婴 母婴家居 学习角落

- 母婴 母婴家居 自主入睡

- 母婴 母婴家居 爬行探索

- 母婴 母婴家居 防惊跳

- 母婴 母婴出行&用品 长线旅途

- 母婴 母婴出行&用品 户外探索

- 母婴 母婴出行&用品 二胎/双胎

- 母婴 母婴出行&用品 新贵消费

- 母婴 母婴出行&用品 备产研究

- 母婴 母婴出行&用品 短途旅行

- 母婴 母婴出行&用品 高频出行

- 母婴 母婴出行&用品 新生出行

- 母婴 母婴出行&用品 务实精算

- 母婴 母婴出行&用品 遛娃必备
personalTagsquerystring-博主人物标签筛选。传入一个或多个蒲公英人物标签,用英文或中文逗号分隔。


可选值:

- 妈妈

- 萌娃

- 爸爸

- 奶奶

- 情侣

- 夫妻

- 家庭

- 闺蜜

- 兄弟

- 备孕中

- 孕期中

- 12岁以上

- 传统行业

- 互联网

- 教育科研

- 金融法律

- 企业创业

- 时尚美妆

- 食品饮料

- 文化传媒

- 医疗健康

- 艺术设计

- 影视娱乐

- 运动健身

- 专业服务

- 工程师

- 销售

- HR

- 教练

- 运动员

- 舞蹈老师

- 生活背景

- 备考经验

- 兴趣爱好

- 留学背景

- 海外华人

- 铲屎官

- 孕妈

- 独居人群

- 外国人

- 混血儿


示例:

- 妈妈,教练,运动员,舞蹈老师,留学背景
marketTargetquerystring-营销目标筛选。传入一个蒲公英营销目标值。


可选值:

- estimateAllCpm:曝光 - 曝光表现 - 成本

- mAccumImpNum:曝光 - 曝光表现 - 规模

- readCost:曝光 - 阅读表现 - 成本

- mValidRawReadFeedNum:曝光 - 阅读表现 - 规模

- estimateEngageCost:种草 - 互动表现 - 成本

- mEngagementNum90d:种草 - 互动表现 - 规模

- estimateCpuv:转化 - 站外访问表现 - 成本

- mCpuvNum:转化 - 站外访问表现 - 规模
audienceGroupquerystring-受众定向筛选。传入用英文或中文逗号分隔的蒲公英受众组ID(dmpGroupId)。这些ID是动态且与账户相关的,因此没有固定的全局值列表。使用蒲公英受众管理中显示的受众组名称来理解每个ID的含义。
top20CrowdsLabelquerystring-Top-20受众筛选。传入一级或子级受众标签,用逗号分隔;子级标签会转换为蒲公英请求值。
industrySpecificCrowdsMotorDomquerystring-行业画像筛选。传入蒲公英画像值ID或标签值,用逗号分隔。
featureTagsquerystring-擅长内容标签筛选。传入标签值,用逗号分隔。
contentThemeLabelquerystring-内容主题筛选。传入蒲公英值ID或标签值,用逗号分隔;标签会转换为值ID。
excludeLowActivequeryboolean-是否排除低活跃度博主。
fansNumUpqueryboolean-是否排除粉丝数下降的博主。
noteTypequerystringALL笔记类型筛选。值:ALL=所有笔记类型,PHOTO_TEXT=图文笔记为主,VIDEO=视频笔记为主。


可用值:

- ALL:所有笔记类型

- PHOTO_TEXT:图文笔记为主

- VIDEO:视频笔记为主
industryquerystring-蒲公英行业预设,用于行业助手风格的创作者推荐。


可用值:

- 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:旅游出行
accumCommonImpMedinNum30dquerystring-日常笔记曝光量中位数范围。传入两个逗号分隔的数值边界;使用 -1 或 null 表示无上限。
readMidNor30querystring-日常笔记阅读量中位数范围。传入两个逗号分隔的数值边界;使用 -1 或 null 表示无上限。
interMidNor30querystring-日常笔记互动量中位数范围。传入两个逗号分隔的数值边界;使用 -1 或 null 表示无上限。
thousandLikePercent30querystring-千赞笔记比例范围。传入小数比例如 0.4,null 或百分比值如 40,null。
notePricequerystring-图文合作报价范围。传入两个逗号分隔的数值边界;使用 -1 或 null 表示无上限。
videoPricequerystring-视频合作报价范围。传入两个逗号分隔的数值边界;使用 -1 或 null 表示无上限。
inviteReply48hNumRatioquerystring-48小时邀约回复率范围。传入小数比例如 0.9,0.95 或百分比值如 90,95。
progressOrderCntquerystring-当前合作订单数量范围。传入两个逗号分隔的数值边界。
tradeTypequerystring-来自蒲公英的近期合作行业筛选。
tradeReportBrandIdsquerystring-近期合作品牌ID,以英文或中文逗号分隔。
excludeTradeReportBrandIdsqueryboolean-是否排除与所选近期合作品牌合作过的创作者。
accumCoopImpMedinNum30dquerystring-合作笔记曝光量中位数范围。传入两个逗号分隔的数值边界。
readMidCoop30querystring-合作笔记阅读量中位数范围。传入两个逗号分隔的数值边界。
interMidCoop30querystring-合作笔记互动量中位数范围。传入两个逗号分隔的数值边界。
mCpuvNum30dquerystring-合作笔记外站中位数范围。传入两个逗号分隔的数值边界。
estimatePictureCpmquerystring-预估图文CPM范围。传入两个逗号分隔的数值边界。
estimateVideoCpmquerystring-预估视频CPM范围。传入两个逗号分隔的数值边界。
estimatePicReadPricequerystring-预估图文阅读单价范围。传入两个逗号分隔的数值边界。
estimateVideoReadPricequerystring-预估视频阅读单价范围。传入两个逗号分隔的数值边界。
estimatePictureEngageCostquerystring-预估图文互动单价范围。传入两个逗号分隔的数值边界。
estimateVideoEngageCostquerystring-预估视频互动单价范围。传入两个逗号分隔的数值边界。
estimateCpuv30dquerystring-预估外店访问单价范围。传入两个逗号分隔的数值边界。
kliveCnt30dquerystring-近30天直播次数范围。传入两个逗号分隔的数值边界。
avgLiveViewerNumquerystring-平均直播观看人数范围。传入两个逗号分隔的数值边界。
avgAgmv90dquerystring-平均直播销售额范围。传入两个逗号分隔的数值边界。
similarUserIdquerystring-相似创作者用户ID。similarUserIdsimilarWord 必须同时提供。
similarWordquerystring-蒲公英显示的相似创作者关键词。similarUserIdsimilarWord 必须同时提供。
fansLocationquerystring-粉丝受众所在地筛选。传入蒲公英粉丝地区标签,用英文或中文逗号分隔。支持国家、中国省份和城市级路径;不接受区县级路径。仅接受蒲公英粉丝地区树中存在的路径。使用城市路径,如 福建 南平福建-南平中国 福建 南平;它们会被规范化为 中国 福建 南平 等值。


示例:

- 福建 南平

- 中国 福建 南平,广东

代码示例

bash
curl --max-time 120 -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。
接口路径: /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:转化 - 站外访问表现 - 规模

- audienceGroup (query): 受众定向筛选。传入用英文或中文逗号分隔的蒲公英受众组ID(`dmpGroupId`)。这些ID是动态且与账户相关的,因此没有固定的全局值列表。使用蒲公英受众管理中显示的受众组名称来理解每个ID的含义。

- 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` 必须同时提供。
- fansLocation (query): 粉丝受众所在地筛选。传入蒲公英粉丝地区标签,用英文或中文逗号分隔。支持国家、中国省份和城市级路径;不接受区县级路径。仅接受蒲公英粉丝地区树中存在的路径。使用城市路径,如 `福建 南平`、`福建-南平` 或 `中国 福建 南平`;它们会被规范化为 `中国 福建 南平` 等值。

示例:
- 福建 南平
- 中国 福建 南平,广东

返回格式: 请根据实际 Content-Type 安全处理 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"  # 由 OpenAPI servers 提供

url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
        final String url = BASE_URL + "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1?token=YOUR_API_KEY";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
go
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	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()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$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_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}

响应示例

正在加载响应示例…