Kuaishou Search Creator Ids

3 credits per call with results; no results are free
ae_kuaishou_search_creator_ids

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

Social
3 credits per call with results; no results are free

Pricing

3 credits per call with results; no results are free
Result statusCharge
Results found3 credits/call
No results0 credits/call

(Results found): 3 AE credits per call. (No results): 0 AE credits per call.

This starting charge applies to successful requests that return results. Each request or paginated request is charged separately. Page size does not affect the rate. Successful requests with no results are free.

Parameters

Optional parameters use the platform defaults when omitted.

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

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_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 exampleresponse.json
JSONPartial content
{
  "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
  }
}

This example shows part of the response. Copied content is valid JSON.