Skip to content

YOUKU Video Details API (V1) ​

GET
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...

Retrieves details for a Youku video identified by video ID. Use it to look up a known video for content review, cataloging, or subsequent video analysis.

Parameters ​

NameInTypeRequiredDefaultDescription
tokenquerystringYes-TOKEN
videoIdquerystringYes-The unique identifier for the video.

Code Samples ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=VALUE'
text
I want to use the "Video Details (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=VALUE
API Endpoint: BASE_URL + /api/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/youku/video-details-v1-en.json

Parameters:
- token (query): TOKEN (Required)
- videoId (query): The unique identifier for the video. (Required)

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/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=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/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=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/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=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/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=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/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=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).

Video details12 fields

data

Youku video details and structured cards returned with the detail page.

FieldTypeDescription
videoMapobjectPublic metadata for the requested video.
videoMap.videoIdstringVideo identifier returned for the requested video.
videoMap.vIdstringVideo identifier returned in the vId field. Checked results match videoId.
videoMap.videoLongIdintegerNumeric identifier returned for the requested video.
videoMap.videoTitlestringTitle of the requested video.
videoMap.pageTitlestringTitle displayed on the video detail page.
videoMap.videoPublishTimestringVideo publication time returned as text with second precision.
videoMap.durationnumberVideo duration in seconds. The value can have a fractional part.
videoMap.videoCategorystringVideo category name returned by Youku.
videoMap.videoCategoryIdintegerNumeric category code returned for the video.
videoMap.videoImgstringImage URL returned with the video details.
videoMap.videoImgVstringVertical image URL returned with the video details.
Video status and engagement8 fields

data.videoMap

FieldTypeDescription
isVideobooleanWhether the platform marks the item as a video.
isShortbooleanWhether the platform marks the video as short-form.
paidintegerPaid-content indicator reported by Youku.
totalCommentintegerReported comment count for the video.
totalUpintegerReported like count for the video.
showVideoStageDescstringStage or episode display label returned for the video.
streamTypesarrayStream format codes listed in the video metadata.
streamTypes[]stringOne stream format code listed by Youku.
Page components6 fields

data.componentList[]

Page components that can include video and uploader cards.

FieldTypeDescription
componentNamestringComponent name reported by the detail page.
titlestringDisplay title for the page component.
typeintegerPlatform type code for the page component.
dataNodearrayContent nodes returned with this component.
dataNode[].idinteger | nullNumeric identifier returned for this content node. It can be null.
dataNode[].typeintegerPlatform type code for the content node.
Card details13 fields

data.componentList[].dataNode[].data

Display data on this content node. Available fields vary by card.

FieldTypeDescription
titlestringTitle text shown on this video or page card.
introTitlestringDisplay heading returned for the introduction.
summarystringSummary text returned with this card.
descstringDescription text returned for this card when available.
videoIdstringVideo identifier associated with this related card.
videoLongIdintegerNumeric video identifier associated with this related card.
publishTimestringPublication-time label shown on the card.
secondsstringDuration displayed on the card as a clock-formatted string.
imgstringImage URL displayed with the card.
thumbUrlstringThumbnail URL returned for the result.
bgPicstringBackground image URL returned for this card.
heatDescstringPopularity label text returned for the card.
ownerUidstringOwner user identifier returned on this card.
Card uploader6 fields

data.componentList[].dataNode[].data.upUser

Public uploader information attached to the card.

FieldTypeDescription
idstringUser identifier returned for the uploader.
namestringDisplay name returned for the uploader.
iconstringAvatar image URL returned for the uploader.
subtitlestringAdditional text shown with the uploader name.
verifyNamestring | nullVerification display name returned for the uploader when available.
verifyIconstring | nullVerification icon URL returned for the uploader when available.
Card labels and engagement13 fields

data.componentList[].dataNode[].data

FieldTypeDescription
interactsarrayEngagement displays reported with the card.
interacts[].interactTypestringType code for this engagement display.
interacts[].titlestringDisplay label for this engagement item.
interacts[].countinteger | nullReported count for this engagement item. It can be null.
lbTextsarrayText badges displayed on this card.
lbTexts[].titlestringPrimary text of the displayed badge.
lbTexts[].contentDescstringDescription text returned for the badge.
lbTexts[].textColorstringText color value returned for the badge.
reasonsobjectRecommendation display information accompanying the card.
reasons.textstring | nullReported recommendation reason text. It can be null.
subtitlesarraySecondary display lines returned for the card.
subtitles[].subtitlestringText shown on this secondary display line.
subtitles[].subtitleTypestringType code returned for the secondary display line.

Response Example ​

Loading the response example...