Xiaohongshu Get Live Blogger List
## Purpose Find Xiaohongshu live-commerce creators for cooperation using nickname search and filters for product categories, buyer/persona tags, sales performance, live activity, audience purchasing power and recommendation flags. This tool returns a creator shortlist; it does not send invitations or search note content. ## Inputs Provide the required `request_body` object. All fields inside it are optional; `{"request_body":{}}` uses the default first page. - `nick_name`: nickname search, up to 50 characters. - `category.first` / `category.second`: first- and second-level cooperation categories. First-level categories work on their own; pair second-level categories with the corresponding first level. - `buyer.group_tag` / `buyer.persona_tag`: buyer-group and content-persona labels. - `ecom.avg_gmv`, `ecom.brand_avg_gmv`, `ecom.atv`: average sales per live session, partner-brand average sales per session, and average transaction value, in CNY. - `live.has_plan`, `live.plan_days`: require live plans and optionally select dates as `YYYYMMDD` strings. Use dates with `has_plan=true`; omitting dates leaves time unrestricted. `live.avg_viewer` and `live.max_online` filter average viewers and peak concurrent viewers. - `fans.count`: follower count. `fans.age`: 0=any, 1=under 18, 2=18–24, 3=25–34, 4=35–44, 5=over 44, indicating a high audience share. `fans.gender`: 0=any, 1=male-skewed, 2=female-skewed. `fans.consumption`: any of `high`, `middle`, `low`. - `flags`: set desired switches to `true`, such as `actively_seeking`, `high_reply_rate`, `contact_visible`, `cooperated_before`, `following` (you follow them), `follower` (they follow you), `live_potential_high`, `daily_buyer` and `is_star`. Numeric range filters use `{"min":x,"max":y}` with inclusive bounds; provide at least one bound. Average transaction value (`atv`) matches any overlapping price tier, so results need not fall strictly within the requested numeric range. ## Pagination `page_num` accepts 1–250 (default 1); `page_size` accepts 1–20 (default 20). Start with `seed=0`. Because ranking is randomized, copy the previous response's `seed` exactly into the next request, even if it is 0. Change only `page_num` and the echoed `seed`; keep page size and filters unchanged to avoid duplicates or gaps. Retrieval is limited to the first 5,000 results. `total` is the overall match count, whereas `page_total` is the documented 5,000-item paging cap, not a page count. ## Results When the response layers are non-null, read the payload at `resp["data"]["data"]`: - `distributor_info_list`: matched creators. Each entry contains `distributor_data_info` with `distributor_id` (the blogger `userId`), `red_id`, `distributor_name`, `fans_num`, `atv` (price tier), `avg_sale_amount`, `avg_live_viewer_num`, `max_online_people_num`, `distribution_live_num` (session count), `content_categorys` and `city`. - `distributor_extra_info` within each entry: cooperation interests, commission, contact details and level, where available. Contact details are not guaranteed. - `total`, `page_total`, `seed` and `req_id`: match count, retrieval cap, next-page seed and request identifier. A successful response may contain a null payload or no matches. Check for null before reading nested fields and do not repeat an unchanged request solely because results are empty. ## Example `{"request_body":{"page_num":1,"page_size":20,"seed":0,"category":{"first":["女装/女士精品"]},"ecom":{"avg_gmv":{"min":100000}}}}`
Pricing
| Condition | Charge |
|---|---|
| Each call | 41.31 credits/call |
41.31 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 直播带货博主列表查询请求体对象。可通过 nick_name 按昵称搜索,通过 category、buyer、ecom、live、fans、flags 分别设置合作品类、买手天团与内容人设、电商转化力、直播计划与表现、粉丝购买力及推荐标记筛选;page_num、page_size 和 seed 用于分页,首页 seed 传 0,后续原样回传上一页响应的 seed,并保持其他筛选条件及页大小不变。 | — |
request_body.ecom | unknown | null | No | 电商转化力/E-commerce conversion filters | — |
request_body.ecom.atv | unknown | null | No | 客单价(元)。按**档位**匹配(0-100 / 100-200 / 200-500 …),与你给的区间有重叠的档位都会命中 —— 传 100~300 也会返回 200-500 档的买手 | — |
request_body.ecom.atv.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.ecom.atv.min | number | null | No | 最小值(含) | — |
request_body.ecom.avg_gmv | unknown | null | No | 场均销售额(元) | — |
request_body.ecom.avg_gmv.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.ecom.avg_gmv.min | number | null | No | 最小值(含) | — |
request_body.ecom.brand_avg_gmv | unknown | null | No | 合作品牌场均销售额(元) | — |
request_body.ecom.brand_avg_gmv.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.ecom.brand_avg_gmv.min | number | null | No | 最小值(含) | — |
request_body.fans | unknown | null | No | 粉丝购买力/Fans purchasing power filters | — |
request_body.fans.age | integer | null | No | 粉丝年龄:0=不限 1=<18 2=18-24 3=25-34 4=35-44 5=>44 占比高 | — |
request_body.fans.count | unknown | null | No | 粉丝量 | — |
request_body.fans.count.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.fans.count.min | number | null | No | 最小值(含) | — |
request_body.fans.gender | integer | null | No | 粉丝性别:0=不限 1=男性占比高 2=女性占比高 | — |
request_body.fans.consumption | array | null | No | 粉丝消费力:high / middle / low | — |
request_body.live | unknown | null | No | 直播投入度 + 表现力/Live activity & performance filters | — |
request_body.live.has_plan | boolean | null | No | 有直播计划 | — |
request_body.live.plan_days | array | null | No | 直播计划日期,YYYYMMDD;配合 has_plan 使用,留空=全部时间 | — |
request_body.live.avg_viewer | unknown | null | No | 场均观播人数 | — |
request_body.live.avg_viewer.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.live.avg_viewer.min | number | null | No | 最小值(含) | — |
request_body.live.max_online | unknown | null | No | 在线人数峰值 | — |
request_body.live.max_online.max | number | null | No | 最大值(含);省略=不限 | — |
request_body.live.max_online.min | number | null | No | 最小值(含) | — |
request_body.seed | integer | No | 翻页种子:首页传 0,之后回传上一页返回的 seed/Paging seed, echo back from previous page | 0 |
request_body.buyer | unknown | null | No | 买手天团 + 内容人设/Buyer group & persona filters | — |
request_body.buyer.group_tag | array | null | No | 买手天团标签,如 气质简约(时尚风格/适配身型/美护专研/运动爱好 各组的叶子)。取值参考页面的「买手天团」下拉 | — |
request_body.buyer.persona_tag | array | null | No | 内容人设标签,如 模特(职业身份/家庭角色/特色背景/形式/生活方式/肤质特色/皮肤养护/身材特色 各组的叶子)。取值参考页面的「内容人设」下拉 | — |
request_body.flags | unknown | null | No | 平台推荐开关/Platform recommendation flags | — |
request_body.flags.is_star | boolean | null | No | 明星 | — |
request_body.flags.follower | boolean | null | No | TA关注你 | — |
request_body.flags.following | boolean | null | No | 你关注TA | — |
request_body.flags.daily_buyer | boolean | null | No | 日播买手 | — |
request_body.flags.contact_visible | boolean | null | No | 可查看联系方式 | — |
request_body.flags.high_reply_rate | boolean | null | No | 邀约回复率高 | — |
request_body.flags.actively_seeking | boolean | null | No | 积极寻求合作中 | — |
request_body.flags.cooperated_before | boolean | null | No | 商单合作过 | — |
request_body.flags.live_potential_high | boolean | null | No | 直播潜力高 | — |
request_body.category | unknown | null | No | 合作品类/Category filters | — |
request_body.category.first | array | null | No | 合作品类一级,如 女装/女士精品。取值参考蒲公英「直播博主广场」页的「合作品类」;**单传一级即可用** | — |
request_body.category.second | array | null | No | 合作品类二级,如 连衣裙。可留空,只按一级筛同样有效 | — |
request_body.page_num | integer | No | 页码,1-250(上游只放出前 5000 条)/Page, 1-250 | 1 |
request_body.nick_name | string | No | 按博主昵称搜索/Search by nickname | "" |
request_body.page_size | integer | No | 每页数量,1-20(网页固定 20)/Page size, 1-20 | 20 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_xiaohongshu_get_live_blogger_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"fans": {
"count": {
"min": 10000
}
},
"nick_name": "云台",
"page_num": 1,
"page_size": 20,
"seed": 0
}
}
}'{
"code": 200,
"data": {
"code": 0,
"data": {
"distributor_info_list": [
{
"distributor_data_info": {
"active_fans_rate": 0.9074,
"atv": "0-100",
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/623f4dea454db42c8db0fae5.jpg?imageView2/2/w/80/format/jpg",
"avg_live_viewer_num": "0",
"avg_sale_amount": "0-100",
"avg_sale_amount_value": 0
},
"distributor_extra_info": {
"buyer_bar_list": [],
"grade": 1,
"telephone": "",
"willing_category": [],
"willing_commsion": "不限"
},
"is_star": false,
"show_data": 1
}
],
"page_total": 5,
"req_id": "5ce2e84c-fab2-466d-ac06-0edaf2a8b4c7",
"seed": 0,
"total": 5
},
"msg": "成功",
"success": true
},
"docs": "https://api.tikhub.io/#/Xiaohongshu-PGY-API/get_live_blogger_list_api_v1_xiaohongshu_pgy_get_live_blogger_list_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"buyer": null,
"category": null,
"ecom": null,
"fans": {
"age": null,
"consumption": null,
"count": {
"max": null,
"min": 10000.0
},
"gender": null
},
"flags": null,
"live": null
}
}This example shows part of the response. Copied content is valid JSON.

