YOUKU User Profile API (V1)
GET
API health status
24h health
24h avg latency
Last checked
Healthy Available Limited Mostly unavailable No data
Healthy
Loading health status...
24h trend
30d trend
Retrieves a Youku user profile identified by UID. Use it to look up a known account for creator research, profile review, or related video discovery.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
token | query | string | Yes | - | TOKEN |
uid | query | string | Yes | - | The unique identifier for the user. |
Code Samples
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/youku/get-user-detail/v1?token=YOUR_API_KEY&uid=VALUE'text
I want to use the "User Profile (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/youku/get-user-detail/v1?token=YOUR_API_KEY&uid=VALUE
API Endpoint: BASE_URL + /api/youku/get-user-detail/v1?token=YOUR_API_KEY&uid=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/youku/user-profile-v1-en.json
Parameters:
- token (query): TOKEN (Required)
- uid (query): The unique identifier for the user. (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-user-detail/v1?token=YOUR_API_KEY&uid=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-user-detail/v1?token=YOUR_API_KEY&uid=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-user-detail/v1?token=YOUR_API_KEY&uid=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-user-detail/v1?token=YOUR_API_KEY&uid=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-user-detail/v1?token=YOUR_API_KEY&uid=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).
Profile page and sharing10 fields
data
Youku creator profile page data and its public content cards.
| Field | Type | Description |
|---|---|---|
pageData | object | Profile page summary and public sharing information. |
pageData.nickName | string | Display name returned for the creator. |
pageData.avatar | string | Avatar image URL returned for the creator. |
pageData.pageNo | string | Page number reported in the profile data as text. |
pageData.more | boolean | Whether the profile data indicates more content. |
pageData.shareInfo | object | Public sharing information for the creator profile. |
pageData.shareInfo.title | string | Title supplied for the creator profile share card. |
pageData.shareInfo.describe | string | Description supplied for the creator profile share card. |
pageData.shareInfo.img | string | Image URL supplied for the creator profile share card. |
pageData.shareInfo.link | string | Public share link returned for the creator profile. |
Creator profile and counts17 fields
data.componentList[].dataNode[].data
| Field | Type | Description |
|---|---|---|
uid | integer | Numeric account identifier returned for the creator. |
uidEncode | string | Encoded account identifier returned for the creator as text. |
nickName | string | Display name returned for the creator. |
avatar | string | Avatar image URL returned for the creator. |
description | string | Profile description returned for the creator. |
subTitle | object | First subtitle shown with the creator profile. |
subTitle.desc | string | Text shown for this public profile subtitle. |
subTitle2 | object | Second subtitle shown with the creator profile. |
subTitle2.desc | string | Text shown for this public profile subtitle. |
zpdBackGroundPicture | string | Profile background image URL for the default display. |
zpdBackGroundDarkPicture | string | Profile background image URL for the dark display mode. |
followerNum | integer | Reported follower count for the creator. |
followerNumFormat | string | Display text for the creator follower count. |
followingNum | integer | Reported count of accounts the creator follows. |
followingNumFormat | string | Display text for the creator following count. |
likeNum | integer | Reported like count on the creator profile. |
likeNumFormat | string | Display text for the creator profile like count. |
Video cards30 fields
data.componentList[].dataNode[]
| Field | Type | Description |
|---|---|---|
vid | string | Public video identifier returned with the card. |
title | string | Title displayed for the video card. |
summary | string | Summary text displayed for the video card. |
imgUrl | string | Image URL displayed with the card. |
publishTime | string | Publication time returned as a display label on the card. |
isTop | boolean | Whether the card is marked as pinned by the platform. |
individuality | string | Additional display label returned with the card. |
bulletCount | integer | string | Bullet-comment count field as returned. The display value can be blank text. |
playCount | string | Display play-count text returned with the card. It can be blank. |
data | object | Public profile or video card contents, depending on the content node. |
data.vid | string | Public video identifier returned with the card. |
data.title | string | Title displayed for the video card. |
data.summary | string | Summary text displayed for the video card. |
data.img | string | Image URL displayed with the card. |
data.ratio | string | Aspect-ratio label returned for the video card as text. |
data.comments | object | Reported comment and bullet-comment information when provided. |
data.comments.count | integer | Reported comment count for this video. |
data.comments.title | string | Display text associated with the comment count. |
data.comments.totalBullet | integer | Reported bullet-comment count when available. |
data.comments.totalBulletTitle | string | Display text associated with the bullet-comment count. |
data.poster | object | Cover and overlay information returned for the video card. |
data.poster.headFrame | string | Preview image URL supplied for the video card. |
data.poster.lBottom | object | Lower-left display label on the video cover. |
data.poster.lBottom.title | string | Text displayed in the lower-left label, which can show video duration. |
data.preview | object | Video identifier carried by the preview data. |
data.preview.vid | string | Public video identifier returned with the card. |
data.vipMark | object | Display badge metadata returned for the video card. |
data.vipMark.verifyDesc | string | null | Description returned for this display badge when available. |
data.vipMark.verifyTypeName | string | Type name returned for this display badge. |
data.vipMark.verifyType | integer | Platform type code for the display badge. |
Video specifications and timing8 fields
data.componentList[].dataNode[].upsStream
Selected video format and timing metadata accompanying the card.
| Field | Type | Description |
|---|---|---|
encodedId | string | Public video identifier returned with the card. |
title | string | Title displayed for the video card. |
createdTime | integer | Video creation time in Unix milliseconds. |
milliSeconds | integer | Video duration in milliseconds. |
width | integer | Video frame width reported for the card. |
height | integer | Video frame height reported for the card. |
horizontal | boolean | Whether the video is reported as landscape. |
framesPerSecond | integer | Video frame rate returned as frames per second. |
Page components6 fields
data.componentList[]
Structural components returned with the creator profile page.
| Field | Type | Description |
|---|---|---|
id | integer | string | Identifier returned for this page component. |
componentName | string | Component name returned for the profile page. |
type | string | Platform component type returned as text. |
dataNode | array | Content nodes returned under this page component. |
dataNode[].id | string | Identifier reported for this content node. |
dataNode[].type | integer | null | Platform type code for the content node when provided. |
Component modules44 fields
data.componentList[].moduleList[]
Content modules returned under this page component. Their video cards can also appear in the component list.
| Field | Type | Description |
|---|---|---|
moduleTitle | string | Display title for the module when provided. |
moduleType | string | integer | Module type code or display value returned by the platform. |
dataNode | array | Video card nodes returned in this module. |
dataNode[].id | string | Identifier reported for this content node. |
dataNode[].type | integer | null | Platform type code for the content node when provided. |
dataNode[].vid | string | Public video identifier returned with the card. |
dataNode[].title | string | Title displayed for the video card. |
dataNode[].summary | string | Summary text displayed for the video card. |
dataNode[].imgUrl | string | Image URL displayed with the card. |
dataNode[].publishTime | string | Publication time returned as a display label on the card. |
dataNode[].isTop | boolean | Whether the card is marked as pinned by the platform. |
dataNode[].individuality | string | Additional display label returned with the card. |
dataNode[].bulletCount | integer | string | Bullet-comment count field as returned. The display value can be blank text. |
dataNode[].playCount | string | Display play-count text returned with the card. It can be blank. |
dataNode[].upsStream | object | Selected video format and timing metadata accompanying the card. |
dataNode[].upsStream.encodedId | string | Public video identifier returned with the card. |
dataNode[].upsStream.title | string | Title displayed for the video card. |
dataNode[].upsStream.createdTime | integer | Video creation time in Unix milliseconds. |
dataNode[].upsStream.milliSeconds | integer | Video duration in milliseconds. |
dataNode[].upsStream.width | integer | Video frame width reported for the card. |
dataNode[].upsStream.height | integer | Video frame height reported for the card. |
dataNode[].upsStream.horizontal | boolean | Whether the video is reported as landscape. |
dataNode[].upsStream.framesPerSecond | integer | Video frame rate returned as frames per second. |
dataNode[].data | object | Public video card details returned in the module. |
dataNode[].data.vid | string | Public video identifier returned with the card. |
dataNode[].data.title | string | Title displayed for the video card. |
dataNode[].data.summary | string | Summary text displayed for the video card. |
dataNode[].data.img | string | Image URL displayed with the card. |
dataNode[].data.ratio | string | Aspect-ratio label returned for the video card as text. |
dataNode[].data.comments | object | Reported comment and bullet-comment information when provided. |
dataNode[].data.comments.count | integer | Reported comment count for this video. |
dataNode[].data.comments.title | string | Display text associated with the comment count. |
dataNode[].data.comments.totalBullet | integer | Reported bullet-comment count when available. |
dataNode[].data.comments.totalBulletTitle | string | Display text associated with the bullet-comment count. |
dataNode[].data.poster | object | Cover and overlay information returned for the video card. |
dataNode[].data.poster.headFrame | string | Preview image URL supplied for the video card. |
dataNode[].data.poster.lBottom | object | Lower-left display label on the video cover. |
dataNode[].data.poster.lBottom.title | string | Text displayed in the lower-left label, which can show video duration. |
dataNode[].data.preview | object | Video identifier carried by the preview data. |
dataNode[].data.preview.vid | string | Public video identifier returned with the card. |
dataNode[].data.vipMark | object | Display badge metadata returned for the video card. |
dataNode[].data.vipMark.verifyDesc | string | null | Description returned for this display badge when available. |
dataNode[].data.vipMark.verifyTypeName | string | Type name returned for this display badge. |
dataNode[].data.vipMark.verifyType | integer | Platform type code for the display badge. |
Response Example
Loading the response example...