{ "openapi": "3.1.0", "info": { "title": "Xiaohongshu Creator Marketplace (Pugongying) Creator Search API (V1)", "version": "v0", "description": "Search Xiaohongshu Pugongying creators with keyword, audience, location, content, pricing, performance, cooperation, live, and similarity filters. Use it to build a campaign creator shortlist." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "Xiaohongshu Creator Marketplace (Pugongying)", "description": "Xiaohongshu creator marketplace profiles, audience insights, content performance, and campaign analytics.", "x-platform-id": "xiaohongshu-creator-marketplace-pugongying", "x-platform-aliases": [ "Xiaohongshu Pugongying", "Pugongying", "小红书蒲公英", "蒲公英" ], "x-platform-detection-aliases": [ "Xiaohongshu Pugongying", "Pugongying", "小红书蒲公英", "蒲公英" ] } ], "paths": { "/api/xiaohongshu-pgy/api/solar/cooperator/blogger/v2/v1": { "get": { "tags": [ "Xiaohongshu Creator Marketplace (Pugongying)" ], "summary": "Creator Search", "description": "Search Xiaohongshu Pugongying creators with keyword, audience, location, content, pricing, performance, cooperation, live, and similarity filters. Use it to build a campaign creator shortlist.", "operationId": "getApiXiaohongshuPgyApiSolarCooperatorBloggerV2V1", "parameters": [ { "name": "token", "in": "query", "description": "User authentication token.", "required": true, "schema": { "type": "string" } }, { "name": "searchType", "in": "query", "description": "Search criteria type.\n\nAvailable Values:\n- `NICKNAME`: Search by nickname\n- `NOTE`: Search by note content", "required": false, "schema": { "type": "string", "default": "NICKNAME", "description": "Search Type", "enum": [ "NICKNAME", "NOTE" ] } }, { "name": "keyword", "in": "query", "description": "Search keyword.", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "sort", "in": "query", "description": "Creator search sorting. Values: FANS sorts by follower count descending, DEFAULT uses Pugongying intelligent ranking.\n\nAvailable Values:\n- `DEFAULT`: Platform default intelligent ranking\n- `FANS`: Sort by follower count descending", "required": false, "schema": { "type": "string", "default": "FANS", "description": "Creator search sorting", "enum": [ "DEFAULT", "FANS" ] } }, { "name": "fansNumberLower", "in": "query", "description": "Minimum number of fans.", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "fansNumberUpper", "in": "query", "description": "Maximum number of fans.", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "fansAge", "in": "query", "description": "Target fans age group.\n\nAvailable Values:\n- `ALL`: All ages\n- `LT_18`: Under 18\n- `AGE_18_24`: 18 to 24\n- `AGE_25_34`: 25 to 34\n- `AGE_35_44`: 35 to 44\n- `GT_44`: Above 44", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Fans age distribution", "enum": [ "ALL", "LT_18", "AGE_18_24", "AGE_25_34", "AGE_35_44", "GT_44" ] } }, { "name": "fansGender", "in": "query", "description": "Target fans gender.\n\nAvailable Values:\n- `ALL`: All genders\n- `MALE_HIGH`: Mainly Male\n- `FE_MALE_HIGH`: Mainly Female", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Fans gender distribution", "enum": [ "ALL", "MALE_HIGH", "FE_MALE_HIGH" ] } }, { "name": "fansChildAgeInfo", "in": "query", "description": "Mother-and-baby audience stage filter. Pass Pugongying labels or numeric codes separated by English or Chinese commas.\n\nAvailable values:\n- 1: 备孕\n- 2: 0-6月\n- 3: 7-12月\n- 4: 1-3岁\n- 5: 4-6岁\n- 6: 7-12岁\n- 7: 孕早期\n- 8: 孕晚期\n", "required": false, "schema": { "type": "string" } }, { "name": "gender", "in": "query", "description": "KOL's gender.\n\nAvailable Values:\n- `ALL`: All genders\n- `MALE`: Male\n- `FEMALE`: Female", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Gender type", "enum": [ "ALL", "MALE", "FEMALE" ] } }, { "name": "location", "in": "query", "description": "Creator profile location filter. Pass Pugongying location labels separated by English or Chinese commas. Country, China province or region, city-level paths, and district/county-level paths are supported. China province or region short labels are normalized to the full Pugongying value. Only paths present in the Pugongying location tree are accepted. Paths such as `河北 秦皇岛`, `山西 长治 潞州区`, or `中国 山西 长治 潞州区` are normalized to values like `中国 山西 长治 潞州区`.\n\nAvailable country/province base values:\n- 中国\n- 美国\n- 日本\n- 澳大利亚\n- 英国\n- 加拿大\n- 韩国\n- 法国\n- 德国\n- 新加坡\n- 其他\n- 中国 北京\n- 中国 天津\n- 中国 河北\n- 中国 山西\n- 中国 内蒙古\n- 中国 辽宁\n- 中国 吉林\n- 中国 黑龙江\n- 中国 上海\n- 中国 江苏\n- 中国 浙江\n- 中国 安徽\n- 中国 福建\n- 中国 江西\n- 中国 山东\n- 中国 河南\n- 中国 湖北\n- 中国 湖南\n- 中国 广东\n- 中国 广西\n- 中国 海南\n- 中国 重庆\n- 中国 四川\n- 中国 贵州\n- 中国 云南\n- 中国 西藏\n- 中国 陕西\n- 中国 甘肃\n- 中国 青海\n- 中国 宁夏\n- 中国 新疆\n- 中国 澳门\n- 中国 台湾\n- 中国 香港\n\nExample:\n- 广东,中国 上海,河北 秦皇岛,山西 长治 潞州区\n", "required": false, "schema": { "type": "string" } }, { "name": "contentTag", "in": "query", "description": "Content category filter. Pass first-level or second-level category labels from Pugongying, separated by commas.\n\nAvailable values:\n- 美妆: 整体妆容, 唇妆, 眼妆, 美甲, 底妆, 美妆合集, 香水, 美妆其他\n- 护肤: 面部保养, 面部清洁, 护肤合集, 护肤其他\n- 个人护理: 头发产品, 身体护理, 口腔护理, 护理其他\n- 母婴: 母婴日常, 早教, 婴童用品, 婴童洗护, 婴童食品, 婴童时尚, 孕期穿搭, 孕产经验, 产后恢复, 育儿经验, 宝宝才艺, 宝宝写真, 母婴其他\n- 时尚: 穿搭, 配饰, 发型, 箱包, 鞋靴, 时尚其他\n- 美食: 美食教程, 美食探店, 美食展示, 美食测评, 吃播, 美食其他\n- 家居家装: 装修, 家居用品, 家居装饰, 家具, 家电, 室内设计, 居家经验, 家居家装其他\n- 影视综资讯: 动漫, 电影, 电视, 娱乐资讯, 影视, 民生资讯, 综艺, 影视综其他\n- 运动健身: 健身减肥, 健身塑形, 滑雪, 滑板, 水上活动, 运动其他, 足球, 篮球, 跑步, 游泳\n- 宠物: 猫, 狗, 动物其他\n- 文化艺术: 社科, 文化, 艺术, 文化艺术其他\n- 兴趣爱好: 绘画, 手工, 阅读, 文具手账, 舞蹈, 益智玩具, 潮流玩具, 兴趣爱好其他\n- 生活记录: 接地气生活, 日常片段, 中外生活, 品质生活, 校园生活\n- 教育: 大学教育, k12教育, 家庭教育, 学习日常, 职场教育, 教育其他\n- 情感: 情感知识, 情感日常, 情感其他\n- 摄影: 人文风光摄影, 摄影技巧, 胶片摄影, 人像摄影, 摄影其他\n- 游戏: 手机游戏, 主机游戏, 游戏其他, 线下游戏\n- 科技数码: 数码, 玩机攻略, 数码科技其他\n- 出行: 城市出行, 户外, 旅行\n- 音乐\n- 搞笑\n- 健康养生\n- 汽车\n- 婚嫁: 婚礼造型, 婚礼记录, 婚礼经验, 婚礼用品\n- 商业财经\n- 素材\n- 其他\n", "required": false, "schema": { "type": "string" } }, { "name": "contentSceneLabel", "in": "query", "description": "Content scene label filter. Pass full Pugongying note category scene label paths separated by English or Chinese commas.\n\nAvailable values:\n- 汽车 理性决策 选车攻略 政策\n- 汽车 理性决策 选车攻略 购车顾虑\n- 汽车 理性决策 选车攻略 配置\n- 汽车 理性决策 选车攻略 能源类型优势对比\n- 汽车 理性决策 选车攻略 攻略\n- 汽车 理性决策 新车测评\n- 汽车 理性决策 探店试驾\n- 汽车 理性决策 车主心得\n- 汽车 用车场景 远行近游 近郊探索\n- 汽车 用车场景 远行近游 长途自驾\n- 汽车 用车场景 远行近游 硬核越野\n- 汽车 用车场景 提车/交付场景 场地布置与礼遇\n- 汽车 用车场景 提车/交付场景 仪式感记录\n- 汽车 用车场景 商务用车 移动头等舱\n- 汽车 用车场景 商务用车 商务接待\n- 汽车 用车场景 亲子家庭 家庭采购日\n- 汽车 用车场景 亲子家庭 接送孩子\n- 汽车 用车场景 亲子家庭 三代同堂\n- 汽车 用车场景 亲子家庭 周末溜娃\n- 汽车 用车场景 亲子家庭 车内学习室\n- 汽车 用车场景 亲子家庭 车内育婴室\n- 汽车 用车场景 朋友社交 后备箱经济\n- 汽车 用车场景 朋友社交 移动娱乐屋\n- 汽车 用车场景 礼赠场景 毕业礼物\n- 汽车 用车场景 礼赠场景 送给父母\n- 汽车 用车场景 礼赠场景 适合送男友\n- 汽车 用车场景 礼赠场景 适合送女友\n- 汽车 用车场景 户外兴趣 钓鱼/野营\n- 汽车 用车场景 户外兴趣 骑行\n- 汽车 用车场景 户外兴趣 徒步\n- 汽车 用车场景 户外兴趣 硬核竞速\n- 汽车 用车场景 宠物出行 大型宠物\n- 汽车 用车场景 宠物出行 短途出行\n- 汽车 用车场景 宠物出行 小型宠物\n- 汽车 用车场景 宠物出行 长途出行\n- 汽车 用车场景 城市通勤 车内小憩\n- 汽车 用车场景 城市通勤 健身储物\n- 汽车 用车场景 城市通勤 日常通勤\n- 汽车 用车场景 城市通勤 生活圈代步\n- 汽车 用车场景 城市通勤 移动美容舱\n- 汽车 个性化美化 个性改装\n- 汽车 个性化美化 储物收纳\n- 汽车 个性化美化 车内装饰\n- 汽车 个性化美化 车外装饰\n- 汽车 个性化美化 车衣保护\n- 汽车 个性化美化 汽车用品\n- 汽车 车型品类 轿车\n- 汽车 车型品类 SUV\n- 汽车 车型品类 MPV\n- 汽车 车型品类 跑车\n- 汽车 车型品类 微型车\n- 汽车 车型品类 微面\n- 汽车 车型品类 房车\n- 汽车 车型品类 越野车\n- 汽车 车型品类 旅行车\n- 汽车 圈层属性 改装圈层\n- 汽车 圈层属性 痛车圈层\n- 汽车 圈层属性 跑山圈层\n- 汽车 品牌倾向 自主\n- 汽车 品牌倾向 豪华\n- 汽车 品牌倾向 集团\n- 汽车 品牌倾向 新势力\n- 汽车 能源类型 纯电车\n- 汽车 能源类型 新能源\n- 汽车 能源类型 油车\n- 汽车 人生阶段 单身\n- 汽车 人生阶段 多娃&大家庭阶段\n- 汽车 人生阶段 银发退休阶段\n- 游戏 游戏品类 网页游戏\n- 游戏 游戏品类 电脑游戏\n- 游戏 游戏品类 手机游戏\n- 游戏 游戏类型 动作格斗游戏 永劫无间\n- 游戏 游戏类型 即时制二次元游戏 境界刀鸣\n- 游戏 游戏类型 即时制二次元游戏 黑色信标\n- 游戏 游戏类型 即时制二次元游戏 物华弥新\n- 游戏 游戏类型 即时制二次元游戏 无期迷途\n- 游戏 游戏类型 即时制二次元游戏 新月同行\n- 游戏 游戏类型 即时制二次元游戏 绝区零\n- 游戏 游戏类型 即时制角色扮演 诛仙2\n- 游戏 游戏类型 即时制角色扮演 诛仙\n- 游戏 游戏类型 即时制角色扮演 明日之后\n- 游戏 游戏类型 即时制角色扮演 超自然行动组\n- 游戏 游戏类型 即时制角色扮演 永恒之塔2\n- 游戏 游戏类型 回合制二次元游戏 未定事件簿\n- 游戏 游戏类型 回合制二次元游戏 雷索纳斯\n- 游戏 游戏类型 回合制二次元游戏 浮生忆玲珑\n- 游戏 游戏类型 回合制二次元游戏 重返未来1999\n- 游戏 游戏类型 回合制角色扮演 梦幻西游手游\n- 游戏 游戏类型 回合制角色扮演 龙魂旅人\n- 游戏 游戏类型 回合制角色扮演 最终幻想14\n- 游戏 游戏类型 塔防游戏 保卫向日葵\n- 游戏 游戏类型 塔防游戏 全境守卫\n- 游戏 游戏类型 塔防游戏 向僵尸开炮\n- 游戏 游戏类型 开放世界角色扮演 燕云十六声\n- 游戏 游戏类型 开放世界角色扮演 王者荣耀世界\n- 游戏 游戏类型 恋爱游戏 如鸢\n- 游戏 游戏类型 恋爱游戏 银与绯\n- 游戏 游戏类型 恋爱游戏 时空中的绘旅人\n- 游戏 游戏类型 恋爱游戏 光与夜之恋\n- 游戏 游戏类型 恋爱游戏 恋与深空\n- 游戏 游戏类型 恋爱游戏 恋与制作人\n- 游戏 游戏类型 战略游戏 率土之滨\n- 游戏 游戏类型 战略游戏 群星纪元\n- 游戏 游戏类型 战略游戏 阿瓦隆之王\n- 游戏 游戏类型 战略游戏 快来当领主\n- 游戏 游戏类型 战略游戏 冒险之星\n- 游戏 游戏类型 战略游戏 无尽的拉格朗日\n- 游戏 游戏类型 放置类二次元游戏 花花与幕间剧\n- 游戏 游戏类型 放置类角色扮演 发条总动员\n- 游戏 游戏类型 放置类角色扮演 遮天凡尘一叶\n- 游戏 游戏类型 模拟养成 美人传\n- 游戏 游戏类型 模拟养成 盲盒派对\n- 游戏 游戏类型 模拟养成 闪耀暖暖\n- 游戏 游戏类型 模拟养成 以闪亮之名\n- 游戏 游戏类型 模拟养成 无限暖暖\n- 游戏 游戏类型 模拟家园建造 江南百景图\n- 游戏 游戏类型 模拟家园建造 动物森友会\n- 游戏 游戏类型 模拟家园建造 星露谷物语\n- 游戏 游戏类型 模拟经营 暴吵萌厨\n- 游戏 游戏类型 模拟经营 肥鹅健身房\n- 游戏 游戏类型 模拟职业 杜拉拉升职记\n- 游戏 游戏类型 消除游戏 四季合合\n- 游戏 游戏类型 生存沙盒游戏 无尽冬日\n- 游戏 游戏类型 聚会游戏 蛋仔派对\n- 游戏 游戏类型 聚会游戏 代号砰砰\n- 游戏 游戏类型 解谜游戏 晴空之下\n- 游戏 游戏类型 抓宠类游戏 洛克王国手游\n- 游戏 游戏类型 射击游戏 三角洲行动\n- 游戏 游戏类型 射击游戏 codm（使命召唤）\n- 母婴 婴童洗护 安全防晒\n- 母婴 婴童洗护 浴后护理\n- 母婴 婴童洗护 敏感修护\n- 母婴 婴童洗护 屏障树立\n- 母婴 婴童洗护 泳后护理\n- 母婴 婴童洗护 口周干裂\n- 母婴 婴童洗护 分区清洁\n- 母婴 婴童洗护 头皮问题\n- 母婴 婴童洗护 驱虫驱蚊\n- 母婴 婴童洗护 洁面清洁\n- 母婴 婴童洗护 红屁股\n- 母婴 婴童洗护 湿疹皮炎\n- 母婴 婴童洗护 痱子热疹\n- 母婴 婴童洗护 抚触链接\n- 母婴 婴童洗护 趣味洗护\n- 母婴 母婴纸品 精算育儿\n- 母婴 母婴纸品 颜值派\n- 母婴 母婴纸品 汗宝宝\n- 母婴 母婴纸品 囤货党\n- 母婴 母婴纸品 敏感肌\n- 母婴 母婴纸品 肉腿娃\n- 母婴 母婴纸品 功课党\n- 母婴 母婴纸品 好动宝\n- 母婴 母婴纸品 安睡整夜\n- 母婴 母婴纸品 出行便携\n- 母婴 母婴纸品 贵妇体验\n- 母婴 母婴纸品 红屁屁\n- 母婴 母婴小家电 空间收纳\n- 母婴 母婴小家电 滋补养生\n- 母婴 母婴小家电 温度把控\n- 母婴 母婴小家电 夜奶操作\n- 母婴 母婴小家电 新手喂养\n- 母婴 母婴小家电 材质挑选\n- 母婴 母婴小家电 三代同育\n- 母婴 母婴小家电 户外喂养\n- 母婴 母婴小家电 通乳攻略\n- 母婴 母婴小家电 洁癖爸妈\n- 母婴 母婴小家电 精准喂养\n- 母婴 母婴小家电 职场妈妈\n- 母婴 婴童辅食 吞咽能力\n- 母婴 婴童辅食 多元辅食\n- 母婴 婴童辅食 零食分享\n- 母婴 婴童辅食 健康零食\n- 母婴 婴童辅食 放学加餐\n- 母婴 婴童辅食 出牙磨牙\n- 母婴 婴童辅食 居家囤货\n- 母婴 婴童辅食 节日礼包\n- 母婴 婴童辅食 零食训练\n- 母婴 婴童辅食 宝宝挑食\n- 母婴 婴童辅食 户外零食\n- 母婴 婴童辅食 低敏辅食\n- 母婴 婴童辅食 入园社交\n- 母婴 婴童辅食 居家辅食\n- 母婴 婴童辅食 入园准备\n- 母婴 婴童辅食 敏敏零食\n- 母婴 婴童辅食 抓握训练\n- 母婴 婴童辅食 外出口粮\n- 母婴 婴童辅食 营养均衡\n- 母婴 婴童辅食 自主进食\n- 母婴 婴童辅食 第一口辅食\n- 母婴 母婴营养品 开胃因子\n- 母婴 母婴营养品 视力保护\n- 母婴 母婴营养品 营养补充\n- 母婴 母婴营养品 防护因子\n- 母婴 母婴营养品 高钙因子\n- 母婴 母婴营养品 自护构建\n- 母婴 母婴营养品 发育表现\n- 母婴 母婴营养品 助眠安睡\n- 母婴 婴童奶粉 丝滑转奶\n- 母婴 婴童奶粉 益生组合\n- 母婴 婴童奶粉 眼脑体发育\n- 母婴 婴童奶粉 选奶功课\n- 母婴 婴童奶粉 防敏脱敏\n- 母婴 婴童奶粉 助力聪明脑\n- 母婴 婴童奶粉 乳铁自护\n- 母婴 婴童奶粉 黄金长高\n- 母婴 婴童奶粉 内修外护\n- 母婴 婴童奶粉 肚肚吸收\n- 母婴 婴童奶粉 断奶攻略\n- 母婴 婴童奶粉 混合喂养\n- 母婴 婴童奶粉 母源黄金HMO\n- 母婴 婴童奶粉 长肉多肉\n- 母婴 哺乳喂养工具 萌娃穿搭\n- 母婴 哺乳喂养工具 安全材质\n- 母婴 哺乳喂养工具 奶瓶喂养\n- 母婴 哺乳喂养工具 颜值发育\n- 母婴 哺乳喂养工具 哄娃安抚\n- 母婴 哺乳喂养工具 餐具选购\n- 母婴 哺乳喂养工具 学饮指南\n- 母婴 哺乳喂养工具 换季保温\n- 母婴 母婴孕产 职场孕妇\n- 母婴 母婴孕产 产后复工\n- 母婴 母婴孕产 顺产\n- 母婴 母婴孕产 孕期变化\n- 母婴 母婴孕产 孕期学习\n- 母婴 母婴孕产 剖腹产\n- 母婴 母婴家居 护脊深睡\n- 母婴 母婴家居 安全翻滚\n- 母婴 母婴家居 进食习惯\n- 母婴 母婴家居 早教启蒙\n- 母婴 母婴家居 学习角落\n- 母婴 母婴家居 自主入睡\n- 母婴 母婴家居 爬行探索\n- 母婴 母婴家居 防惊跳\n- 母婴 母婴出行&用品 长线旅途\n- 母婴 母婴出行&用品 户外探索\n- 母婴 母婴出行&用品 二胎/双胎\n- 母婴 母婴出行&用品 新贵消费\n- 母婴 母婴出行&用品 备产研究\n- 母婴 母婴出行&用品 短途旅行\n- 母婴 母婴出行&用品 高频出行\n- 母婴 母婴出行&用品 新生出行\n- 母婴 母婴出行&用品 务实精算\n- 母婴 母婴出行&用品 遛娃必备\n", "required": false, "schema": { "type": "string" } }, { "name": "personalTags", "in": "query", "description": "Blogger persona tag filter. Pass one or more Pugongying persona labels separated by English or Chinese commas.\n\nAvailable values:\n- 妈妈\n- 萌娃\n- 爸爸\n- 奶奶\n- 情侣\n- 夫妻\n- 家庭\n- 闺蜜\n- 兄弟\n- 备孕中\n- 孕期中\n- 12岁以上\n- 传统行业\n- 互联网\n- 教育科研\n- 金融法律\n- 企业创业\n- 时尚美妆\n- 食品饮料\n- 文化传媒\n- 医疗健康\n- 艺术设计\n- 影视娱乐\n- 运动健身\n- 专业服务\n- 工程师\n- 销售\n- HR\n- 教练\n- 运动员\n- 舞蹈老师\n- 生活背景\n- 备考经验\n- 兴趣爱好\n- 留学背景\n- 海外华人\n- 铲屎官\n- 孕妈\n- 独居人群\n- 外国人\n- 混血儿\n\nExample:\n- 妈妈,教练,运动员,舞蹈老师,留学背景\n", "required": false, "schema": { "type": "string" } }, { "name": "marketTarget", "in": "query", "description": "Marketing target filter. Pass one Pugongying marketing target value.\n\nAvailable values:\n- estimateAllCpm: Exposure - exposure performance - cost\n- mAccumImpNum: Exposure - exposure performance - scale\n- readCost: Exposure - read performance - cost\n- mValidRawReadFeedNum: Exposure - read performance - scale\n- estimateEngageCost: Seeding - engagement performance - cost\n- mEngagementNum90d: Seeding - engagement performance - scale\n- estimateCpuv: Conversion - outer-store visit performance - cost\n- mCpuvNum: Conversion - outer-store visit performance - scale\n", "required": false, "schema": { "type": "string" } }, { "name": "audienceGroup", "in": "query", "description": "Audience target filter. Pass Pugongying audience group IDs (`dmpGroupId`) separated by English or Chinese commas. These IDs are dynamic and account-specific, so there is no fixed global value list. Use the audience group name shown in Pugongying Audience Management to identify what each ID means.\n", "required": false, "schema": { "type": "string" } }, { "name": "top20CrowdsLabel", "in": "query", "description": "Top-20 audience filter. Pass top-level or child audience labels separated by commas; child labels are converted to Pugongying request values.", "required": false, "schema": { "type": "string" } }, { "name": "industrySpecificCrowdsMotorDom", "in": "query", "description": "Industry-specific portrait filter. Pass Pugongying portrait value IDs or label values separated by commas.", "required": false, "schema": { "type": "string" } }, { "name": "featureTags", "in": "query", "description": "Good-at content tag filter. Pass label values separated by commas.", "required": false, "schema": { "type": "string" } }, { "name": "contentThemeLabel", "in": "query", "description": "Content theme filter. Pass Pugongying value IDs or label values separated by commas; labels are converted to value IDs.", "required": false, "schema": { "type": "string" } }, { "name": "excludeLowActive", "in": "query", "description": "Whether to exclude low-activity bloggers.", "required": false, "schema": { "type": "boolean" } }, { "name": "fansNumUp", "in": "query", "description": "Whether to exclude bloggers whose fan count is dropping.", "required": false, "schema": { "type": "boolean" } }, { "name": "noteType", "in": "query", "description": "Note type filter. Values: ALL=all note types, PHOTO_TEXT=mainly photo-text notes, VIDEO=mainly video notes.\n\nAvailable Values:\n- `ALL`: All note types\n- `PHOTO_TEXT`: Mainly photo-text notes\n- `VIDEO`: Mainly video notes", "required": false, "schema": { "type": "string", "default": "ALL", "description": "Creator search note type preference", "enum": [ "ALL", "PHOTO_TEXT", "VIDEO" ] } }, { "name": "industry", "in": "query", "description": "Pugongying industry preset for industry assistant style creator recommendations.\n\nAvailable Values:\n- `BEAUTY_PERSONAL_CARE_BEAUTY`: Beauty and personal care - beauty\n- `BEAUTY_PERSONAL_CARE_SKINCARE`: Beauty and personal care - skincare\n- `BEAUTY_PERSONAL_CARE_PERSONAL_CARE`: Beauty and personal care - personal care\n- `BEAUTY_PERSONAL_CARE_FRAGRANCE`: Beauty and personal care - fragrance\n- `FOOD_BEVERAGE_SNACKS`: Food and beverage - snacks\n- `FOOD_BEVERAGE_DRINKS`: Food and beverage - drinks\n- `FOOD_BEVERAGE_HEALTH_FOOD`: Food and beverage - health food\n- `FOOD_BEVERAGE_DAIRY`: Food and beverage - dairy\n- `FOOD_BEVERAGE_ALCOHOL`: Food and beverage - alcohol\n- `FOOD_BEVERAGE_GRAINS_OIL`: Food and beverage - grains and oil\n- `FOOD_BEVERAGE_CROSS_BORDER_FOOD`: Food and beverage - cross-border food\n- `FOOD_BEVERAGE_FRESH_FOOD`: Food and beverage - fresh food\n- `FOOD_BEVERAGE_MEAL_REPLACEMENT`: Food and beverage - meal replacement\n- `FOOD_BEVERAGE_TRADITIONAL_NOURISHMENT`: Food and beverage - traditional nourishment\n- `MOTHER_BABY_SUPPLIES`: Mother and baby - baby supplies\n- `MOTHER_BABY_FORMULA_FOOD`: Mother and baby - formula and baby food\n- `DIGITAL_APPLIANCES_HOME_APPLIANCES`: Digital and appliances - home appliances\n- `DIGITAL_APPLIANCES_DIGITAL_PRODUCTS`: Digital and appliances - digital products\n- `DAILY_GOODS_HOUSEHOLD_DAILY_USE`: Daily goods - household daily use\n- `DAILY_GOODS_PET_SUPPLIES_FOOD`: Daily goods - pet supplies and food\n- `DAILY_GOODS_OFFICE_SUPPLIES`: Daily goods - office supplies\n- `APPAREL_ACCESSORIES_CLOTHING_SHOES_HATS`: Apparel and accessories - clothing, shoes, and hats\n- `APPAREL_ACCESSORIES_JEWELRY`: Apparel and accessories - jewelry\n- `APPAREL_ACCESSORIES_BAGS_GLASSES`: Apparel and accessories - bags and glasses\n- `APPAREL_ACCESSORIES_SPORTS_OUTDOOR`: Apparel and accessories - sports and outdoor\n- `APPAREL_ACCESSORIES_WATCHES`: Apparel and accessories - watches\n- `APPAREL_ACCESSORIES_SECOND_HAND_LUXURY`: Apparel and accessories - second-hand luxury\n- `HOME_BUILDING_MATERIALS_HOME_DECOR`: Home and building materials - home decor\n- `HOME_BUILDING_MATERIALS_FURNITURE`: Home and building materials - furniture\n- `HOME_BUILDING_MATERIALS_MAIN_MATERIALS`: Home and building materials - main building materials\n- `AUTOMOTIVE`: Automotive\n- `INTERNET_ECOMMERCE`: Internet - e-commerce\n- `INTERNET_SOFTWARE_TOOLS`: Internet - software tools\n- `HEALTHCARE_MEDICAL_DEVICES`: Healthcare - medical devices\n- `HEALTHCARE_MEDICAL_BEAUTY`: Healthcare - medical beauty\n- `CULTURE_SPORTS_ENTERTAINMENT_SPORTS_GOODS`: Culture, sports, and entertainment - sports goods\n- `CULTURE_SPORTS_ENTERTAINMENT_STATIONERY_TOYS_GIFTS`: Culture, sports, and entertainment - stationery, toys, and gifts\n- `CULTURE_SPORTS_ENTERTAINMENT_OUTDOOR_PRODUCTS`: Culture, sports, and entertainment - outdoor products\n- `CULTURE_SPORTS_ENTERTAINMENT_ART_COLLECTIBLES`: Culture, sports, and entertainment - art collectibles\n- `LIFE_SERVICES_OFFLINE_RETAIL`: Life services - offline retail\n- `LIFE_SERVICES_BEAUTY_HAIR`: Life services - beauty and hair\n- `CATERING_RESTAURANTS`: Catering - restaurants\n- `CATERING_DRINKS_DESSERTS`: Catering - drinks and desserts\n- `BUSINESS_SERVICES`: Business services\n- `EDUCATION_TRAINING_LANGUAGE_STUDY_ABROAD`: Education and training - language and study abroad\n- `EDUCATION_TRAINING_VOCATIONAL_EDUCATION`: Education and training - vocational education\n- `EDUCATION_TRAINING_INTEREST_TRAINING`: Education and training - interest training\n- `EDUCATION_TRAINING_K12_EDUCATION`: Education and training - K-12 education\n- `EDUCATION_TRAINING_DEGREE_EDUCATION`: Education and training - degree education\n- `EDUCATION_TRAINING_CORPORATE_DEVELOPMENT`: Education and training - corporate and team development\n- `EDUCATION_TRAINING_OTHER`: Education and training - other\n- `GAMES`: Games\n- `TRAVEL_TOURISM`: Travel and tourism", "required": false, "schema": { "type": "string", "description": "Industry assistant creator recommendation industry", "enum": [ "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", "EDUCATION_TRAINING_DEGREE_EDUCATION", "EDUCATION_TRAINING_CORPORATE_DEVELOPMENT", "EDUCATION_TRAINING_OTHER", "GAMES", "TRAVEL_TOURISM" ] } }, { "name": "accumCommonImpMedinNum30d", "in": "query", "description": "Daily note exposure median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.", "required": false, "schema": { "type": "string" } }, { "name": "readMidNor30", "in": "query", "description": "Daily note read median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.", "required": false, "schema": { "type": "string" } }, { "name": "interMidNor30", "in": "query", "description": "Daily note interaction median range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.", "required": false, "schema": { "type": "string" } }, { "name": "thousandLikePercent30", "in": "query", "description": "Thousand-like note ratio range. Pass fractional ratios such as 0.4,null or percentage values such as 40,null.", "required": false, "schema": { "type": "string" } }, { "name": "notePrice", "in": "query", "description": "Photo-text cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.", "required": false, "schema": { "type": "string" } }, { "name": "videoPrice", "in": "query", "description": "Video cooperation quote range. Pass two comma-separated numeric bounds; use -1 or null for an open upper bound.", "required": false, "schema": { "type": "string" } }, { "name": "inviteReply48hNumRatio", "in": "query", "description": "48-hour invite reply ratio range. Pass fractional ratios such as 0.9,0.95 or percentage values such as 90,95.", "required": false, "schema": { "type": "string" } }, { "name": "progressOrderCnt", "in": "query", "description": "Current cooperation order count range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "tradeType", "in": "query", "description": "Recent cooperation industry filter from Pugongying.", "required": false, "schema": { "type": "string" } }, { "name": "tradeReportBrandIds", "in": "query", "description": "Recent cooperation brand IDs, separated by English or Chinese commas.", "required": false, "schema": { "type": "string" } }, { "name": "excludeTradeReportBrandIds", "in": "query", "description": "Whether to exclude creators who cooperated with the selected recent cooperation brands.", "required": false, "schema": { "type": "boolean" } }, { "name": "accumCoopImpMedinNum30d", "in": "query", "description": "Cooperation note exposure median range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "readMidCoop30", "in": "query", "description": "Cooperation note read median range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "interMidCoop30", "in": "query", "description": "Cooperation note interaction median range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "mCpuvNum30d", "in": "query", "description": "Cooperation note outer-store median range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "estimatePictureCpm", "in": "query", "description": "Estimated photo-text CPM range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "estimateVideoCpm", "in": "query", "description": "Estimated video CPM range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "estimatePicReadPrice", "in": "query", "description": "Estimated photo-text read unit price range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "estimateVideoReadPrice", "in": "query", "description": "Estimated video read unit price range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "estimatePictureEngageCost", "in": "query", "description": "Estimated photo-text engagement unit price range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "estimateVideoEngageCost", "in": "query", "description": "Estimated video engagement unit price range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "estimateCpuv30d", "in": "query", "description": "Estimated outer-store visit unit price range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "kliveCnt30d", "in": "query", "description": "Live count in the last 30 days range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "avgLiveViewerNum", "in": "query", "description": "Average live viewer count range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "avgAgmv90d", "in": "query", "description": "Average live sales amount range. Pass two comma-separated numeric bounds.", "required": false, "schema": { "type": "string" } }, { "name": "similarUserId", "in": "query", "description": "Similar creator user ID. `similarUserId` and `similarWord` must be provided together.", "required": false, "schema": { "type": "string" } }, { "name": "similarWord", "in": "query", "description": "Similar creator keyword shown by Pugongying. `similarUserId` and `similarWord` must be provided together.", "required": false, "schema": { "type": "string" } }, { "name": "fansLocation", "in": "query", "description": "Follower audience location filter. Pass Pugongying follower-region labels separated by English or Chinese commas. Country, China province, and city-level paths are supported; district/county-level paths are not accepted. Only paths present in the Pugongying follower-region tree are accepted. Use city paths such as `福建 南平`, `福建-南平`, or `中国 福建 南平`; they are normalized to values like `中国 福建 南平`.\n\nExamples:\n- 福建 南平\n- 中国 福建 南平,广东\n", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "Invalid request parameters or body", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "Invalid or inactive access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "Request rate or daily quota limit exceeded", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "Service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "13000010", "x-api-version": "v1", "x-search-aliases": [ "Xiaohongshu Pugongying creator search", "Pugongying influencer filter", "Xiaohongshu campaign creator discovery", "小红书蒲公英达人搜索", "蒲公英博主筛选", "小红书投放达人发现" ], "x-highlights": [], "x-endpoint-family": "xiaohongshu_pgy_api_solar_cooperator_blogger_v2" } } } }