快手 API - 视频搜索 (V2)
支持通过关键词搜索快手视频，返回匹配结果，包含视频ID、封面图、描述、作者信息、发布时间及互动数据。
典型应用场景：
- 竞品分析与市场趋势洞察
- 关键词监控与品牌追踪
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 此 API 服务的访问令牌。 |
keyword | query | string | 是 | 用于查找视频的搜索关键词。 |
page | query | integer | 否 | 结果页码，从1开始。 |
代码示例
💡 环境说明
默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。
bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE"text
我想使用 Just One API 提供的“视频搜索 (V2)”接口。
接口地址: https://api.justoneapi.com/api/kuaishou/search-video/v2
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/kuaishou-apis/video-search-v2-zh.json
请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- keyword (query): 用于查找视频的搜索关键词。 (必填)
- page (query): 结果页码，从1开始。
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE"
response = requests.get(url)
print(response.json())js
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果
json
{
"code": 0,
"data": {
"result": 1,
"recoPcursor": "no_more",
"ussid": "MTRfNDcwNDQxMzgwN18xNzczMDY0ODAyMDcxX18zODcy",
"portalFlag": true,
"extParams": {
"disablePhotoInsert": false,
"rsRecoAfterPlayInterval": 2,
"dynamicShard": false,
"isShowPymkUserPhotos": true,
"searchTaskParam": {},
"streamExtParams": "{\"single\":false,\"predict\":false,\"searchDetailCost\":{\"filterItem\":1,\"getView\":158}}",
"isShowScrollTopButton": false,
"subtagWithPic": false
},
"feeds": [
{
"longVideo": true,
"editInfo": {},
"supportType": 0,
"bottomEntryInfo": {
"eventTrackData": {
"entry_source": "search_entrance_featured_bottom_bar_search",
"stg_recall_source": "p2q_recall_exp_v17",
"query_id": "591827fae2da22fa67b97c7a25d9532e",
"query_name": "吃糖果的视频",
"is_hotbar": "\u0000",
"all_source": "p2q_avi_inner,p2q_semantic_recall_v7,p2q_semantic_recall_v1,p2q_vfs_realtime,p2q_recall_exp_v17",
"query_list_id": "MzIwXzQ3MDQ0MTM4MDdfMTc3MzA2NDgwMjc1OF9fMjY1NA",
"rel_score": "0.000000"
},
"bizExtraData": {},
"bottomBizType": 14,
"bottomStyleInfo": {
"bottomWeakStyle": {
"title": "相关搜索・吃糖果的视频",
"iconUrl": "https://p5-plat.wskwai.com/udata/pkg/se-cdn/caption_fangdajin.png",
"actionUrl": "kwai://search?keyword=吃糖果的视频&sessionId=MzIwXzQ3MDQ0MTM4MDdfMTc3MzA2NDgwMjc1OF9fMjY1NA&source=search_...",
"fontColor": "#FFFFFF",
"fontSize": 14,
"visibility": 40,
"backgroundColor": "#222222",
"roundCorner": false,
"enableForceClose": false,
"iconWidth": 48,
"iconHeight": 48,
"notTruncatedTitle": "",
"showSeparator": false,
"iconTextSuffix": "",
"preTitle": "",
"tailIconUrl": "",
"bottomWeakStyleType": 0,
"showArrow": true,
"showClose": false,
"label": "",
"users": [],
"jumpText": ""
},
"bottomStrongStyle": {
"title": "",
"iconUrl": "",
"actionUrl": "",
"fontColor": "",
"fontSize": 0,
"visibility": 0,
"backgroundColor": "",
"roundCorner": false,
"enableForceClose": false,
"iconWidth": 0,
"iconHeight": 0,
"showSeparator": false,
"preTitle": "",
"tailIconUrl": "",
"labels": [],
"bottomStrongStyleType": 0,
"needToRequestStrongApi": false,
"strongStyleItems": []
},
"showStrongVideoMillis": 0,
"showStrongVideoCountdownMillis": 0,
"playVideoEndToStrongMillis": 0,
"weakToStrongAction": [],
"strongStyleCloseHideWeakStyle": false,
"styleTriggers": [],
"delayShowWeakStyle": false
}
},
"fastCommentType": 1,
"enableFullScreenPlay": false,
"ptp": "",
"sourcePhotoPage": "sff",
"enableRecommendedGuide": true,
"hasVote": false,
"commentInfo": {
"permissions": 191,
"commentCountSpecialEffect": true,
"enableAIPresetGuide": false,
"commentIconType": 0
},
"videoColdStartType": 0,
"savePlayProgressStrategy": 0,
"feedSwitches": {
"disableCommentLikeAnimation": false,
"disable61ActivityAnimation": true,
"enablePlayerPanel": false,
"enablePictureCommentForPhoto": true
},
"type": 1,
"duration": 152233,
"plcFeatureEntryAbFlag": 0,
"noNeedToRequestPLCApi": true,
"plcResponseTime": 0,
"plcHighPriorityThanBottomEntry": false,
"liked": 0,
"streamManifest": {
"version": "1.0.0",
"businessType": 2,
"mediaType": 2,
"videoId": "033d14ef3b715769",
"hideAuto": false,
"manualDefaultSelect": false,
"adaptationSet": [
{
"id": 1,
"duration": 152233,
"representation": [
{
"id": 1,
"url": "http://v2-zj-scct.kwaicdn.com/bs2/photo-video-mz/5214605578063319809_033d14ef3b715769_3766_sl200hd15...",
"backupUrl": [
"http://tymov2.a.kwimgs.com/bs2/photo-video-mz/5214605578063319809_033d14ef3b715769_3766_sl200hd15.mp..."
],
"maxBitrate": 3800,
"avgBitrate": 976,
"width": 720,
"height": 1280,
"frameRate": 30,
"quality": 1,
"qualityType": "720p",
"qualityLabel": "高清",
"featureP2sp": false,
"p2spCode": "{\"fRsn\":0,\"fixOpt\":-1,\"schTask\":\"\",\"schCode\":-1,\"schRes\":\"\",\"pushTask\":\"v=0&p=0&s=0&d=0\",\"pushCode\":...",
"hidden": false,
"disableAdaptive": false,
"defaultSelect": false,
"comment": "videoId=033d14ef3b715769/tt=sl200hd15",
"hdrType": 0,
"bitratePattern": [
1831
],
"agc": false,
"mute": false,
"oriLoudness": 0,
"makeupGain": 0,
"realLoudness": 0,
"realNormalizeGain": 0,
"normalizeGain": 0
}
]
}
]
},
"main_url": "http://p66-plat.wsukwai.com/upic/2025/03/30/16/BMjAyNTAzMzAxNjU2MjhfMTA0ODE3NzE3Ml8xNjA0OTc0NDk2OTdf...",
"main_mv_urls": [
{
"cdn": "bdmov.a.yximgs.com",
"url": "http://bdmov.a.yximgs.com/upic/2025/03/30/16/BMjAyNTAzMzAxNjU2MjhfMTA0ODE3NzE3Ml8xNjA0OTc0NDk2OTdfMV..."
}
],
"thumbnail_url": "http://p66-plat.wsukwai.com/upic/2025/03/30/16/BMjAyNTAzMzAxNjU2MjhfMTA0ODE3NzE3Ml8xNjA0OTc0NDk2OTdf...",
"cover_thumbnail_urls": [
{
"cdn": "p66-plat.wsukwai.com",
"url": "http://p66-plat.wsukwai.com/upic/2025/03/30/16/BMjAyNTAzMzAxNjU2MjhfMTA0ODE3NzE3Ml8xNjA0OTc0NDk2OTdf..."
}
],
"thumbnail_urls": [
{
"cdn": "p66-plat.wsukwai.com",
"url": "http://p66-plat.wsukwai.com/upic/2025/03/30/16/BMjAyNTAzMzAxNjU2MjhfMTA0ODE3NzE3Ml8xNjA0OTc0NDk2OTdf..."
}
],
"main_mv_url": "http://bdmov.a.yximgs.com/upic/2025/03/30/16/BMjAyNTAzMzAxNjU2MjhfMTA0ODE3NzE3Ml8xNjA0OTc0NDk2OTdfMV...",
"us_c": 0,
"comment_count": 6650,
"slideCommentEntryDisabled": false,
"frameStyle": 0,
"verified": false,
"kwaiId": "yy157720",
"following": 0,
"headurls": [
{
"cdn": "p4.a.yximgs.com",
"url": "http://p4.a.yximgs.com/uhead/AB/2023/10/21/09/BMjAyMzEwMjEwOTUyMzlfMTA0ODE3NzE3Ml8xX2hkNTA4XzY5_s.jp..."
}
],
"headurl": "http://p4.a.yximgs.com/uhead/AB/2023/10/21/09/BMjAyMzEwMjEwOTUyMzlfMTA0ODE3NzE3Ml8xX2hkNTA4XzY5_s.jp...",
"user_sex": "F",
"us_l": true,
"user_name": "园园爱吃喝",
"location": {},
"time": "2025-03-30 16:57:07",
"timestamp": 1743325027129,
"pureTitle": " #老铁饭搭子召集令 #老铁的锅气江湖 #儿童趣味视频 #网红糖果",
"like_count": 49533,
"caption": "#老铁饭搭子召集令 #老铁的锅气江湖 #儿童趣味视频 #网红糖果 @快手美食(O40300058) @快手创作者中心(O40300138) @快手创作者小助手(O690625089) @我要上热门(O...",
"forward_count": 0,
"view_count": 3275481,
"share_count": 6138,
"photo_id": 5214605578063320000,
"photo_status": 0,
"shareGuide": {},
"us_d": 1,
"share_info": "",
"forward_stats_params": {
"fid": "4704413807",
"et": "1_i/2005611291594891794_sff0"
},
"enableShareToStory": true,
"recoTags": [],
"tags": [],
"tag_hash_type": 1,
"adminTags": [],
"exp_tag": "1_i/2005611291594891794_sff0",
"ext_params": {
"mtype": 3,
"color": "131010",
"w": 720,
"sound": 152229,
"h": 1280,
"interval": 30,
"video": 152233
},
"serverExpTag": "feed_photo|5214605578063319809|1048177172|1_i/2005611291594891794_sff0|{\"SearchSessionId\":\"MTRfNDcwN...",
"followShoot": {
"isLipsSyncPhoto": false
},
"user_id": 1048177172,
"feedLogCtx": {
"stidContainer": "CkQxfDIwMDU2MTEyOTE1OTQ4OTE3OTR8cGhvdG86NTIxNDYwNTU3ODA2MzMxOTgwOXx7InBnIjoic2ZmIn18eyJyIjowfSKMATF8...",
"stExParams": ""
}
}
],
"pcursor": "1",
"llsid": "2005611291594891794",
"jumpToSlideMode": false,
"host-name": "public-bjmt-c56-kce-node304.idchb1az4.hb1.kwaidc.com",
"recoInterestFlag": false,
"responseCode": 0
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。