Skip to content

Kuaishou Video Search API (V2) ​

GET
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 ​

NameInTypeRequiredDefaultDescription
tokenquerystringYes-Access token for this API service.
keywordquerystringYes-The search keyword to find videos.
pagequeryintegerNo1Page 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.

FieldTypeDescription
photo_idintegerKuaishou work identifier returned as a JSON integer. Use lossless JSON parsing to keep the full ID.
captionstringCaption displayed for the work.
timestringPublication time as display text.
timestampintegerPublication time of the work as a Unix timestamp in milliseconds.
typeintegerNumeric content type reported for the search result.
photo_statusintegerNumeric status code for the Kuaishou work.
longVideobooleanWhether the work is marked as a long video, when returned.
editInfoobjectEdit information for the work, when available.
editInfo.editVersionintegerReported edit version of the work.
editInfo.editTimeintegerEdit time as a Unix timestamp in milliseconds.
editInfo.coverVersionintegerReported edit version of the work cover.
disclaimerMessagestringDisclosure message attached to the work, when returned.
hasVotebooleanWhether the work is marked as containing a poll.
hasMusicTagbooleanWhether the work is marked with a music label.
tagsarrayTag list reported for the work.
Pagination and results2 fields

data

Page of public Kuaishou works for the requested keyword.

FieldTypeDescription
resultintegerPlatform result code. Successful search payloads returned 1.
feedsarrayWorks 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[]

FieldTypeDescription
user_idintegerNumeric Kuaishou author identifier.
user_namestringDisplay name of the author.
kwaiIdstringPublic Kuaishou ID displayed for the author, when provided.
verifiedbooleanWhether the author is marked as verified.
headurlstringAvatar image URL of the author.
headurlsarrayAvailable avatar image links for the author.
headurls[]objectOne available link for the asset.
headurls[].urlstringURL of the asset variant.
Engagement5 fields

data.feeds[]

FieldTypeDescription
like_countintegerReported number of likes on the work.
comment_countintegerReported number of comments on the work.
view_countintegerReported number of views of the work.
forward_countintegerReported number of forwards of the work.
share_countintegerReported number of shares of the work.
Media links and gallery24 fields

data.feeds[]

FieldTypeDescription
durationintegerDuration reported for the video. It can be absent for image works.
main_urlstringMain image URL for the work.
thumbnail_urlstringThumbnail image URL for the work.
main_mv_urlstringMain video URL returned for the work.
main_mv_urlsarrayAvailable URLs for the main video.
main_mv_urls[]objectOne available link for the asset.
main_mv_urls[].urlstringURL of the asset variant.
thumbnail_urlsarrayAvailable thumbnail image URLs for the work.
thumbnail_urls[]objectOne available link for the asset.
thumbnail_urls[].urlstringURL of the asset variant.
cover_thumbnail_urlsarrayAvailable cover thumbnail image URLs for the work.
cover_thumbnail_urls[]objectOne available link for the asset.
cover_thumbnail_urls[].urlstringURL of the asset variant.
ext_paramsobjectDimensions and optional gallery information for the work.
ext_params.mtypeintegerReported numeric media type of the work.
ext_params.wintegerReported media width in pixels.
ext_params.hintegerReported media height in pixels.
ext_params.atlasobjectGallery information for a multi-image work.
ext_params.atlas.listarrayImage references for the gallery in display order. Verified entries are path strings.
ext_params.atlas.list[]stringReference path of one gallery image.
ext_params.atlas.sizearrayDimensions for the gallery images. Verified rows align with list by position.
ext_params.atlas.size[]objectDimensions of one gallery image.
ext_params.atlas.size[].wintegerImage width in pixels.
ext_params.atlas.size[].hintegerImage height in pixels.
Playback manifest22 fields

data.feeds[]

FieldTypeDescription
streamManifestobjectPlayback manifest returned for video media.
streamManifest.versionstringVersion of the playback manifest.
streamManifest.videoIdstringVideo identifier carried by the playback manifest.
streamManifest.adaptationSetarrayGroups of playback renditions in the manifest.
streamManifest.adaptationSet[]objectOne group of playback renditions.
streamManifest.adaptationSet[].idintegerNumeric identifier of this playback group.
streamManifest.adaptationSet[].durationintegerDuration reported for this playback group.
streamManifest.adaptationSet[].representationarrayPlayback renditions available in this group.
streamManifest.adaptationSet[].representation[]objectOne available playback rendition.
streamManifest.adaptationSet[].representation[].idintegerNumeric identifier of this playback rendition.
streamManifest.adaptationSet[].representation[].urlstringPlayback URL for this rendition.
streamManifest.adaptationSet[].representation[].backupUrlarrayAlternate playback URLs for this rendition.
streamManifest.adaptationSet[].representation[].backupUrl[]stringOne alternate playback URL.
streamManifest.adaptationSet[].representation[].maxBitrateintegerMaximum bitrate reported for the rendition.
streamManifest.adaptationSet[].representation[].avgBitrateintegerAverage bitrate reported for the rendition.
streamManifest.adaptationSet[].representation[].widthintegerPlayback frame width in pixels.
streamManifest.adaptationSet[].representation[].heightintegerPlayback frame height in pixels.
streamManifest.adaptationSet[].representation[].frameRatenumberFrame rate reported for the playback rendition.
streamManifest.adaptationSet[].representation[].qualitynumberNumeric quality level reported for the rendition.
streamManifest.adaptationSet[].representation[].qualityTypestringQuality type label of this playback rendition.
streamManifest.adaptationSet[].representation[].qualityLabelstringDisplay label of the rendition quality.
streamManifest.adaptationSet[].representation[].defaultSelectbooleanWhether the rendition is marked for default selection.
Display dimensions and place17 fields

data.feeds[]

FieldTypeDescription
photoDisplayLocationInfoobjectDisplay area and image dimensions reported for the work.
photoDisplayLocationInfo.leftRationumberRelative left position of the display area.
photoDisplayLocationInfo.topRationumberRelative top position of the display area.
photoDisplayLocationInfo.widthRationumberRelative width of the display area.
photoDisplayLocationInfo.heightRationumberRelative height of the display area.
photoDisplayLocationInfo.displayWidthintegerWidth of the display area in pixels.
photoDisplayLocationInfo.displayHeightintegerHeight of the display area in pixels.
photoDisplayLocationInfo.photoWidthintegerWidth of the work image in pixels.
photoDisplayLocationInfo.photoHeightintegerHeight of the work image in pixels.
poiobjectPoint of interest attached to the work, when provided.
poi.idintegerNumeric identifier of the attached place.
poi.titlestringName displayed for the attached place.
poi.citystringCity label for the attached place.
poi.addressstringAddress label of the attached place.
poi.latitudenumberLatitude reported for the attached place.
poi.longitudenumberLongitude reported for the attached place.
poi.categoryintegerNumeric category code reported for the attached place.

Response Example ​

Loading the response example...