快手 API - 用户发布视频 (V2)

prod-global

GET

/api/kuaishou/get-user-video-list/v2

获取指定快手用户发布的视频列表，包含视频ID、封面图片、发布时间及互动数据指标。

典型应用场景：

针对特定创作者的视频内容分析
监控视频表现与互动趋势

请求参数

参数名	位置	类型	必填	说明
`token`	query	`string`	是	此 API 服务的访问令牌。
`userId`	query	`string`	是	快手平台上的唯一用户ID。
`pcursor`	query	`string`	否	用于后续页面的分页游标。

代码示例

💡 环境说明

默认示例使用 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-user-video-list/v2?token=YOUR_API_KEY&userId=VALUE"

text

我想使用 Just One API 提供的“用户发布视频 (V2)”接口。
接口地址: https://api.justoneapi.com/api/kuaishou/get-user-video-list/v2
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/kuaishou-apis/user-published-videos-v2-zh.json

请求参数说明:
- token (query): 此 API 服务的访问令牌。 (必填)
- userId (query): 快手平台上的唯一用户ID。 (必填)
- pcursor (query): 用于后续页面的分页游标。

返回格式: 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-user-video-list/v2?token=YOUR_API_KEY&userId=VALUE"
response = requests.get(url)
print(response.json())

// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/kuaishou/get-user-video-list/v2?token=YOUR_API_KEY&userId=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-user-video-list/v2?token=YOUR_API_KEY&userId=VALUE"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

// 提示: 中国大陆地区建议将 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-user-video-list/v2?token=YOUR_API_KEY&userId=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-user-video-list/v2?token=YOUR_API_KEY&userId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI 定义 (JSON)]

响应结果

json

