Cursor-paginated video feed of a Kwai account, including the album shelf. Feed the next_cursor back as pcursor for the following page.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
Kwai handle, with or without a leading @.
example
string
Optional
Cursor from the previous response (next_cursor).
example
integer
Optional
Requested number of videos, 1 to 50. Default: 12.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
user
albums
videos
success
has_more
album_count
next_cursor
+2 more
Common videos fields
caption
coverUrl
duration
video_id
{
"meta": {
"attempts": 1,
"billable": true,
"duration_ms": 1180
},
"user": "praiabeach",
"albums": [],
"videos": [
{
"caption": "Sunset on the coast",
"coverUrl": "https://cdn.example.com/cover.jpg",
"duration": 15000,
"video_id": "3xk9qz2abcde",
"likeCount": 9421,
"viewCount": 182340,
"main_mv_urls": [
{
"url": "https://cdn.example.com/video.mp4"
}
],
"photo_id_str": "3xk9qz2abcde"
}
],
"success": true,
"has_more": true,
"album_count": 0,
"next_cursor": "3xk9qz2abcde:12",
"video_count": 2,
"requested_count": 12
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Upstream Unavailable
The upstream service is temporarily unavailable. Please retry shortly.
{
"meta": {
"attempts": 2,
"billable": false,
"retryable": true,
"duration_ms": 2140
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Kwai API is temporarily unavailable. Please retry.",
"http_status": 502,
"failure_type": "upstream_non_200"
},
"success": false
}Not Found
Kwai has no public data for this identifier. A not-found is a completed lookup that was not billed.
{
"meta": {
"attempts": 2,
"billable": false,
"retryable": false,
"duration_ms": 1980
},
"error": {
"code": "VIDEO_NOT_FOUND",
"message": "Kwai has no video with this id.",
"http_status": 404,
"failure_type": "video_id_substituted"
},
"success": false
}Profile Not Found
Kwai has no public profile for this handle. A not-found is a completed lookup that was not billed.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": false,
"duration_ms": 860
},
"error": {
"code": "PROFILE_NOT_FOUND",
"message": "Kwai has no public profile for this handle.",
"http_status": 404,
"failure_type": "profile_not_found"
},
"success": false
}Upstream Rejected The Request
Kwai rejected the request body as malformed. Retrying will not change the outcome, so the request is sent once and is not billed.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": false,
"duration_ms": 1120
},
"error": {
"code": "INVALID_PARAMETER",
"message": "Kwai could not process this request. Retrying will not change the outcome.",
"http_status": 422,
"failure_type": "invalid_parameter_format"
},
"success": false
}Validation Error
A required parameter is missing or malformed.
{
"errors": {
"user": [
"The Kwai handle is required."
]
},
"message": "The request validation failed"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.