快手(中国)
快手用户搜索 API
按昵称、快手号或主题查找快手(中国)创作者,每页 20 个账号:昵称、公开快手号(kwaiId)、简介、粉丝数、作品数、认证标记和数字用户 id,以 JSON 返回。这是发现创作者的入口:它返回的 id 正是用户主页、用户帖子和用户直播状态接口所需要的。每页消耗 10 积分;快手按接口计费(1、2、10 或 40 积分),四个搜索接口都是 10 积分。采用游标分页。
POST/api/v1/kuaishou/search/users
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonkeywordstringrequired搜索关键词,1 到 200 个字符,可以是昵称、公开快手号(kwaiId)或主题。快手是中文平台:中文关键词能检索到完整内容,拉丁字母关键词只返回快手自己匹配到的结果,通常少得多。如果手上已有分享链接,用分享链接解析接口只需 1 积分,而不是 10 积分。
Example: 人工智能
cursorstring不透明的分页游标(cursor)。第一页不传,之后传入上一次响应中的 pcursor 值。响应字段名是 pcursor,不是 next_cursor。不要传 recoPcursor,那是快手推荐流的另一个游标。pcursor 为 "no_more" 表示没有更多页。
Example: 1
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# 搜索 10 积分,之后每个创作者的帖子每页 1 积分。
page = client.kuaishou.search_users(keyword="人工智能")
for item in page["data"].get("mixFeeds", []):
if item.get("itemType") != 4: # 跳过非用户卡片
continue
user = item["user"]
if user["fansCount"] < 50_000:
continue
print(user["user_name"], user["kwaiId"], user["fansCount"])
posts = client.kuaishou.user_posts(user_id=str(user["user_id"])) # 1 积分
print(len(posts["data"].get("feeds", [])), "recent posts")
cursor = page["data"].get("pcursor") # 不是 next_cursor / recoPcursorResponse
"result": 1,
"pcursor": "1",
"recoPcursor": "no_more",
"userFoldIndex": -1,
"llsid": "2006153956155053250"
},
"response_time": 1522,
"credits_used": 10,
"credits_remaining": 4743
}