# Xiaohongshu PGY LIVE blogger marketplace Replica of PGY "Find Bloggers → Live Blogger Square"; filter live-commerce bloggers by e-commerce conversion, live performance and fans purchasing power 1. Takes page num, page size, seed and more, all optional. Served by TikHub. Purpose: - Replica of PGY "Find Bloggers → Live Blogger Square"; filter live-commerce bloggers by e-commerce conversion, live performance and fans purchasing power 1. Difference from the Note Blogger Square They are **two parallel entry points** with almost no overlapping filters (note seeding vs. live commerce), but they **return the same blogger ID space**, so results are cross-usable. 2. Filter Groups | Group | Covers | |---|---| | `nick_name` | Search by nickname (top-level param, not a group) | | `category` | Cooperation categories (level 1 + 2) | | `buyer` | Buyer groups, content personas | | `ecom` | Average GMV, partner-brand average GMV, average transaction value | | `live` | Live plans (and plan dates) + live performance (avg viewers, peak online) | | `fans` | Fans count, age, gender, consumption power | | `flags` | Actively seeking cooperation, high reply rate, contact visible, worked with brands, follow relations, high live potential, daily broadcaster, celebrity | 3. Range Fields (value = `{"min": x, "max": y}`) | Path | Web filter | |---|---| | `fans.count` | Fans count | | `ecom.avg_gmv` / `ecom.brand_avg_gmv` | Average GMV / partner-brand average GMV (CNY) | | `ecom.atv` | Average transaction value (CNY). Upstream matches by **tier**, so any overlapping tier is included | | `live.avg_viewer` / `live.max_online` | Average viewers / peak concurrent viewers | 4. Boolean Flags (value = `true`) | Path | Web filter | |---|---| | `live.has_plan` | Has live plans (use with `live.plan_days`, format YYYYMMDD) | | `flags.actively_seeking` / `flags.high_reply_rate - Tool ID: `tikhub/xiaohongshu-pgy-get-live-blogger-list` - Name in the catalog: Xiaohongshu, PGY live blogger square - Provider: [TikHub](/providers/tikhub.md) - Capability: [Xiaohongshu live](/tools/xiaohongshu/live.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）/Page size, 1-20", "default": 20 }, "seed": { "type": "integer", "minimum": 0, "title": "Seed", "description": "翻页种子：首页传 0，之后回传上一页返回的 seed/Paging seed, echo back from previous page", "default": 0 }, "nick_name": { "type": "string", "maxLength": 50, "title": "Nick Name", "description": "按博主昵称搜索/Search by nickname", "default": "" }, "category": { "anyOf": [ { "properties": { "first": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "First", "description": "合作品类一级，如 女装/女士精品。取值参考蒲公英「直播博主广场」页的「合作品类」；**单传一级即可用**" }, "second": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 200 }, { "type": "null" } ], "title": "Second", "description": "合作品类二级，如 连衣裙。可留空，只按一级筛同样有效" } }, "additionalProperties": false, "type": "object", "title": "CategoryFilter", "description": "网页「合作品类」区（一级 + 二级，二级需与一级配套）。" }, { "type": "null" } ], "description": "合作品类/Category filters" }, "buyer": { "anyOf": [ { "properties": { "group_tag": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Group Tag", "description": "买手天团标签，如 气质简约（时尚风格/适配身型/美护专研/运动爱好 各组的叶子）。取值参考页面的「买手天团」下拉" }, "persona_tag": { "anyOf": [ { "items": { "type": "string", "maxLength": 64 }, "type": "array", "maxItems": 30 }, { "type": "null" } ], "title": "Persona Tag", "description": "内容人设标签，如 模特（职业身份/家庭角色/特色背景/形式/生活方式/肤质特色/皮肤养护/身材特色 各组的叶子）。取值参考页面的「内容人设」下拉" } }, "additionalProperties": false, "type": "object", "title": "BuyerFilter", "description": "网页「买手天团」+「内容人设」区。" }, { "type": "null" } ], "description": "买手天团 + 内容人设/Buyer group & persona filters" }, "ecom": { "anyOf": [ { "properties": { "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": "数值区间，对应网页筛选的档位或「自定义」输入框。两端可省略，至少给一个。" }, { "type": "null" } ], "description": "场均销售额（元）" }, "brand_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": "数值区间，对应网页筛选的档位或「自定义」输入框。两端可省略，至少给一个。" }, { "type": "null" } ], "description": "合作品牌场均销售额（元）" }, "atv": { "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": "数值区间，对应网页筛选的档位或「自定义」输入框。两端可省略，至少给一个。" }, { "type": "null" } ], "description": "客单价（元）。按**档位**匹配（0-100 / 100-200 / 200-500 …），与你给的区间有重叠的档位都会命中 —— 传 100~300 也会返回 200-500 档的买手" } }, "additionalProperties": false, "type": "object", "title": "EcomFilter", "description": "网页「电商转化力」区。" }, { "type": "null" } ], "description": "电商转化力/E-commerce conversion filters" }, "live": { "anyOf": [ { "properties": { "has_plan": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Has Plan", "description": "有直播计划" }, "plan_days": { "anyOf": [ { "items": { "type": "string", "pattern": "^\\d{8}$" }, "type": "array", "maxItems": 60 }, { "type": "null" } ], "title": "Plan Days", "description": "直播计划日期，YYYYMMDD；配合 has_plan 使用，留空=全部时间" }, "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": "数值区间，对应网页筛选的档位或「自定义」输入框。两端可省略，至少给一个。" }, { "type": "null" } ], "description": "场均观播人数" }, "max_online": { "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": "数值区间，对应网页筛选的档位或「自定义」输入框。两端可省略，至少给一个。" }, { "type": "null" } ], "description": "在线人数峰值" } }, "additionalProperties": false, "type": "object", "title": "LiveFilter", "description": "网页「直播投入度」+「直播表现力」区。" }, { "type": "null" } ], "description": "直播投入度 + 表现力/Live activity & performance 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": "数值区间，对应网页筛选的档位或「自定义」输入框。两端可省略，至少给一个。" }, { "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=女性占比高" }, "consumption": { "anyOf": [ { "items": { "type": "string", "enum": [ "high", "middle", "low" ] }, "type": "array", "maxItems": 3 }, { "type": "null" } ], "title": "Consumption", "description": "粉丝消费力：high / middle / low" } }, "additionalProperties": false, "type": "object", "title": "FansFilter", "description": "粉丝购买力：粉丝量、年龄、性别、消费力。" }, { "type": "null" } ], "description": "粉丝购买力/Fans purchasing power filters" }, "flags": { "anyOf": [ { "properties": { "actively_seeking": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Actively Seeking", "description": "积极寻求合作中" }, "high_reply_rate": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "High Reply Rate", "description": "邀约回复率高" }, "contact_visible": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Contact Visible", "description": "可查看联系方式" }, "cooperated_before": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Cooperated Before", "description": "商单合作过" }, "following": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Following", "description": "你关注TA" }, "follower": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Follower", "description": "TA关注你" }, "live_potential_high": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Live Potential High", "description": "直播潜力高" }, "daily_buyer": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Daily Buyer", "description": "日播买手" }, "is_star": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Star", "description": "明星" } }, "additionalProperties": false, "type": "object", "title": "FlagFilter", "description": "网页「平台推荐 → 精选博主」区（全部为勾选项）。" }, { "type": "null" } ], "description": "平台推荐开关/Platform recommendation flags" } }, "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-live-blogger-list", "input": { "page_num": 1, "page_size": 20, "seed": 0, "nick_name": "" } } ``` ## 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_live_blogger_list_api_v1_xiaohongshu_pgy_get_live_blogger_list_post) [REST inspection](https://api.agentik.cc/v1/tools/tikhub/xiaohongshu-pgy-get-live-blogger-list) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/tikhub/xiaohongshu-pgy-get-live-blogger-list) · [Agent index](/llms.txt)