Videos Kwai relates to one video. This is a separate upstream lookup and therefore a separate request.
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.
string
Required
Kwai video id.
1234567890
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
videos
success
photo_id
video_count
requested_count
Common videos fields
caption
video_id
{
"meta": {
"attempts": 1,
"billable": true,
"duration_ms": 990
},
"videos": [
{
"caption": "More like this",
"video_id": "3xk9qz2fghij"
}
],
"success": true,
"photo_id": "3xk9qz2abcde",
"video_count": 1,
"requested_count": 3
}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.