Skip to content

优酷视频详情 API (V1) ​

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

获取由视频 ID 标识的优酷视频详情。使用该接口查找已知视频进行内容审核、编目或后续视频分析。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-TOKEN
videoIdquerystring是-视频的唯一标识符。

代码示例 ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=VALUE'
text
我想使用 JustOneAPI 提供的“视频详情 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=VALUE
接口地址: BASE_URL + /api/youku/get-video-detail/v1?token=YOUR_API_KEY&videoId=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/youku/video-details-v1-zh.json

请求参数说明:
- token (query): TOKEN (必填)
- videoId (query): 视频的唯一标识符。 (必填)

返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。

响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
   - 0: 成功
   - 100: Token 无效或已失效
   - 301: 采集失败,请重试
   - 302: 超出速率限制
   - 303: 超出每日配额
   - 400: 参数错误
   - 500: 内部服务器错误
   - 600: 权限不足
   - 601: 账户余额不足
   - 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。

请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。
python
import requests

BASE_URL = "https://api.justoneapi.com"  # 由 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"; // 由 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"; // 由 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" // 由 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'; // 由 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;
}

返回字段 ​

业务成功时(code = 0)的主要返回字段。

视频基本信息12 个字段

data

优酷视频详情及页面随附的结构化卡片。

字段类型说明
videoMapobject请求视频的公开元数据。
videoMap.videoIdstring平台返回的该视频 ID。
videoMap.vIdstringvId 字段返回的视频 ID,核对结果与 videoId 一致。
videoMap.videoLongIdinteger平台返回的该视频数字 ID。
videoMap.videoTitlestring请求视频的标题。
videoMap.pageTitlestring视频详情页展示标题。
videoMap.videoPublishTimestring以精确到秒的文本返回的视频发布时间。
videoMap.durationnumber以秒为单位的视频时长,可能包含小数。
videoMap.videoCategorystring优酷返回的视频类别名称。
videoMap.videoCategoryIdinteger平台返回的视频类别码。
videoMap.videoImgstring视频详情随附的图片链接。
videoMap.videoImgVstring视频详情随附的竖版图片链接。
视频状态和互动数据8 个字段

data.videoMap

字段类型说明
isVideoboolean平台是否标记该条目为视频。
isShortboolean平台是否将该视频标记为短视频。
paidinteger优酷返回的付费内容标记整数值。
totalCommentinteger返回的视频评论数。
totalUpinteger返回的视频点赞数。
showVideoStageDescstring该视频随附的期数或剧集展示文字。
streamTypesarray视频元数据随附的流格式码列表。
streamTypes[]string优酷列出的一项流格式码。
页面区块6 个字段

data.componentList[]

可能包含视频和发布者卡片的页面区块列表。

字段类型说明
componentNamestring详情页返回的页面区块名称。
titlestring页面区块的展示标题。
typeinteger平台返回的页面区块类型码。
dataNodearray该页面区块随附的内容节点。
dataNode[].idinteger | null该内容节点的数字标识,可能为 null。
dataNode[].typeinteger平台返回的内容节点类型码。
卡片内容13 个字段

data.componentList[].dataNode[].data

内容节点的展示数据。可用字段随卡片而变化。

字段类型说明
titlestring视频或页面卡片上的标题文字。
introTitlestring简介区块的展示标题。
summarystring该卡片随附的简介文字。
descstring该卡片随附的描述文字,可能缺省。
videoIdstring该卡片关联的视频 ID。
videoLongIdinteger该卡片关联的视频数字 ID。
publishTimestring卡片上展示的发布时间文字。
secondsstring卡片上以时钟格式展示的时长字符串。
imgstring该卡片随附的展示图片链接。
thumbUrlstring该结果随附的缩略图链接。
bgPicstring该卡片随附的背景图链接。
heatDescstring该卡片随附的热度展示文字。
ownerUidstring该卡片随附的所有者用户 ID。
发布者6 个字段

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

卡片随附的公开发布者资料。

字段类型说明
idstring平台返回的发布者用户 ID。
namestring发布者的展示名称。
iconstring发布者的头像图片链接。
subtitlestring发布者名称随附的补充展示文字。
verifyNamestring | null发布者随附的认证展示名称,可能为 null。
verifyIconstring | null发布者的认证图标链接,可能为 null。
卡片标签和互动13 个字段

data.componentList[].dataNode[].data

字段类型说明
interactsarray该卡片随附的互动展示信息。
interacts[].interactTypestring该互动展示项的类型码。
interacts[].titlestring该互动项的展示标签。
interacts[].countinteger | null该互动项返回的计数,可能为 null。
lbTextsarray该卡片随附的文字标签。
lbTexts[].titlestring展示标签的主要文字。
lbTexts[].contentDescstring该标签随附的说明文字。
lbTexts[].textColorstring该标签随附的文字颜色值。
reasonsobject卡片随附的推荐展示信息。
reasons.textstring | null返回的推荐理由文字,可能为 null。
subtitlesarray该卡片随附的次要展示行。
subtitles[].subtitlestring该次要展示行的文字。
subtitles[].subtitleTypestring平台返回的该次要展示行类型码。

响应示例 ​

正在加载响应示例…