Videos published under a Kwai topic or hashtag. Spaces in the topic name are normalised to hyphens.
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
Topic slug, for example travel.
example
string
Optional
Cursor from the previous response (next_cursor).
example
integer
Optional
Requested number of videos, 1 to 50. Default: 25.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
topic
videos
success
has_more
next_cursor
video_count
Common videos fields
caption
video_id
{
"meta": {
"attempts": 1,
"billable": true,
"duration_ms": 1610
},
"topic": "travel",
"videos": [
{
"caption": "Travel diary",
"video_id": "3xk9qz2abcde"
}
],
"success": true,
"has_more": true,
"next_cursor": "travel:25",
"video_count": 1
}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.