Kuaishou Video Search API (V2)
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Search public Kuaishou videos by keyword with page-number pagination. Use it to discover relevant videos and browse results by page.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
token | query | string | Yes | - | Access token for this API service. |
keyword | query | string | Yes | - | The search keyword to find videos. |
page | query | integer | No | 1 | Page number for results, starting from 1. |
Code Samples
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE'text
I want to use the "Video Search (V2)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE
API Endpoint: BASE_URL + /api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/kuaishou/video-search-v2-en.json
Parameters:
- token (query): Access token for this API service. (Required)
- keyword (query): The search keyword to find videos. (Required)
- page (query): Page number for results, starting from 1.
Return format: safely handle JSON or text according to the actual Content-Type.
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 the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
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
- 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.
Please help me write a script in my preferred programming language to call this API and handle the response.python
import requests
BASE_URL = "https://api.justoneapi.com" # Provided by OpenAPI servers
url = BASE_URL + "/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")js
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
final String url = BASE_URL + "/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}go
package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/kuaishou/search-video/v2?token=YOUR_API_KEY&keyword=VALUE';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}Response Fields
Key fields in a successful response (code = 0).
Work details15 fields
data.feeds[]
One Kuaishou work returned by search.
| Field | Type | Description |
|---|---|---|
photo_id | integer | Kuaishou work identifier returned as a JSON integer. Use lossless JSON parsing to keep the full ID. |
caption | string | Caption displayed for the work. |
time | string | Publication time as display text. |
timestamp | integer | Publication time of the work as a Unix timestamp in milliseconds. |
type | integer | Numeric content type reported for the search result. |
photo_status | integer | Numeric status code for the Kuaishou work. |
longVideo | boolean | Whether the work is marked as a long video, when returned. |
editInfo | object | Edit information for the work, when available. |
editInfo.editVersion | integer | Reported edit version of the work. |
editInfo.editTime | integer | Edit time as a Unix timestamp in milliseconds. |
editInfo.coverVersion | integer | Reported edit version of the work cover. |
disclaimerMessage | string | Disclosure message attached to the work, when returned. |
hasVote | boolean | Whether the work is marked as containing a poll. |
hasMusicTag | boolean | Whether the work is marked with a music label. |
tags | array | Tag list reported for the work. |
Pagination and results2 fields
data
Page of public Kuaishou works for the requested keyword.
| Field | Type | Description |
|---|---|---|
result | integer | Platform result code. Successful search payloads returned 1. |
feeds | array | Works returned for the requested page. The same work can appear on more than one page. Use photo_id to match works across pages. |
Author8 fields
data.feeds[]
| Field | Type | Description |
|---|---|---|
user_id | integer | Numeric Kuaishou author identifier. |
user_name | string | Display name of the author. |
kwaiId | string | Public Kuaishou ID displayed for the author, when provided. |
verified | boolean | Whether the author is marked as verified. |
headurl | string | Avatar image URL of the author. |
headurls | array | Available avatar image links for the author. |
headurls[] | object | One available link for the asset. |
headurls[].url | string | URL of the asset variant. |
Engagement5 fields
data.feeds[]
| Field | Type | Description |
|---|---|---|
like_count | integer | Reported number of likes on the work. |
comment_count | integer | Reported number of comments on the work. |
view_count | integer | Reported number of views of the work. |
forward_count | integer | Reported number of forwards of the work. |
share_count | integer | Reported number of shares of the work. |
Media links and gallery24 fields
data.feeds[]
| Field | Type | Description |
|---|---|---|
duration | integer | Duration reported for the video. It can be absent for image works. |
main_url | string | Main image URL for the work. |
thumbnail_url | string | Thumbnail image URL for the work. |
main_mv_url | string | Main video URL returned for the work. |
main_mv_urls | array | Available URLs for the main video. |
main_mv_urls[] | object | One available link for the asset. |
main_mv_urls[].url | string | URL of the asset variant. |
thumbnail_urls | array | Available thumbnail image URLs for the work. |
thumbnail_urls[] | object | One available link for the asset. |
thumbnail_urls[].url | string | URL of the asset variant. |
cover_thumbnail_urls | array | Available cover thumbnail image URLs for the work. |
cover_thumbnail_urls[] | object | One available link for the asset. |
cover_thumbnail_urls[].url | string | URL of the asset variant. |
ext_params | object | Dimensions and optional gallery information for the work. |
ext_params.mtype | integer | Reported numeric media type of the work. |
ext_params.w | integer | Reported media width in pixels. |
ext_params.h | integer | Reported media height in pixels. |
ext_params.atlas | object | Gallery information for a multi-image work. |
ext_params.atlas.list | array | Image references for the gallery in display order. Verified entries are path strings. |
ext_params.atlas.list[] | string | Reference path of one gallery image. |
ext_params.atlas.size | array | Dimensions for the gallery images. Verified rows align with list by position. |
ext_params.atlas.size[] | object | Dimensions of one gallery image. |
ext_params.atlas.size[].w | integer | Image width in pixels. |
ext_params.atlas.size[].h | integer | Image height in pixels. |
Playback manifest22 fields
data.feeds[]
| Field | Type | Description |
|---|---|---|
streamManifest | object | Playback manifest returned for video media. |
streamManifest.version | string | Version of the playback manifest. |
streamManifest.videoId | string | Video identifier carried by the playback manifest. |
streamManifest.adaptationSet | array | Groups of playback renditions in the manifest. |
streamManifest.adaptationSet[] | object | One group of playback renditions. |
streamManifest.adaptationSet[].id | integer | Numeric identifier of this playback group. |
streamManifest.adaptationSet[].duration | integer | Duration reported for this playback group. |
streamManifest.adaptationSet[].representation | array | Playback renditions available in this group. |
streamManifest.adaptationSet[].representation[] | object | One available playback rendition. |
streamManifest.adaptationSet[].representation[].id | integer | Numeric identifier of this playback rendition. |
streamManifest.adaptationSet[].representation[].url | string | Playback URL for this rendition. |
streamManifest.adaptationSet[].representation[].backupUrl | array | Alternate playback URLs for this rendition. |
streamManifest.adaptationSet[].representation[].backupUrl[] | string | One alternate playback URL. |
streamManifest.adaptationSet[].representation[].maxBitrate | integer | Maximum bitrate reported for the rendition. |
streamManifest.adaptationSet[].representation[].avgBitrate | integer | Average bitrate reported for the rendition. |
streamManifest.adaptationSet[].representation[].width | integer | Playback frame width in pixels. |
streamManifest.adaptationSet[].representation[].height | integer | Playback frame height in pixels. |
streamManifest.adaptationSet[].representation[].frameRate | number | Frame rate reported for the playback rendition. |
streamManifest.adaptationSet[].representation[].quality | number | Numeric quality level reported for the rendition. |
streamManifest.adaptationSet[].representation[].qualityType | string | Quality type label of this playback rendition. |
streamManifest.adaptationSet[].representation[].qualityLabel | string | Display label of the rendition quality. |
streamManifest.adaptationSet[].representation[].defaultSelect | boolean | Whether the rendition is marked for default selection. |
Display dimensions and place17 fields
data.feeds[]
| Field | Type | Description |
|---|---|---|
photoDisplayLocationInfo | object | Display area and image dimensions reported for the work. |
photoDisplayLocationInfo.leftRatio | number | Relative left position of the display area. |
photoDisplayLocationInfo.topRatio | number | Relative top position of the display area. |
photoDisplayLocationInfo.widthRatio | number | Relative width of the display area. |
photoDisplayLocationInfo.heightRatio | number | Relative height of the display area. |
photoDisplayLocationInfo.displayWidth | integer | Width of the display area in pixels. |
photoDisplayLocationInfo.displayHeight | integer | Height of the display area in pixels. |
photoDisplayLocationInfo.photoWidth | integer | Width of the work image in pixels. |
photoDisplayLocationInfo.photoHeight | integer | Height of the work image in pixels. |
poi | object | Point of interest attached to the work, when provided. |
poi.id | integer | Numeric identifier of the attached place. |
poi.title | string | Name displayed for the attached place. |
poi.city | string | City label for the attached place. |
poi.address | string | Address label of the attached place. |
poi.latitude | number | Latitude reported for the attached place. |
poi.longitude | number | Longitude reported for the attached place. |
poi.category | integer | Numeric category code reported for the attached place. |
Response Example
Loading the response example...