---
title: "Douyin E-commerce Product SKU Info API (V1)"
description: "Retrieves SKU information for a Douyin E-commerce product by item ID. Use it to inspect the purchasable variations of a known product during catalog review."
aiUsagePrompt: true
---

# Douyin E\-commerce Product SKU Info API \(V1\)

<ApiTester
  method="GET"
  :path='JSON.parse("\"/api/douyin-ec/get-item-sku-info/v1\"")'
  :summary='JSON.parse("\"Product SKU Info (V1)\"")'
  openapiDefinitionUrl="https://docs.justoneapi.com/openapi/douyin-e-commerce/product-sku-info-v1-en.json"
  openapiVersion="3.1.0"
  :parameters='JSON.parse("[{\"name\":\"token\",\"in\":\"query\",\"description\":\"Access token for this API service.\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"itemId\",\"in\":\"query\",\"description\":\"The unique ID of the item on Douyin E-commerce.\",\"required\":true,\"schema\":{\"type\":\"string\"}}]")'
  :requestBody='JSON.parse("null")'
  :responses='JSON.parse("{\"200\":{\"description\":\"OK\",\"content\":{\"application/json\":{\"schema\":{\"if\":{\"properties\":{\"code\":{\"const\":0}},\"required\":[\"code\"]},\"then\":{\"properties\":{\"data\":{\"description\":\"Douyin E-Commerce product information, SKU variants, and selected details. A product-unavailable result can contain only the message field. Other successful text values can pass through unchanged.\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"The Douyin E-Commerce product ID, returned as a string.\"},\"name\":{\"type\":\"string\",\"description\":\"Product title.\"},\"description\":{\"type\":\"string\",\"description\":\"Product description text. This can be an empty string.\"},\"mainImg\":{\"type\":\"string\",\"description\":\"URL of the main product image.\"},\"salePrice\":{\"type\":\"integer\",\"description\":\"The product-level sale price value. The response does not specify the monetary unit.\"},\"originalPrice\":{\"type\":\"integer\",\"description\":\"The original price value reported for the product. The response does not specify the monetary unit.\"},\"sellNum\":{\"type\":\"integer\",\"description\":\"Sales count reported for the product. The response does not specify the measurement period.\"},\"shopId\":{\"type\":\"integer\",\"description\":\"ID of the shop listing the product.\"},\"skus\":{\"type\":\"array\",\"description\":\"SKU variants returned for the product.\",\"items\":{\"type\":\"object\",\"description\":\"One SKU variant.\",\"properties\":{\"id\":{\"type\":\"integer\",\"description\":\"ID of the SKU variant.\"},\"shopId\":{\"type\":\"integer\",\"description\":\"ID of the shop that lists the SKU.\"},\"productId\":{\"type\":\"string\",\"description\":\"ID of the parent product, returned as a string.\"},\"price\":{\"type\":\"integer\",\"description\":\"The sale price value for this SKU. The response does not specify the monetary unit.\"},\"type\":{\"type\":\"integer\",\"description\":\"SKU type code returned by the platform.\"},\"salePropertyValues\":{\"type\":\"array\",\"description\":\"Sales specification values selected for this SKU.\",\"items\":{\"type\":\"object\",\"description\":\"One selected sales specification and its value.\",\"properties\":{\"seq\":{\"type\":\"integer\",\"description\":\"Sequence value of this sales specification.\"},\"pairId\":{\"type\":\"integer\",\"description\":\"Identifier of the sales specification and value pair.\"},\"pic\":{\"type\":\"string\",\"description\":\"Image URL for this option. This can be an empty string.\"},\"property\":{\"type\":\"object\",\"description\":\"The sales specification.\",\"properties\":{\"PropertyId\":{\"type\":\"integer\",\"description\":\"Sales specification ID.\"},\"PropertyName\":{\"type\":\"string\",\"description\":\"Name of the sales specification.\"},\"SpecType\":{\"type\":\"integer\",\"description\":\"Specification type code returned by the platform.\"}}},\"value\":{\"type\":\"object\",\"description\":\"The selected value for this sales specification.\",\"properties\":{\"ValueName\":{\"type\":\"string\",\"description\":\"Name of the selected value.\"},\"DisplayValueName\":{\"type\":\"string\",\"description\":\"Display name of the selected value.\"}}}}}}}}},\"category\":{\"type\":\"object\",\"description\":\"The product&#39;s category hierarchy.\",\"properties\":{\"firstCid\":{\"type\":\"integer\",\"description\":\"First-level category ID.\"},\"firstCName\":{\"type\":\"string\",\"description\":\"First-level category name.\"},\"secondCid\":{\"type\":\"integer\",\"description\":\"Second-level category ID.\"},\"secondCName\":{\"type\":\"string\",\"description\":\"Second-level category name.\"},\"thirdCid\":{\"type\":\"integer\",\"description\":\"Third-level category ID. A value of 0 can indicate an unpopulated level.\"},\"thirdCName\":{\"type\":\"string\",\"description\":\"Third-level category name. This can be an empty string when the level is unpopulated.\"},\"fourthCid\":{\"type\":\"integer\",\"description\":\"Fourth-level category ID. A value of 0 can indicate an unpopulated level.\"},\"fourthCName\":{\"type\":\"string\",\"description\":\"Fourth-level category name. This can be an empty string when the level is unpopulated.\"}}},\"detail_info\":{\"type\":\"object\",\"description\":\"Additional product details, images, and specifications.\",\"properties\":{\"detail_imgs\":{\"type\":\"array\",\"description\":\"Images returned for the product detail section.\",\"items\":{\"type\":\"object\",\"description\":\"One product detail image.\",\"properties\":{\"uri\":{\"type\":\"string\",\"description\":\"Image resource URI returned by the platform.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs for the image.\",\"items\":{\"type\":\"string\"}},\"width\":{\"type\":\"integer\",\"description\":\"Image width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Image height in pixels.\"}}}},\"detail_imgs_new\":{\"type\":\"array\",\"description\":\"Product detail image entries with an image type.\",\"items\":{\"type\":\"object\",\"description\":\"One product detail image entry.\",\"properties\":{\"image\":{\"type\":\"object\",\"description\":\"Image resource for the entry.\",\"properties\":{\"uri\":{\"type\":\"string\",\"description\":\"Image resource URI returned by the platform.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs for the image.\",\"items\":{\"type\":\"string\"}},\"width\":{\"type\":\"integer\",\"description\":\"Image width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Image height in pixels.\"}}},\"pic_type\":{\"type\":\"string\",\"description\":\"Image type value returned by the platform.\"}}}},\"title_image\":{\"type\":\"object\",\"description\":\"The image returned for the product detail header.\",\"properties\":{\"uri\":{\"type\":\"string\",\"description\":\"Image resource URI returned by the platform.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs for the image.\",\"items\":{\"type\":\"string\"}},\"width\":{\"type\":\"integer\",\"description\":\"Image width in pixels.\"},\"height\":{\"type\":\"integer\",\"description\":\"Image height in pixels.\"}}},\"product_format\":{\"type\":\"array\",\"description\":\"Groups of product specification entries.\",\"items\":{\"type\":\"object\",\"description\":\"One product specification group.\",\"properties\":{\"format\":{\"type\":\"array\",\"description\":\"Specification entries in this group.\",\"items\":{\"type\":\"object\",\"description\":\"One product specification.\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"Name of the product specification.\"},\"property_id\":{\"type\":\"string\",\"description\":\"Product specification ID, returned as a string.\"},\"message\":{\"type\":\"array\",\"description\":\"Displayed values for this product specification.\",\"items\":{\"type\":\"object\",\"description\":\"One displayed value of the product specification.\",\"properties\":{\"desc\":{\"type\":\"string\",\"description\":\"Displayed text of the specification value.\"}}}}}}}}}},\"jump_url\":{\"type\":\"string\",\"description\":\"Navigation link for the product detail view. The link can use an app-specific scheme.\"}}},\"message\":{\"type\":\"string\",\"description\":\"Product-unavailable message. A successful response can contain only this field with the value `商品不存在`.\"}}}}},\"allOf\":[{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}]}}}},\"400\":{\"description\":\"Invalid request parameters or body\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"401\":{\"description\":\"Invalid or inactive access token\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"403\":{\"description\":\"Permission denied\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"429\":{\"description\":\"Request rate or daily quota limit exceeded\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"503\":{\"description\":\"Service temporarily unavailable\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}}}")'
  :servers='JSON.parse("[{\"url\":\"https://api.justoneapi.com\",\"description\":\"Global production API (default)\"}]")'
  :security='JSON.parse("[]")'
  :securitySchemes='JSON.parse("{}")'
  :schemas='JSON.parse("{}")'
