Kuaishou App User Search
## 用途 按关键词搜索用户,并可按关系、性别和粉丝数排序筛选。适合查找特定主题、关系类型或性别的用户。 ## 参数 - `keyword`:必填,搜索关键词。 - `pcursor`:可选,分页游标。首次请求留空;翻页时填写上一页响应中的游标。 - `user_relation`:可选,关系筛选:`all`(全部)、`same_city`(同城)、`verified`(认证)、`live`(直播中)、`following`(已关注)。 - `user_gender`:可选,性别筛选:`all`(不限)、`male`(男)、`female`(女)。 - `fans_sort`:可选,粉丝数排序:`default`(默认)、`most_to_least`(从多到少)、`least_to_most`(从少到多)。 ## 返回 返回用户搜索结果,包含在 `data` 中的用户数据,以及请求状态和相关响应信息。
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
20.65 credits/call Charges are per query. A successful query is billed even if it returns no results.
User searches by keyword have a fixed fee per call. Fetching the next page with a pagination cursor is a new call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
keyword | string | Yes | 用于搜索用户的关键词。 | — |
pcursor | string | No | 首次留空,翻页传上一页响应的 pcursor / Empty for first page | "" |
fans_sort | enum (default | most_to_least | least_to_most) | No | default / most_to_least / least_to_most | default |
user_gender | enum (all | male | female) | No | all / male / female | all |
user_relation | enum (all | same_city | verified | live | following) | No | all / same_city / verified / live / following | all |
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_kuaishou_app_user_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"fans_sort": "most_to_least",
"keyword": "手机支架",
"pcursor": "",
"user_gender": "all",
"user_relation": "all"
}
}'{
"code": 200,
"data": {
"host-name": "public-bjy-c87-kce-node162.idchb1az2.hb1.kwaidc.com",
"mixFeeds": [
{
"atmosphereType": 0,
"extInfo": {},
"feedLogCtx": {
"stidContainer": "InUxfDIwMDY0ODYyNzIzMzczNzgzNzB8VVNFUjoxODgyMjgzNjY1fHsicGciOiJzdWYifXx7ImJpeiI6InNlYXJjaCIsInJhbmsiOjAsInNzaWQiOiJNVjh3WHpFM09UUXpPVE13T0RVMU1EUmZYemMzTVRjIn0="
},
"isSingleColumnMode": false,
"itemTransferInfo": "{\"refer_single_double_type\":0}",
"itemType": 4
}
],
"portalFlag": true,
"recoPcursor": "no_more",
"userFoldIndex": -1,
"ussid": "MV8wXzE3OTQzOTMwODU1MDRfXzc3MTc"
},
"docs": "https://api.tikhub.io/#/Kuaishou-App-API/search_user_v2_api_v1_kuaishou_app_search_user_v2_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "ec4577d5-a0fc-4909-b79c-a51e3ea211fc"
}This example shows part of the response. Copied content is valid JSON.

