# Xiaohongshu PGY note blogger marketplace Full replica of PGY "Find Bloggers → Note Blogger Square"; ~60 filters grouped into 7 objects. Takes page num, page size, keyword and more, all optional. Served by TikHub. Purpose: - Full replica of PGY "Find Bloggers → Note Blogger Square"; ~60 filters grouped into 7 objects - Each result embeds ~140 fields (quotes, read/engagement medians, live sessions, ...) 1. Search & Sort | Param | Description | |---|---| | `keyword` | Search term; empty = filter only | | `search_type` | `1`=find bloggers by note keyword (default), `0`=search by nickname | | `column` | Sort field, **34 options** — see the Chinese table above for the full list with labels | | `similar_user_id` | **Find similar bloggers**: pass a blogger's userId; results can be **combined with every filter below** | | `similar_word` | Nickname echo for `similar_user_id`; does not affect results | | `sort` | `desc` (default) / `asc` | | `brand_user_id` | Brand/advertiser user ID, optional; enables brand-specific recommendation and "already cooperated" marks | 2. Filter Groups | Group | Covers | |---|---| | `goal` | Marketing goal (exposure / seeding / conversion × metric × cost or scale) | | `blogger` | Category, persona, expertise, content theme, top-20 crowds, industry-specific portrait, estimated consumption, note category, gender, location, agency status | | `fans` | Fans count, age, gender, location, marital status, consumption level, parenting stage, phone price, phone brand | | `note` | Organic note impression / read / engagement medians, 1000-like ratio, note type | | `coop` | Quotes, order count, credit score, recent industries & brands, reach scale, estimated CPM / read cost / engagement cost, store-visit cost | | `live` | Live sessions in last 30d, average viewers, average GM - Tool ID: `tikhub/xiaohongshu-pgy-get-blogger-list` - Name in the catalog: Xiaohongshu, PGY note blogger square - Provider: [TikHub](/providers/tikhub.md) - Capability: [Xiaohongshu posts](/tools/xiaohongshu/posts.md) - Price: $0.02 per call - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract The provider’s price, with no markup. Billed for measured usage. ```json { "model": "per_call", "amountUsd": 0.02 } ``` Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.02; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second. Price verification date: 2026-10-05. ## Complete input schema ```json { "type": "object", "properties": { "page_num": { "type": "integer", "maximum": 250, "minimum": 1, "title": "Page Num", "description": "页码，1-250（上游只放出前 5000 条）/Page, 1-250", "default": 1 }, "page_size": { "type": "integer", "maximum": 20, "minimum": 1, "title": "Page Size", "description": "每页数量，1-20（网页固定 20，建议保持 20）/Page size, 1-20", "default": 20 }, "keyword": { "type": "string", "maxLength": 50, "title": "Keyword", "description": "搜索词；空=只筛选不搜索/Keyword", "default": "" }, "search_type": { "type": "integer", "enum": [ 0, 1 ], "title": "Search Type", "description": "1=按笔记关键词找博主(默认) 0=按昵称搜/Search mode", "default": 1 }, "column": { "type": "string", "enum": [ "comprehensiverank", "fansCount", "price", "clickNum", "mEngagementNum", "accumCommonImpMedinNum30d", "accumPicCommonImpMedinNum30d", "accumVideoCommonImpMedinNum30d", "pictureClickMidNum", "videoClickMidNum", "pictureInterMidNum", "videoInterMidNum", "thousandLikePercent30", "pictureThousandLikePercent30", "videoThousandLikePercent30", "hundredLikePercent30", "pictureHundredLikePercent30", "videoHundredLikePercent30", "videoFinishRate", "accumCoopImpMedinNum30d", "readMidCoop30", "interMidCoop30", "mCpuvNum30d", "picturePrice", "videoPrice", "pictureReadCost", "videoReadCost", "inviteReply48hNumRatio", "fans30GrowthRate", "fansActiveIn28dLv", "fansEngageNum30dLv", "kliveCnt30d", "avgLiveViewerNum", "avgAgmv90d" ], "title": "Column", "description": "排序字段，共 34 个，见接口说明的排序字段表/Sort column, 34 options, see endpoint docs", "default": "comprehensiverank" }, "sort": { "type": "string", "enum": [ "desc", "asc" ], "title": "Sort", "description": "排序方向 desc/asc", "default": "desc" }, "brand_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Brand User Id", "description": "品牌方/广告主用户ID，可不填/Brand user ID, optional" }, "similar_user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Similar User Id", "description": "找相似博主：填一个博主的 userId，返回与他相似的博主，**并且可以叠加下面所有筛选**（这是它与 /get_blogger_similar 的关键区别）/Find similar bloggers; unlike /get_blogger_similar it can be combined with all filters below" }, "similar_word": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "title": "Similar Word", "description": "配合 similar_user_id 的博主昵称，仅用于回显、不影响结果/Nickname echo for similar_user_id; does not affect results" }, "goal": { "anyOf": [ { "properties": { "market_target": { "anyOf": [ { "type": "string", "enum": [ "estimateAllCpm", "mAccumImpNum", "readCost", "mValidRawReadFeedNum", "estimateEngageCost", "mEngagementNum90d", "estimateCpuv", "mCpuvNum" ] }, { "type": "null" } ], "title": "Market Target", "description": "「营销目标」：网页上是三级选择（目标 → 指标 → 统计方式），填最终叶子码 —— `estimateAllCpm` 曝光/曝光表现/成本、`mAccumImpNum` 曝光/曝光表现/规模、`readCost` 曝光/阅读表现/成本、`mValidRawReadFeedNum` 曝光/阅读表现/规模、`estimateEngageCost` 种草/互动表现/成本、`mEngagementNum90d` 种草/互动表现/规模、`estimateCpuv` 转化/外溢进店表现/成本、`mCpuvNum` 转化/外溢进店表现/规模" } }, "additionalProperties": false, "type": "object", "title": "GoalFilter", "description": "合作目标：按营销目标（曝光 / 种草 / 转化）匹配博主。\n\n想按粉丝人群圈博主，用 `BloggerAttrFilter.audience20`（二十大人群）。" }, { "type": "null" } ], "description": "合作目标筛选/Cooperation goal filters" }, "blogger": { "anyOf": [ { "properties": { "content_tag": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Content Tag", "description": "「博主类目」：填类目名。一级共 28 个 —— 美妆/护肤/个人护理/母婴/时尚/美食/家居家装/影视综资讯/运动健身/宠物/文化艺术/兴趣爱好/生活记录/教育/职场/情感/摄影/游戏/科技数码/出行旅游/音乐/搞笑/健康养生/汽车/婚嫁/商业财经/素材/其他；也可填某一级下的二级名，**两级可以混在同一个数组里**，多个之间是「或」。某个类目要「全部」就填它的一级名，**不要展开成它的全部二级名**（有些博主只挂一级、没有二级标签，展开会漏掉他们）。**不限类目就不要传这个字段** —— 没有名为「全部」的类目，填了会静默返回 0 条。填错的名字同样不报错、只返回 0 条，务必从 contentTags 字典里原样复制。注意与「行业」(coop.industry) 不是同一套分类" }, "personal_tags": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Personal Tags", "description": "「博主人设」：填 `/get_blogger_filter_options` 里 personalTagsV2 的 `tagName`（裸名）。这是三层树（家庭身份/职业身份/特色背景 → 分组 → 叶子），**三层任意一层都能填、可以混填**，多个之间是「或」；想要整组就填那一组的名字，不用把叶子一个个列出来（实测：一级 `职业身份`=91 条，二级 `互联网`=8 条，叶子 `妈妈`=31 条）" }, "feature_tags": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Feature Tags", "description": "「擅长内容」：填 `/get_blogger_filter_options` 里 featureTags 的名字（裸名）。**一级（形式/风格/生活方式/肤质肤色/皮肤养护）和二级（如 vlog / 韩系）都能填、可混填**，多个之间是「或」；填一级就是那一组全要（实测：一级 `形式`=183，二级 `vlog`=136）" }, "content_theme": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Content Theme", "description": "「内容题材」：填 `/blogger/filter-options` 里 contentTheme 的**一级 label**（如 汽车特色 / 通用）。注意只支持一级，填子项 label 或 id 查不到结果" }, "audience20": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Audience20", "description": "「二十大人群」：**不是扁平裸名**。一级填名字即可（如 `自在户外`，= 整个人群）；**二级必须写成 `\"一级 一级-二级\"`**（如 `\"自在户外 自在户外-挑战极限者\"`）—— 一级名要出现两次。**照字典里的二级 label 直接填（如 `挑战极限者`）会静默返回 0 条**。一级与复合二级可以混在同一个数组里，多个之间是「或」。全量见 `/get_blogger_filter_options` 的 audience20（19 个一级 / 121 个二级）" }, "industry_crowd": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Industry Crowd", "description": "「行业特色画像」：填 `/blogger/filter-options` 里 automotiveIndustryTag **最深层叶子的 value**（数字字符串 ID，如 15795914，共 1600+ 个）。填 label 或中间层 id 均无结果" }, "consumer_behavior": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Consumer Behavior", "description": "「预估消费行为」：**必须填含根节点的空格全路径**（如 `\"内容行为预估 汽车\"`），路径可停在任意深度。取值查 `/get_blogger_filter_options` 的 **consumerBehavior**（5 层树）。⚠️ **填裸的叶子名不会报错、也不会返回 0 条，而是整个筛选被静默忽略** —— 实测 `[\"保时捷911\"]` 与 `[\"zzz不存在zzz\"]` 都返回未经筛选的全量结果，只有全路径写法才真的生效（`[\"内容行为预估 汽车\"]` 才筛出 54 条）。用它时请对比加/不加该筛选两次请求的 total 确认真的筛上了。另：该项按账号灰度开放，字典里为 null 时表示当前账号不可用" }, "note_scene": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Note Scene", "description": "「笔记类目」：填**空格分隔的完整路径**（类目 一级 二级 三级），如 \"汽车 理性决策 选车攻略 政策\"，路径可停在任意深度（越深越窄）。**只填末段（如 \"选车攻略\"）会返回 0 条。** 取值查 `/get_blogger_filter_options` 的 **contentScenes**（实测：`[\"汽车\"]`=75、`[\"汽车 理性决策\"]`=23、四级路径=1、`[\"选车攻略\"]`=0）" }, "gender": { "anyOf": [ { "type": "string", "enum": [ "男", "女" ] }, { "type": "null" } ], "title": "Gender", "description": "「性别」：男 / 女（填中文，不是数字）" }, "location": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Location", "description": "「地域」：博主所在地。**直接填地名即可**，省/市/区县任意层级都行 —— [\"上海\"]、[\"杭州\"]、[\"上城区\"] 都可以，多个之间是「或」。也可以填完整路径（如 \"中国 浙江 杭州\"），上游会自动转成地名。可选地名见 /get_blogger_filter_options 的 **areas**（到区县）/Blogger location: plain place names work (province/city/district), OR-ed together" }, "signed": { "anyOf": [ { "type": "integer", "enum": [ -1, 0, 1 ] }, { "type": "null" } ], "title": "Signed", "description": "「签约情况」：-1=不限 0=个人博主 1=机构博主" } }, "additionalProperties": false, "type": "object", "title": "BloggerAttrFilter", "description": "博主属性：类目、人设、擅长内容、人群画像、性别、地域、签约情况等。\n\n带层级的选项（类目/人设/擅长内容/内容题材/二十大人群/行业特色画像/预估消费行为）\n先调 `/api/v2/pgy/blogger/filter-options` 取值，各字段说明里写了该取哪一层。" }, { "type": "null" } ], "description": "博主属性筛选/Blogger attribute filters" }, "fans": { "anyOf": [ { "properties": { "count": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「粉丝量」区间" }, "age": { "anyOf": [ { "type": "integer", "enum": [ 0, 1, 2, 3, 4, 5 ] }, { "type": "null" } ], "title": "Age", "description": "「粉丝年龄」：0=不限 1=<18 2=18~24 3=25~34 4=35~44 5=>44 占比高" }, "gender": { "anyOf": [ { "type": "integer", "enum": [ 0, 1, 2 ] }, { "type": "null" } ], "title": "Gender", "description": "「粉丝性别」：0=不限 1=男性占比高 2=女性占比高" }, "marital_status": { "anyOf": [ { "type": "integer", "enum": [ -1, 0, 1 ] }, { "type": "null" } ], "title": "Marital Status", "description": "「婚恋状态」：-1=不限 0=未婚 1=已婚" }, "consumption_level": { "anyOf": [ { "type": "integer", "enum": [ -1, 0, 1, 2 ] }, { "type": "null" } ], "title": "Consumption Level", "description": "「消费水平」：-1=不限 0=低消费 1=中消费 2=高消费" }, "child_age": { "anyOf": [ { "items": { "type": "integer", "enum": [ 0, 2, 3, 4, 5, 6, 7, 8 ] }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Child Age", "description": "「母婴阶段」：0=备孕 2=0-6月 3=7-12月 4=1-3岁 5=4-6岁 6=7-12岁 7=孕早期 8=孕晚期" }, "device_price": { "anyOf": [ { "items": { "type": "string", "enum": [ "0-999", "1000-1999", "2000-2999", "3000-3999", "4000-4999", "5000-5999", "6000-6999", "7000-7999", "8000+" ] }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Device Price", "description": "「手机价格」档位，如 3000-3999 / 8000+" }, "device_brand": { "anyOf": [ { "items": { "type": "string", "enum": [ "苹果", "华为", "OPPO", "VIVO", "荣耀", "小米", "一加", "魅族", "中兴", "联想" ] }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Device Brand", "description": "「手机品牌」" }, "location": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Location", "description": "「粉丝地域」：粉丝所在地。**直接填地名即可**（[\"上海\"]、[\"杭州\"]），上游会自动补成完整路径。也可以自己填完整路径 \"中国 浙江 杭州\"。注意这棵树**只到市**（没有区县），可选地名见 /get_blogger_filter_options 的 **fansAreas**/Fans location: plain place names work; this tree only goes down to city level" } }, "additionalProperties": false, "type": "object", "title": "FansFilter", "description": "粉丝画像 —— 网页「粉丝画像」区（粉丝量 / 年龄 / 性别 / 地域 / 婚恋 / 消费 / 母婴 / 手机）。" }, { "type": "null" } ], "description": "粉丝画像筛选/Fans profile filters" }, "note": { "anyOf": [ { "properties": { "imp_median": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「曝光中位数」" }, "read_median": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「阅读中位数」" }, "inter_median": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「互动中位数」" }, "thousand_like_percent": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 100, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含），百分点 0~100/Min percent 0-100" }, "max": { "anyOf": [ { "type": "number", "maximum": 100, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含），百分点 0~100/Max percent 0-100" } }, "additionalProperties": false, "type": "object", "title": "PercentRange", "description": "百分数区间：按 0~100 的百分点填，`40` 表示 40%（**不是 0.4**）。\n\n口径来自蒲公英网页自己：千赞笔记比例的档位写作 `{\"40%以上\": [40, null]}`、\n`{\"10%以下\": [null, 10]}` —— 发给上游的就是 40 / 10。\n\n**拦得住什么、拦不住什么，说清楚免得误会**：\n* 拦得住「量纲大了」—— 填 200、9500（按万分比或原始条数填）会 422，\n 而通用 RangeFilter 上限是 1e12，这类值原来是直接放行的。\n* **拦不住「量纲小了」**—— 填 0.4 仍然合法，因为 0.4% 本身是正当取值，\n 类型上无法区分「他想写 40% 却写成 0.4」和「他真的要筛 0.4%」。\n 这个方向只能靠字段说明讲清楚。" }, { "type": "null" } ], "description": "「千赞笔记比例」：按 0~100 的百分点填，`20` 表示 20%（**不是 0.2**）/1000-like note ratio, fill 0-100 percent points (20 means 20%)" }, "note_type": { "anyOf": [ { "type": "integer", "enum": [ 0, 1, 2 ] }, { "type": "null" } ], "title": "Note Type", "description": "「笔记类型」：0=不限 1=图文笔记为主 2=视频笔记为主" } }, "additionalProperties": false, "type": "object", "title": "NoteFilter", "description": "日常笔记数据 —— 网页「日常笔记」区（近 30 天自然流量表现）。" }, { "type": "null" } ], "description": "日常笔记数据筛选/Organic note metric filters" }, "coop": { "anyOf": [ { "properties": { "pic_price": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「合作报价」图文笔记一口价（元）" }, "video_price": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「合作报价」视频笔记一口价（元）" }, "order_count": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「合作订单数」：博主**已接受、尚未完成**的订单数量（单）。注意这是**在手订单**，不是历史累计合作数 —— 想找经验丰富的博主不该用它/Open (accepted but unfinished) orders, NOT lifetime collaboration count" }, "reply_48h_ratio": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 100, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含），百分点 0~100/Min percent 0-100" }, "max": { "anyOf": [ { "type": "number", "maximum": 100, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含），百分点 0~100/Max percent 0-100" } }, "additionalProperties": false, "type": "object", "title": "PercentRange", "description": "百分数区间：按 0~100 的百分点填，`40` 表示 40%（**不是 0.4**）。\n\n口径来自蒲公英网页自己：千赞笔记比例的档位写作 `{\"40%以上\": [40, null]}`、\n`{\"10%以下\": [null, 10]}` —— 发给上游的就是 40 / 10。\n\n**拦得住什么、拦不住什么，说清楚免得误会**：\n* 拦得住「量纲大了」—— 填 200、9500（按万分比或原始条数填）会 422，\n 而通用 RangeFilter 上限是 1e12，这类值原来是直接放行的。\n* **拦不住「量纲小了」**—— 填 0.4 仍然合法，因为 0.4% 本身是正当取值，\n 类型上无法区分「他想写 40% 却写成 0.4」和「他真的要筛 0.4%」。\n 这个方向只能靠字段说明讲清楚。" }, { "type": "null" } ], "description": "「合作信用度」48h 邀约回复率：按 0~100 的百分点填，`80` 表示 80%/48h invitation reply rate, fill 0-100 percent points" }, "industry": { "anyOf": [ { "type": "string", "enum": [ "不限", "美妆个护", "食品饮料", "母婴", "3c及电器", "日用百货", "服装配饰", "互联网", "生活服务", "家居建材", "汽车" ] }, { "type": "null" } ], "title": "Industry", "description": "「近期合作行业」" }, "brand_ids": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 20 }, { "type": "null" } ], "title": "Brand Ids", "description": "「近期合作品牌」：品牌 userId 列表" }, "exclude_brands": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Exclude Brands", "description": "配合 brand_ids：true=排除与这些品牌合作过的博主" }, "imp_median": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「传播规模」曝光中位数（合作笔记）" }, "read_median": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「传播规模」阅读中位数（合作笔记）" }, "inter_median": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「传播规模」互动中位数（合作笔记）" }, "cpuv": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「传播规模」进店 UV 中位数：近 30 日跨域合作笔记的进店 UV 量中位数。**这是次数不是金额**（网页档位 500~1000 / 1000~2000 / 2000~5000 / 5000~10000 / 1万以上）；想按「每次进店花多少钱」筛请用 estimate_cpuv/Median store-visit UV COUNT (not cost). For cost use estimate_cpuv" }, "pic_cpm": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「预估CPM」图文" }, "video_cpm": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「预估CPM」视频" }, "pic_read_price": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「预估阅读单价」图文" }, "video_read_price": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「预估阅读单价」视频" }, "pic_engage_cost": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「预估互动单价」图文" }, "video_engage_cost": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「预估互动单价」视频" }, "estimate_cpuv": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「外溢进店单价」" } }, "additionalProperties": false, "type": "object", "title": "CoopFilter", "description": "合作笔记 —— 网页「合作笔记」区（合作表现 + 数据表现）。" }, { "type": "null" } ], "description": "合作笔记数据筛选/Sponsored note metric filters" }, "live": { "anyOf": [ { "properties": { "live_count": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「近30天直播场次」" }, "avg_viewer": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「场均观播人数」：博主**近 90 天**直播的场均观播人数（人）。注意统计窗口是 90 天，与 live_count（30 天）不同/Avg viewers per live over the last **90 days** (live_count uses 30 days)" }, "avg_gmv": { "anyOf": [ { "properties": { "min": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Min", "description": "最小值（含）" }, "max": { "anyOf": [ { "type": "number", "maximum": 1000000000000, "minimum": 0 }, { "type": "null" } ], "title": "Max", "description": "最大值（含）；省略=不限" } }, "additionalProperties": false, "type": "object", "title": "RangeFilter", "description": "数值区间，对应网页筛选里的「自定义」输入框。\n\n- 两端都可省略：省略 `min` 视为 0，省略 `max` 视为不限\n- 至少要给一个端点，否则 422" }, { "type": "null" } ], "description": "「场均销售额」：博主**近 90 天**直播的场均销售额（元）。统计窗口同样是 90 天，与 live_count（30 天）不同/Avg GMV per live over the last **90 days** (live_count uses 30 days)" } }, "additionalProperties": false, "type": "object", "title": "LiveFilter", "description": "直播数据 —— 网页「直播数据」区。" }, { "type": "null" } ], "description": "直播数据筛选/Live metric filters" }, "flags": { "anyOf": [ { "properties": { "is_star": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Star", "description": "「明星」" }, "new_high_quality": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "New High Quality", "description": "「新锐博主」" }, "high_quality": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "High Quality", "description": "「优质博主」" }, "note_and_live": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Note And Live", "description": "「笔记+直播均可合作」" }, "filter_intention": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Filter Intention", "description": "「意向行业匹配」" }, "activity_codes": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Activity Codes", "description": "「热门活动」：填 `/blogger/filter-options` 里 activities 每项的 code" }, "exclude_low_active": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Exclude Low Active", "description": "「剔除低活博主」" }, "exclude_fans_down": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Exclude Fans Down", "description": "「剔除掉粉博主」" }, "exclude_cooperated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Exclude Cooperated", "description": "「剔除已合作博主」" }, "exclude_invited": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Exclude Invited", "description": "「剔除已邀约博主」" }, "industry_first": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "title": "Industry First", "description": "「行业推荐博主」一级行业名（如 美妆个护）；平台会按该行业推荐专属博主" }, "industry_second": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "title": "Industry Second", "description": "「行业推荐博主」二级行业名（配合 industry_first，取 `/blogger/filter-options` 里 industryTags 的 taxonomy2Tags）" } }, "additionalProperties": false, "type": "object", "title": "FlagFilter", "description": "开关类 —— 网页「平台推荐」（精选博主/热门活动）+「常规剔除」（一键剔除）区。" }, { "type": "null" } ], "description": "开关类筛选/Boolean flag filters" } }, "additionalProperties": false } ``` ## Published example This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection. ```json { "tool_id": "tikhub/xiaohongshu-pgy-get-blogger-list", "input": { "page_num": 1, "page_size": 20, "keyword": "", "search_type": 1, "column": "comprehensiverank", "sort": "desc" } } ``` ## Execute and retrieve Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative. A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md). [Provider documentation](https://api.tikhub.io/#/Xiaohongshu-PGY-API/get_blogger_list_api_v1_xiaohongshu_pgy_get_blogger_list_post) [REST inspection](https://api.agentik.cc/v1/tools/tikhub/xiaohongshu-pgy-get-blogger-list) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/tikhub/xiaohongshu-pgy-get-blogger-list) · [Agent index](/llms.txt)