快手 API - 视频详情 (V2)
提供特定快手视频的详细信息，包括视频URL、标题、作者信息、发布时间及互动数据（点赞、评论、分享）。
典型应用场景：
- 深度内容表现分析
- 构建热门视频数据库
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 此 API 服务的访问令牌。 |
videoId | query | string | 是 | 快手视频的唯一ID。 |
代码示例
💡 环境说明
默认示例使用 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/get-video-detail/v2?token=YOUR_API_KEY&videoId=VALUE"text
我想使用 Just One API 提供的“视频详情 (V2)”接口。
接口地址: https://api.justoneapi.com/api/kuaishou/get-video-detail/v2
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/kuaishou-apis/video-details-v2-zh.json
请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- videoId (query): 快手视频的唯一ID。 (必填)
返回格式: 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/get-video-detail/v2?token=YOUR_API_KEY&videoId=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/get-video-detail/v2?token=YOUR_API_KEY&videoId=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/get-video-detail/v2?token=YOUR_API_KEY&videoId=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/get-video-detail/v2?token=YOUR_API_KEY&videoId=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/get-video-detail/v2?token=YOUR_API_KEY&videoId=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,
"photos": [
{
"longVideo": true,
"editInfo": {},
"photoReward": {
"canFreeFavorAuthor": false,
"favorGuideStrategy": 0,
"descNotClickText": "98 赞赏",
"rewardCount": 98
},
"supportType": 0,
"danmakuInfo": {
"disablePost": true,
"disableReasonTip": "该作品暂不支持弹幕功能",
"disableReasonKey": "SERVER_DISABLE",
"photoDanmakuGuide": false,
"paster": false
},
"enableFullScreenPlay": false,
"showProgressEnterDetail": true,
"ptp": "",
"sourcePhotoPage": "sp",
"collect_count": 24293,
"hasVote": false,
"commentInfo": {
"permissions": 191,
"enableAIPresetGuide": false,
"commentCountSpecialEffect": true,
"commentIconType": 0
},
"videoColdStartType": 0,
"savePlayProgressStrategy": 0,
"enableCoronaDetailPage": false,
"feedSwitches": {
"disableCommentLikeAnimation": false,
"disable61ActivityAnimation": true,
"enablePlayerPanel": false,
"enablePictureCommentForPhoto": true
},
"type": 1,
"duration": 89116,
"plcFeatureEntryAbFlag": 0,
"noNeedToRequestPLCApi": true,
"plcResponseTime": 1773065478053,
"plcHighPriorityThanBottomEntry": false,
"liked": 0,
"streamManifest": {
"version": "1.0.0",
"businessType": 2,
"mediaType": 2,
"videoId": "c7bd77a1ed6b1e2e",
"hideAuto": false,
"manualDefaultSelect": false,
"stereoType": 0,
"adaptationSet": [
{
"id": 1,
"duration": 89166,
"representation": [
{
"id": 1,
"url": "http://v2-zj-scct.kwaicdn.com/ksc1/_4X0jhEDlPPvk9aipNdrPpfwNkv6aIoREDo3KO2zmEhDO72121DIPvkgKb_zoA9sjxy4rOxqH5_R0ko46PD02GInlx_dvDCpxcCOXyeeBIssQAwulpaxgOsCDgPW9aEd.mp4?tag=1-1773065478-sp-0-nnrd081ssq-a635554294a59bf5&provider=self&clientCacheKey=3xg9avuebhtfcku_0e9ca006&di=abdefdc4&bp=14971&x-ks-ptid=178912366162&kwai-not-alloc=self-cdn&kcdntag=p:Sichuan;i:ChinaTelecom;ft:UNKNOWN;h:UNKNOWN;pn:kuaishouVideoProjection&Aecs=172.19.0.244&ocid=100000971&tt=sl200hd15&ss=vpm",
"backupUrl": [
"http://v23-3.kwaicdn.com/bs2/photo-video-mz/5251478817858568382_c7bd77a1ed6b1e2e_4267_sl200hd15.mp4?pkey=AAWOHFEG2L247IfUPrMm1gDxF6Z2AruWcGBrC2gj_deMmQjDeOS227f3RHcbOdfCMsWc_8wEltBzZ7PzB-j6pCbnh3gh-DH2RSLGj_S5lDPKygebbcTSC-99jF80QNi0Zi0&tag=1-1773065478-sp-1-a2keh21fba-ee54a3c7163716c0&clientCacheKey=3xg9avuebhtfcku_0e9ca006&di=abdefdc4&bp=14971&kwai-not-alloc=0&type=cold&tt=sl200hd15&ss=vpm"
],
"maxBitrate": 3800,
"avgBitrate": 623,
"width": 960,
"height": 720,
"frameRate": 30.000225,
"quality": 1.5,
"kvqScore": {
"FR": -1,
"NR": 3.4118,
"FRPost": -1,
"NRPost": -1,
"kvqVersion": "v7",
"sharpness": 0.30090001225471497,
"blur": 0.16110000014305115
},
"qualityType": "720p",
"qualityLabel": "高清",
"featureP2sp": false,
"p2spCode": "{\"fRsn\":0,\"fixOpt\":-1,\"schTask\":\"\",\"schCode\":-1,\"schRes\":\"\",\"pushTask\":\"v=0&p=0&s=0&d=0\",\"pushCode\":-1}",
"hidden": false,
"disableAdaptive": false,
"defaultSelect": false,
"comment": "videoId=c7bd77a1ed6b1e2e/ttExplain=HEVC_SL200 Superslow_720P_高码率_Turbo/tt=sl200hd15",
"hdrType": 0,
"fileSize": 6952246,
"bitratePattern": [
894,
590,
1926,
6,
334
],
"agc": true,
"mute": false,
"oriLoudness": -9.792,
"makeupGain": 1.096,
"realLoudness": -8.598,
"realNormalizeGain": 1,
"normalizeGain": 1,
"volumeInfo": {
"loudness": -9.5,
"th": -19.5,
"lra": 2.3,
"lraTh": -29.5,
"lraLow": -10.7,
"lraHigh": -8.5,
"tp": 0.3
}
},
{
"id": 2,
"url": "http://v2-zj-scct.kwaicdn.com/ksc1/ZUMTb3heEDDa6GOHlP6ad0gJMCaMiDB5UIzih5G7CLzxhXa050bALL2uv03mGO66X-1iyqfooA5thAid39OzpTYkiNlN7q7PWKCmh7d8Rvts0UXWkSMRJ8KL90u-Ey46.mp4?tag=1-1773065478-sp-0-h1o1dzt8gu-42e58af9d7118c84&provider=self&clientCacheKey=3xg9avuebhtfcku_0d0c94fe&di=abdefdc4&bp=14971&x-ks-ptid=178912366162&kwai-not-alloc=self-cdn&kcdntag=p:Sichuan;i:ChinaTelecom;ft:UNKNOWN;h:UNKNOWN;pn:kuaishouVideoProjection&Aecs=172.19.0.244&ocid=100000971&tt=avcxp1&ss=vpm",
"backupUrl": [
"http://v23-3.kwaicdn.com/bs2/photo-video-mz/5251478817858568382_c7bd77a1ed6b1e2e_2039_avcxp1.mp4?pkey=AAUHmFSC-iOei-D0KYTGNu_Nonuq2FtbI4584JKcZtjwRysSh_KbJ54JwiaeAspLSZ-8F42OT3cRZO1-8dtlMz4LYzS42KDt9942dICh-aY-eaBTvC9ZgCWaYeAjB8hHjqg&tag=1-1773065478-sp-1-qb0mriwfpp-e298aed4e3a64a97&clientCacheKey=3xg9avuebhtfcku_0d0c94fe&di=abdefdc4&bp=14971&kwai-not-alloc=0&type=cold&tt=avcxp1&ss=vpm"
],
"maxBitrate": 1100,
"avgBitrate": 730,
"width": 768,
"height": 576,
"frameRate": 30.000225,
"quality": 1.4,
"kvqScore": {
"FR": -1,
"NR": -1,
"FRPost": -1,
"NRPost": -1
},
"qualityType": "576p",
"qualityLabel": "标清",
"featureP2sp": false,
"p2spCode": "{\"fRsn\":0,\"fixOpt\":-1,\"schTask\":\"\",\"schCode\":-1,\"schRes\":\"\",\"pushTask\":\"v=0&p=0&s=0&d=0\",\"pushCode\":-1}",
"hidden": false,
"disableAdaptive": false,
"defaultSelect": false,
"comment": "videoId=c7bd77a1ed6b1e2e/ttExplain=AVC_VeryFast_576P_高码率/tt=avcxp1",
"hdrType": 0,
"fileSize": 8138200,
"bitratePattern": [
1033,
664,
1684,
6,
349
],
"agc": false,
"mute": false,
"oriLoudness": 0,
"makeupGain": 0,
"realLoudness": -9.557,
"realNormalizeGain": 1,
"normalizeGain": 0,
"volumeInfo": {
"loudness": -9.5,
"th": -19.5,
"lra": 2.3,
"lraTh": -29.5,
"lraLow": -10.7,
"lraHigh": -8.5,
"tp": 0.3
}
}
]
}
],
"playInfo": {
"bizType": 0,
"cdnTimeRangeLevel": 0,
"strategyBus": "{ }"
},
"videoFeature": {
"blurProbability": 0.07058105617761612,
"blockyProbability": 0.4799562990665436,
"avgEntropy": 10.712367331981659,
"mosScore": 0.659912109375
},
"audioFeature": {
"audioQuality": 75.1139,
"musicProbability": 0.6723,
"dialogProbability": 0.3277,
"backgroundSoundProbability": 0,
"stereophonicRichness": 0,
"audioClip": 0.0008,
"audioSnr": 60,
"effectiveBandwidthInHz": 13818.859
}
},
"main_mv_urls": [
{
"cdn": "tymov-s.a.kwimgs.com",
"url": "http://tymov-s.a.kwimgs.com/upic/2025/11/02/19/BMjAyNTExMDIxOTAxMzVfMzIzNzkxMjUyMV8xNzg5MTIzNjYxNjJfMl8z_b_Bb746847c3d9d15d75f5855a10b89c00f.mp4?tag=1-1773065478-sp-0-ej6noc0rpj-dda24bf7a6a5b95a&type=hot&clientCacheKey=3xg9avuebhtfcku_b.mp4&tt=b&di=abdefdc4&bp=14971"
},
{
"cdn": "v4.kwaicdn.com",
"url": "http://v4.kwaicdn.com/upic/2025/11/02/19/BMjAyNTExMDIxOTAxMzVfMzIzNzkxMjUyMV8xNzg5MTIzNjYxNjJfMl8z_b_Bb746847c3d9d15d75f5855a10b89c00f.mp4?pkey=AAWsRxZk82te1P3nVbR9SdoeDy36GTZOWxEfJy8Pj1VThJacZGqf6GPr8b1lDhi-Hv55VFdXznCPf43rBmblEcyhxXU9yEaQVpcst88q0MvWQoMpRaxuW-SbJAI2ogwOPu4&tag=1-1773065478-sp-1-efch7ko4uh-028237f58424664e&type=hot&clientCacheKey=3xg9avuebhtfcku_b.mp4&tt=b&di=abdefdc4&bp=14971"
}
],
"cover_thumbnail_urls": [
{
"cdn": "p66-plat.wsukwai.com",
"url": "http://p66-plat.wsukwai.com/upic/2025/11/02/19/BMjAyNTExMDIxOTAxMzVfMzIzNzkxMjUyMV8xNzg5MTIzNjYxNjJfMl8z_low_B94b4fc72eff0e93affe1ba7839171dec.webp?tag=1-1773065478-sp-0-7lflslyoam-15032658b067d9bf&type=hot&clientCacheKey=3xg9avuebhtfcku_low.webp&di=abdefdc4&bp=14971"
},
{
"cdn": "ali2.a.kwimgs.com",
"url": "http://ali2.a.kwimgs.com/upic/2025/11/02/19/BMjAyNTExMDIxOTAxMzVfMzIzNzkxMjUyMV8xNzg5MTIzNjYxNjJfMl8z_low_B94b4fc72eff0e93affe1ba7839171dec.webp?tag=1-1773065478-sp-1-uv9ylczzlp-2d5450f33fdc82bf&type=hot&clientCacheKey=3xg9avuebhtfcku_low.webp&di=abdefdc4&bp=14971"
}
],
"ff_cover_thumbnail_urls": [
{
"cdn": "p66-plat.wsukwai.com",
"url": "http://p66-plat.wsukwai.com/upic/2025/11/02/19/BMjAyNTExMDIxOTAxMzVfMzIzNzkxMjUyMV8xNzg5MTIzNjYxNjJfMl8z_ff_B6e5a5331277f49ab226f0c989202eed1.kpg?tag=1-1773065478-sp-0-nr81ll4zxy-3d1546687f170560&type=hot&clientCacheKey=3xg9avuebhtfcku_ff.kpg&di=abdefdc4&bp=14971"
},
{
"cdn": "ali2.a.kwimgs.com",
"url": "http://ali2.a.kwimgs.com/upic/2025/11/02/19/BMjAyNTExMDIxOTAxMzVfMzIzNzkxMjUyMV8xNzg5MTIzNjYxNjJfMl8z_ff_B6e5a5331277f49ab226f0c989202eed1.kpg?tag=1-1773065478-sp-1-x9sgltyyyp-60f13933c8651bb3&type=hot&clientCacheKey=3xg9avuebhtfcku_ff.kpg&di=abdefdc4&bp=14971"
}
],
"us_c": 0,
"comment_count": 742,
"slideCommentEntryDisabled": false,
"frameStyle": 0,
"kwaiId": "Boluocut",
"verified": false,
"following": 0,
"user_name": "苏暮尘",
"user_sex": "M",
"headurls": [
{
"cdn": "p23.a.yximgs.com",
"url": "http://p23.a.yximgs.com/uhead/AB/2025/11/01/23/BMjAyNTExMDEyMzA2NDJfMzIzNzkxMjUyMV8yX2hkNjQxXzIwNg==_s.jpg"
},
{
"cdn": "p4.a.yximgs.com",
"url": "http://p4.a.yximgs.com/uhead/AB/2025/11/01/23/BMjAyNTExMDEyMzA2NDJfMzIzNzkxMjUyMV8yX2hkNjQxXzIwNg==_s.jpg"
}
],
"us_l": true,
"location": {},
"time": "2025-11-02 19:02:28",
"timestamp": 1762081348963,
"originalPhotoId": "3xg9avuebhtfcku",
"like_count": 114316,
"caption": "独属国人的浪漫 #神仙剪刀手 #诗句 #电影美学 #混剪",
"photo_id": 5251478817858568000,
"forward_count": 0,
"view_count": 1061421,
"share_count": 6791,
"photo_status": 0,
"shareGuide": {
"minPlayDurationInSeconds": 15,
"textDisplayDurationInSeconds": 4,
"photoShareGuide": false,
"playTimes": 2
},
"us_d": 0,
"share_info": "userId=3xj6kcxepn3n3eg&photoId=3xg9avuebhtfcku",
"forward_stats_params": {
"et": ""
},
"enableShareToStory": true,
"soundTrack": {
"name": "苏暮尘的作品原声",
"duration": 89,
"user": {
"following": false,
"kwaiId": "Boluocut",
"user_id": 3237912521,
"user_name": "苏暮尘",
"profilePagePrefetchInfo": {
"profilePageType": 1
},
"headurl": "http://p23.a.yximgs.com/uhead/AB/2025/11/01/23/BMjAyNTExMDEyMzA2NDJfMzIzNzkxMjUyMV8yX2hkNjQxXzIwNg==_s.jpg",
"user_sex": "M",
"eid": "3xj6kcxepn3n3eg",
"visitorBeFollowed": false,
"headurls": [
{
"cdn": "p23.a.yximgs.com",
"url": "http://p23.a.yximgs.com/uhead/AB/2025/11/01/23/BMjAyNTExMDEyMzA2NDJfMzIzNzkxMjUyMV8yX2hkNjQxXzIwNg==_s.jpg"
},
{
"cdn": "p4.a.yximgs.com",
"url": "http://p4.a.yximgs.com/uhead/AB/2025/11/01/23/BMjAyNTExMDEyMzA2NDJfMzIzNzkxMjUyMV8yX2hkNjQxXzIwNg==_s.jpg"
}
]
},
"photoId": 5251478817858568000,
"audioUrls": [
{
"cdn": "hw.a.yximgs.com",
"url": "http://hw.a.yximgs.com/bs2/ost/MTc4OTEyMzY2MTYyXzMyMzc5MTI1MjE.m4a"
},
{
"cdn": "ali2.a.yximgs.com",
"url": "http://ali2.a.yximgs.com/bs2/ost/MTc4OTEyMzY2MTYyXzMyMzc5MTI1MjE.m4a"
}
],
"imageUrls": [
{
"cdn": "hw.a.yximgs.com",
"url": "http://hw.a.yximgs.com/bs2/ost/MTc4OTEyMzY2MTYyXzMyMzc5MTI1MjE.jpg"
},
{
"cdn": "ali2.a.yximgs.com",
"url": "http://ali2.a.yximgs.com/bs2/ost/MTc4OTEyMzY2MTYyXzMyMzc5MTI1MjE.jpg"
}
],
"artist": "苏暮尘",
"avatarUrls": [
{
"cdn": "hw.a.yximgs.com",
"url": "http://hw.a.yximgs.com/bs2/ost/MTc4OTEyMzY2MTYyXzMyMzc5MTI1MjE.jpg"
},
{
"cdn": "ali2.a.yximgs.com",
"url": "http://ali2.a.yximgs.com/bs2/ost/MTc4OTEyMzY2MTYyXzMyMzc5MTI1MjE.jpg"
}
],
"id": "5xsbyu3yuxeme3e",
"type": 9,
"loudness": -15,
"finalStatus": 0,
"genreId": 0,
"audioType": 1,
"disableEnhancedEntry": true,
"isOffline": false,
"hasCopyright": true
},
"recoTags": [],
"tags": [],
"tag_hash_type": 1,
"sameFrame": {
"allow": true,
"availableDepth": 7
},
"adminTags": [],
"photoTextLocationInfo": {
"leftRatio": 0.00694,
"topRatio": 0.01574,
"widthRatio": 0.63333,
"heightRatio": 0.89166
},
"user_id": 3237912521,
"ext_params": {
"mtype": 3,
"color": "653D20",
"w": 960,
"sound": 89119,
"h": 720,
"interval": 60,
"video": 89116
},
"serverExpTag": "",
"profilePagePrefetchInfo": {
"profilePageType": 1
},
"exp_tag": "",
"followShoot": {
"isLipsSyncPhoto": false
},
"feedLogCtx": {
"stidContainer": "CjgxfDIwMDk0MzM4MzczNDQ5MTU1Mzd8cGhvdG86NTI1MTQ3ODgxNzg1ODU2ODM4Mnx8eyJyIjowfQ==",
"stExParams": "",
"logParams": "{}"
}
}
],
"host-name": "public-bjy-c26-kce-node695.idchb1az2.hb1.kwaidc.com"
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。