/>

<ApiHealthSection :api='JSON.parse("\"/api/douyin-ec/get-item-sku-info/v1\"")' />

<p>Retrieves SKU information for a Douyin E-commerce product by item ID. Use it to inspect the purchasable variations of a known product during catalog review.</p>

## Highlights

::: warning Guidance
<p>This version returns complete SKU information, but has a relatively low request success rate.</p>
:::

## Parameters

<div class="api-doc-table api-doc-table--params">

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| <code>token</code> | query | <code>string</code> | Yes | - | Access token for this API service. |
| <code>itemId</code> | query | <code>string</code> | Yes | - | The unique ID of the item on Douyin E-commerce. |

</div>

## Code Samples

::: code-group

```bash [🐚 cURL]
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=VALUE'
```

```text [🤖 AI Prompt]
I want to use the "Product SKU Info (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=VALUE
API Endpoint: BASE_URL + /api/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-e-commerce/product-sku-info-v1-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- itemId (query): The unique ID of the item on Douyin E-commerce. (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 [🐍 Python]
import requests

BASE_URL = "https://api.justoneapi.com"  # Provided by OpenAPI servers

url = BASE_URL + "/api/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=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 [🌐 JavaScript]
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=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 [☕ 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/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=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 [🐹 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/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=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]
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/douyin-ec/get-item-sku-info/v1?token=YOUR_API_KEY&itemId=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;
}
```

