Kuaishou APIs - User Published Videos (V2)
Retrieves a list of videos posted by a specific Kuaishou user, including video ID, cover image, publish time, and engagement metrics.
Typical use cases:
- Content analysis for specific creators
- Monitoring video performance and engagement trends
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | Access token for this API service. |
userId | query | string | Yes | The unique user ID on Kuaishou. |
pcursor | query | string | No | Pagination cursor for subsequent pages. |
Code Samples
💡 Environment Note
Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.
bash
# Tip: For Mainland China, replace https://api.justoneapi.com with 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
I want to use the "User Published Videos (V2)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/kuaishou/get-user-video-list/v2
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/kuaishou-apis/user-published-videos-v2-en.json
Parameters:
- token (query): Access token for this API service. (Required)
- userId (query): The unique user ID on Kuaishou. (Required)
- pcursor (query): Pagination cursor for subsequent pages.
Return format: JSON
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
Please help me write a script in my preferred programming language to call this API and handle the response.python
# Tip: For Mainland China, replace https://api.justoneapi.com with 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())js
// Tip: For Mainland China, replace https://api.justoneapi.com with 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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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());
}
}go
// Tip: For Mainland China, replace https://api.justoneapi.com with 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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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;Responses
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"
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.