Kuaishou Search Creator Ids

有结果 3 积分/次,空结果免费
ae_kuaishou_search_creator_ids

按主播昵称关键词搜索快手磁力聚星账号,直接返回 star_id、昵称、普通快手用户 ID、快手号及账号摘要,包括粉丝数、预期播放、互动指标和人民币报价等信息。star_id 是磁力聚星达人标识,不等同于普通快手用户 ID。结果可能含同名或推荐账号,必须核对后选择目标,不能默认取第一条。查直播主播时传 star_type=4;默认搜索短视频作者。支持分类筛选、排序和分页。选中的 star_id 可用于查询主播整体观众画像和账号近30天带货统计。本工具只按昵称搜索,不接受快手主页 URL 直接转换,也不能保证所有快手账号都已被磁力聚星收录。

社交
有结果 3 积分/次,空结果免费

价格说明

返回结果费用
有结果3积分/次
无结果0积分/次

(有结果):3 AE积分/次。 (无结果):0 AE积分/次。

此起价适用于成功返回结果的请求。每次请求或分页请求分别计费;每页返回条数不影响单价。成功但无结果时不收费。

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
pageinteger否页码,取值 1–50,默认 1。响应中的 cursor 是下一页的 page 值;有更多结果时可据此继续查询。1
tag_idstring否内容一级分类 ID,填写三位数字字符串,如 673 美食、677 生活、695 搞笑;使用 sub_ids 时必须同时提供此字段。—
keywordstring是主播昵称关键词,1至50字;只接收昵称,不接收快手主页URL、普通用户ID或直播ID。搜索可能返回同名或推荐账号,不能直接取第一条。—
sort_byenum (3 | 1 | 2 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 42)否排序字段,默认 3:3 默认排序,2 粉丝数,20 预期播放,21 预期 CPM,22 互动率,23 完播率,24 涨粉量,25 涨粉率,42 深度连接用户数,1 报价;直播达人另有 26 预期观看人数、27 最高在线人数。选择非 3 的排序字段时,必须同时传 sort_order=1 或 2。3
sub_idsstring否二级分类 ID 字符串,包含 1–20 个三位数字 ID,多个 ID 用英文逗号分隔;传入时必须同时提供 tag_id。—
page_sizeinteger否每页返回条数,取值 1–50,默认 20。20
star_typeenum (1 | 4)否作者类型:1为短视频作者(默认),4为直播主播;查直播主播请明确传4。1
sort_orderenum (0 | 1 | 2)条件必填排序方向:0 默认排序,1 升序,2 降序。sort_by 为 3 或省略时,只能使用 0(默认值);sort_by 为其他值时,必须明确传 1 或 2。0

调用示例

复制请求代码,查看对应的返回示例。

POST/agent-api/v1/tool/executeX-Api-Key
请求代码request.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_kuaishou_search_creator_ids' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "陈皮",
    "page": 1,
    "page_size": 30,
    "sort_by": 2,
    "sort_order": 2,
    "star_type": 4
  }
}'
返回示例response.json
JSON部分内容
{
  "data": {
    "cursor": null,
    "has_more": false,
    "items": [
      {
        "avatar": "https://p4-ad.adukwai.com/uhead/AB/2023/03/14/01/BMjAyMzAzMTQwMTQ0NDFfNzg0NjgxMzgxXzFfaGQ0ODZfODk0_s.jpg?x-kcdn-pid=12697",
        "completion_rate": 0.26587,
        "content_tags": [
          "生活"
        ],
        "expected_cpm": 96,
        "id": "soc_clj_ad1bb1074347",
        "name": "陈皮先生"
      }
    ],
    "total": 14
  }
}

返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。