:::

<div style="text-align: right; margin-top: -20px; margin-bottom: 20px;">
<a href="/openapi/douyin-e-commerce/product-sku-info-v1-en.json" target="_blank" style="font-size: 12px; color: var(--vp-c-text-3); text-decoration: none; opacity: 0.8;">[OpenAPI Definition (JSON)]</a>
</div>

## Response Fields

Key fields in a successful response (`code = 0`).

<div class="api-doc-table api-doc-table--response">

| Field path | Type | Description |
| --- | --- | --- |
| <code>data</code> | - | Douyin E-Commerce product information, SKU variants, and selected details. A product-unavailable result can contain only the message field. Other successful text values can pass through unchanged. |
| <code>data.id</code> | <code>string</code> | The Douyin E-Commerce product ID, returned as a string. |
| <code>data.name</code> | <code>string</code> | Product title. |
| <code>data.description</code> | <code>string</code> | Product description text. This can be an empty string. |
| <code>data.mainImg</code> | <code>string</code> | URL of the main product image. |
| <code>data.salePrice</code> | <code>integer</code> | The product-level sale price value. The response does not specify the monetary unit. |
| <code>data.originalPrice</code> | <code>integer</code> | The original price value reported for the product. The response does not specify the monetary unit. |
| <code>data.sellNum</code> | <code>integer</code> | Sales count reported for the product. The response does not specify the measurement period. |
| <code>data.shopId</code> | <code>integer</code> | ID of the shop listing the product. |
| <code>data.skus</code> | <code>array</code> | SKU variants returned for the product. |
| <code>data.skus[]</code> | <code>object</code> | One SKU variant. |
| <code>data.skus[].id</code> | <code>integer</code> | ID of the SKU variant. |
| <code>data.skus[].shopId</code> | <code>integer</code> | ID of the shop that lists the SKU. |
| <code>data.skus[].productId</code> | <code>string</code> | ID of the parent product, returned as a string. |
| <code>data.skus[].price</code> | <code>integer</code> | The sale price value for this SKU. The response does not specify the monetary unit. |
| <code>data.skus[].type</code> | <code>integer</code> | SKU type code returned by the platform. |
| <code>data.skus[].salePropertyValues</code> | <code>array</code> | Sales specification values selected for this SKU. |
| <code>data.skus[].salePropertyValues[]</code> | <code>object</code> | One selected sales specification and its value. |
| <code>data.skus[].salePropertyValues[].seq</code> | <code>integer</code> | Sequence value of this sales specification. |
| <code>data.skus[].salePropertyValues[].pairId</code> | <code>integer</code> | Identifier of the sales specification and value pair. |
| <code>data.skus[].salePropertyValues[].pic</code> | <code>string</code> | Image URL for this option. This can be an empty string. |
| <code>data.skus[].salePropertyValues[].property</code> | <code>object</code> | The sales specification. |
| <code>data.skus[].salePropertyValues[].property.PropertyId</code> | <code>integer</code> | Sales specification ID. |
| <code>data.skus[].salePropertyValues[].property.PropertyName</code> | <code>string</code> | Name of the sales specification. |
| <code>data.skus[].salePropertyValues[].property.SpecType</code> | <code>integer</code> | Specification type code returned by the platform. |
| <code>data.skus[].salePropertyValues[].value</code> | <code>object</code> | The selected value for this sales specification. |
| <code>data.skus[].salePropertyValues[].value.ValueName</code> | <code>string</code> | Name of the selected value. |
| <code>data.skus[].salePropertyValues[].value.DisplayValueName</code> | <code>string</code> | Display name of the selected value. |
| <code>data.category</code> | <code>object</code> | The product's category hierarchy. |
| <code>data.category.firstCid</code> | <code>integer</code> | First-level category ID. |
| <code>data.category.firstCName</code> | <code>string</code> | First-level category name. |
| <code>data.category.secondCid</code> | <code>integer</code> | Second-level category ID. |
| <code>data.category.secondCName</code> | <code>string</code> | Second-level category name. |
| <code>data.category.thirdCid</code> | <code>integer</code> | Third-level category ID. A value of 0 can indicate an unpopulated level. |
| <code>data.category.thirdCName</code> | <code>string</code> | Third-level category name. This can be an empty string when the level is unpopulated. |
| <code>data.category.fourthCid</code> | <code>integer</code> | Fourth-level category ID. A value of 0 can indicate an unpopulated level. |
| <code>data.category.fourthCName</code> | <code>string</code> | Fourth-level category name. This can be an empty string when the level is unpopulated. |
| <code>data.detail_info</code> | <code>object</code> | Additional product details, images, and specifications. |
| <code>data.detail_info.detail_imgs</code> | <code>array</code> | Images returned for the product detail section. |
| <code>data.detail_info.detail_imgs[]</code> | <code>object</code> | One product detail image. |
| <code>data.detail_info.detail_imgs[].uri</code> | <code>string</code> | Image resource URI returned by the platform. |
| <code>data.detail_info.detail_imgs[].url_list</code> | <code>array</code> | Available URLs for the image. |
| <code>data.detail_info.detail_imgs[].url_list[]</code> | <code>string</code> | - |
| <code>data.detail_info.detail_imgs[].width</code> | <code>integer</code> | Image width in pixels. |
| <code>data.detail_info.detail_imgs[].height</code> | <code>integer</code> | Image height in pixels. |
| <code>data.detail_info.detail_imgs_new</code> | <code>array</code> | Product detail image entries with an image type. |
| <code>data.detail_info.detail_imgs_new[]</code> | <code>object</code> | One product detail image entry. |
| <code>data.detail_info.detail_imgs_new[].image</code> | <code>object</code> | Image resource for the entry. |
| <code>data.detail_info.detail_imgs_new[].image.uri</code> | <code>string</code> | Image resource URI returned by the platform. |
| <code>data.detail_info.detail_imgs_new[].image.url_list</code> | <code>array</code> | Available URLs for the image. |
| <code>data.detail_info.detail_imgs_new[].image.url_list[]</code> | <code>string</code> | - |
| <code>data.detail_info.detail_imgs_new[].image.width</code> | <code>integer</code> | Image width in pixels. |
| <code>data.detail_info.detail_imgs_new[].image.height</code> | <code>integer</code> | Image height in pixels. |
| <code>data.detail_info.detail_imgs_new[].pic_type</code> | <code>string</code> | Image type value returned by the platform. |
| <code>data.detail_info.title_image</code> | <code>object</code> | The image returned for the product detail header. |
| <code>data.detail_info.title_image.uri</code> | <code>string</code> | Image resource URI returned by the platform. |
| <code>data.detail_info.title_image.url_list</code> | <code>array</code> | Available URLs for the image. |
| <code>data.detail_info.title_image.url_list[]</code> | <code>string</code> | - |
| <code>data.detail_info.title_image.width</code> | <code>integer</code> | Image width in pixels. |
| <code>data.detail_info.title_image.height</code> | <code>integer</code> | Image height in pixels. |
| <code>data.detail_info.product_format</code> | <code>array</code> | Groups of product specification entries. |
| <code>data.detail_info.product_format[]</code> | <code>object</code> | One product specification group. |
| <code>data.detail_info.product_format[].format</code> | <code>array</code> | Specification entries in this group. |
| <code>data.detail_info.product_format[].format[]</code> | <code>object</code> | One product specification. |
| <code>data.detail_info.product_format[].format[].name</code> | <code>string</code> | Name of the product specification. |
| <code>data.detail_info.product_format[].format[].property_id</code> | <code>string</code> | Product specification ID, returned as a string. |
| <code>data.detail_info.product_format[].format[].message</code> | <code>array</code> | Displayed values for this product specification. |
| <code>data.detail_info.product_format[].format[].message[]</code> | <code>object</code> | One displayed value of the product specification. |
| <code>data.detail_info.product_format[].format[].message[].desc</code> | <code>string</code> | Displayed text of the specification value. |
| <code>data.detail_info.jump_url</code> | <code>string</code> | Navigation link for the product detail view. The link can use an app-specific scheme. |
| <code>data.message</code> | <code>string</code> | Product-unavailable message. A successful response can contain only this field with the value <code>商品不存在</code>. |

</div>

## Response Example

<ApiExampleSection :api='JSON.parse("\"/api/douyin-ec/get-item-sku-info/v1\"")' />