{
  "code": 0,
  "data": {
    "result": 1,
    "feeds": [
      {
        "editInfo": {},
        "commentInfo": {
          "permissions": 191,
          "enableAIPresetGuide": false,
          "commentCountSpecialEffect": true,
          "commentIconType": 0
        },
        "supportType": 0,
        "fastCommentType": 1,
        "videoColdStartType": 0,
        "savePlayProgressStrategy": 0,
        "enableFullScreenPlay": false,
        "feedSwitches": {
          "disableCommentLikeAnimation": false,
          "disable61ActivityAnimation": true,
          "enablePlayerPanel": false,
          "enablePictureCommentForPhoto": true
        },
        "ptp": "",
        "sourcePhotoPage": "bsp",
        "collect_count": 42,
        "hasVote": false,
        "type": 1,
        "duration": 21033,
        "plcFeatureEntryAbFlag": 0,
        "noNeedToRequestPLCApi": true,
        "plcResponseTime": 0,
        "plcHighPriorityThanBottomEntry": false,
        "liked": 0,
        "streamManifest": {
          "version": "1.0.0",
          "businessType": 2,
          "mediaType": 2,
          "videoId": "9de92fb446cc8286",
          "hideAuto": false,
          "manualDefaultSelect": false,
          "adaptationSet": [
            {
              "id": 1,
              "duration": 21036,
              "representation": [
                {
                  "id": 1,
                  "url": "http://k0u77y0y61y19zw240exabxb202x9xx19z.djvod.ndcimgs.com/ksc1/DUCfguhx8LQITJ6H79duzWtGneXTvxdzSnF...",
                  "backupUrl": [
                    "http://tymov2.a.kwimgs.com/bs2/photo-video-mz/5210102003663556657_9de92fb446cc8286_3104_sl200hd15.mp..."
                  ],
                  "maxBitrate": 3800,
                  "avgBitrate": 1339,
                  "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=9de92fb446cc8286/tt=sl200hd15",
                  "hdrType": 0,
                  "bitratePattern": [
                    1751
                  ],
                  "agc": false,
                  "mute": false,
                  "oriLoudness": 0,
                  "makeupGain": 0,
                  "realLoudness": 0,
                  "realNormalizeGain": 0,
                  "normalizeGain": 0
                }
              ]
            }
          ]
        },
        "main_mv_urls": [
          {
            "cdn": "tymov2.a.kwimgs.com",
            "url": "http://tymov2.a.kwimgs.com/upic/2026/01/22/16/BMjAyNjAxMjIxNjQ3MzlfMTA1MjI5NDM2OF8xODU2NjY5ODYwNzhfM..."
          }
        ],
        "cover_thumbnail_urls": [
          {
            "cdn": "ty2.a.kwimgs.com",
            "url": "http://ty2.a.kwimgs.com/upic/2026/01/22/16/BMjAyNjAxMjIxNjQ3MzlfMTA1MjI5NDM2OF8xODU2NjY5ODYwNzhfMV8z..."
          }
        ],
        "ff_cover_thumbnail_urls": [
          {
            "cdn": "ty2.a.kwimgs.com",
            "url": "http://ty2.a.kwimgs.com/upic/2026/01/22/16/BMjAyNjAxMjIxNjQ3MzlfMTA1MjI5NDM2OF8xODU2NjY5ODYwNzhfMV8z..."
          }
        ],
        "us_c": 0,
        "comment_count": 119,
        "slideCommentEntryDisabled": false,
        "frameStyle": 0,
        "verified": false,
        "following": 0,
        "user_name": "叫我壁画师明月",
        "user_sex": "U",
        "headurls": [
          {
            "cdn": "p4.a.yximgs.com",
            "url": "http://p4.a.yximgs.com/uhead/AB/2023/11/14/21/BMjAyMzExMTQyMTI1MzJfMTA1MjI5NDM2OF8xX2hkMTE5XzUyNA==_..."
          }
        ],
        "us_l": true,
        "location": {},
        "timestamp": 1769071673419,
        "time": "2026-01-22 16:47:53",
        "photo_id": 5210102003663557000,
        "forward_count": 0,
        "view_count": 44808,
        "share_count": 16,
        "photo_status": 0,
        "caption": "做浮雕选鲁班\n #浮雕壁画 #长城浮雕壁画 #背景墙 #装修",
        "like_count": 1234,
        "shareGuide": {
          "playTimes": 2,
          "minPlayDurationInSeconds": 15,
          "textDisplayDurationInSeconds": 4,
          "photoShareGuide": false
        },
        "us_d": 0,
        "share_info": "userId=3xx36yxj37hpz5s&photoId=3xtrjmkyeegzueu",
        "forward_stats_params": {
          "et": "1_i/2005609473472397970_bsp0"
        },
        "enableShareToStory": true,
        "recoTags": [],
        "soundTrack": {
          "name": "叫我壁画师明月的作品原声",
          "duration": 21,
          "user": {
            "following": false,
            "user_id": 1052294368,
            "user_name": "叫我壁画师明月",
            "eid": "3xx36yxj37hpz5s",
            "headurl": "http://p4.a.yximgs.com/uhead/AB/2023/11/14/21/BMjAyMzExMTQyMTI1MzJfMTA1MjI5NDM2OF8xX2hkMTE5XzUyNA==_...",
            "user_sex": "U",
            "profilePagePrefetchInfo": {
              "profilePageType": 1
            },
            "headurls": [
              {
                "cdn": "p4.a.yximgs.com",
                "url": "http://p4.a.yximgs.com/uhead/AB/2023/11/14/21/BMjAyMzExMTQyMTI1MzJfMTA1MjI5NDM2OF8xX2hkMTE5XzUyNA==_..."
              }
            ],
            "visitorBeFollowed": false
          },
          "photoId": 5210102003663557000,
          "audioUrls": [
            {
              "cdn": "hw.a.yximgs.com",
              "url": "http://hw.a.yximgs.com/bs2/ost/MTg1NjY2OTg2MDc4XzEwNTIyOTQzNjg.m4a"
            }
          ],
          "imageUrls": [
            {
              "cdn": "hw.a.yximgs.com",
              "url": "http://hw.a.yximgs.com/bs2/ost/MTg1NjY2OTg2MDc4XzEwNTIyOTQzNjg.jpg"
            }
          ],
          "avatarUrls": [
            {
              "cdn": "hw.a.yximgs.com",
              "url": "http://hw.a.yximgs.com/bs2/ost/MTg1NjY2OTg2MDc4XzEwNTIyOTQzNjg.jpg"
            }
          ],
          "artist": "叫我壁画师明月",
          "id": "5xjmv8raqy2x98w",
          "type": 9,
          "loudness": -15,
          "finalStatus": 0,
          "genreId": 0,
          "audioType": 1,
          "isOffline": false,
          "disableEnhancedEntry": true,
          "hasCopyright": true
        },
        "tags": [],
        "tag_hash_type": 1,
        "sameFrame": {
          "allow": true,
          "availableDepth": 7
        },
        "adminTags": [],
        "photoTextLocationInfo": {
          "leftRatio": 0.18472,
          "topRatio": 0.82812,
          "widthRatio": 0.625,
          "heightRatio": 0.03671
        },
        "user_id": 1052294368,
        "ext_params": {
          "mtype": 3,
          "color": "7A6D5E",
          "w": 720,
          "sound": 21036,
          "h": 1280,
          "interval": 30,
          "video": 21033
        },
        "followShoot": {
          "isLipsSyncPhoto": false
        },
        "exp_tag": "1_i/2005609473472397970_bsp0",
        "serverExpTag": "feed_photo|5210102003663556657|1052294368|1_i/2005609473472397970_bsp0",
        "reco_reason": "bsp0",
        "profilePagePrefetchInfo": {
          "profilePageType": 1
        },
        "feedLogCtx": {
          "stidContainer": "CkQxfDIwMDU2MDk0NzM0NzIzOTc5NzB8cGhvdG86NTIxMDEwMjAwMzY2MzU1NjY1N3x7InBnIjoiYnNwIn18eyJyIjowfQ==",
          "stExParams": "",
          "logParams": "{}"
        }
      }
    ],
    "pcursor": "1.762593109225E12",
    "llsid": 2005609473472398000,
    "host-name": "public-bjy-c34-kce-node590.idchb1az2.hb1.kwaidc.com"
  }
}

💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。

快手 API - 用户发布视频 (V2) ​

请求参数 ​

代码示例 ​

响应结果 ​

快手 API - 用户发布视频 (V2)

请求参数

代码示例

响应结果