Xiaohongshu Get Live Blogger List

41.31 credits/call
ae_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}}}}`

Social
41.31 credits/call

Pricing

41.31 credits/call
ConditionCharge
Each call41.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes直播带货博主列表查询请求体对象。可通过 nick_name 按昵称搜索,通过 category、buyer、ecom、live、fans、flags 分别设置合作品类、买手天团与内容人设、电商转化力、直播计划与表现、粉丝购买力及推荐标记筛选;page_num、page_size 和 seed 用于分页,首页 seed 传 0,后续原样回传上一页响应的 seed,并保持其他筛选条件及页大小不变。—
request_body.ecomunknown | nullNo电商转化力/E-commerce conversion filters—
request_body.ecom.atvunknown | nullNo客单价(元)。按**档位**匹配(0-100 / 100-200 / 200-500 …),与你给的区间有重叠的档位都会命中 —— 传 100~300 也会返回 200-500 档的买手—
request_body.ecom.atv.maxnumber | nullNo最大值(含);省略=不限—
request_body.ecom.atv.minnumber | nullNo最小值(含)—
request_body.ecom.avg_gmvunknown | nullNo场均销售额(元)—
request_body.ecom.avg_gmv.maxnumber | nullNo最大值(含);省略=不限—
request_body.ecom.avg_gmv.minnumber | nullNo最小值(含)—
request_body.ecom.brand_avg_gmvunknown | nullNo合作品牌场均销售额(元)—
request_body.ecom.brand_avg_gmv.maxnumber | nullNo最大值(含);省略=不限—
request_body.ecom.brand_avg_gmv.minnumber | nullNo最小值(含)—
request_body.fansunknown | nullNo粉丝购买力/Fans purchasing power filters—
request_body.fans.ageinteger | nullNo粉丝年龄:0=不限 1=<18 2=18-24 3=25-34 4=35-44 5=>44 占比高—
request_body.fans.countunknown | nullNo粉丝量—
request_body.fans.count.maxnumber | nullNo最大值(含);省略=不限—
request_body.fans.count.minnumber | nullNo最小值(含)—
request_body.fans.genderinteger | nullNo粉丝性别:0=不限 1=男性占比高 2=女性占比高—
request_body.fans.consumptionarray | nullNo粉丝消费力:high / middle / low—
request_body.liveunknown | nullNo直播投入度 + 表现力/Live activity & performance filters—
request_body.live.has_planboolean | nullNo有直播计划—
request_body.live.plan_daysarray | nullNo直播计划日期,YYYYMMDD;配合 has_plan 使用,留空=全部时间—
request_body.live.avg_viewerunknown | nullNo场均观播人数—
request_body.live.avg_viewer.maxnumber | nullNo最大值(含);省略=不限—
request_body.live.avg_viewer.minnumber | nullNo最小值(含)—
request_body.live.max_onlineunknown | nullNo在线人数峰值—
request_body.live.max_online.maxnumber | nullNo最大值(含);省略=不限—
request_body.live.max_online.minnumber | nullNo最小值(含)—
request_body.seedintegerNo翻页种子:首页传 0,之后回传上一页返回的 seed/Paging seed, echo back from previous page0
request_body.buyerunknown | nullNo买手天团 + 内容人设/Buyer group & persona filters—
request_body.buyer.group_tagarray | nullNo买手天团标签,如 气质简约(时尚风格/适配身型/美护专研/运动爱好 各组的叶子)。取值参考页面的「买手天团」下拉—
request_body.buyer.persona_tagarray | nullNo内容人设标签,如 模特(职业身份/家庭角色/特色背景/形式/生活方式/肤质特色/皮肤养护/身材特色 各组的叶子)。取值参考页面的「内容人设」下拉—
request_body.flagsunknown | nullNo平台推荐开关/Platform recommendation flags—
request_body.flags.is_starboolean | nullNo明星—
request_body.flags.followerboolean | nullNoTA关注你—
request_body.flags.followingboolean | nullNo你关注TA—
request_body.flags.daily_buyerboolean | nullNo日播买手—
request_body.flags.contact_visibleboolean | nullNo可查看联系方式—
request_body.flags.high_reply_rateboolean | nullNo邀约回复率高—
request_body.flags.actively_seekingboolean | nullNo积极寻求合作中—
request_body.flags.cooperated_beforeboolean | nullNo商单合作过—
request_body.flags.live_potential_highboolean | nullNo直播潜力高—
request_body.categoryunknown | nullNo合作品类/Category filters—
request_body.category.firstarray | nullNo合作品类一级,如 女装/女士精品。取值参考蒲公英「直播博主广场」页的「合作品类」;**单传一级即可用**—
request_body.category.secondarray | nullNo合作品类二级,如 连衣裙。可留空,只按一级筛同样有效—
request_body.page_numintegerNo页码,1-250(上游只放出前 5000 条)/Page, 1-2501
request_body.nick_namestringNo按博主昵称搜索/Search by nickname""
request_body.page_sizeintegerNo每页数量,1-20(网页固定 20)/Page size, 1-2020

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.