Skip to content

Douyin E-commerce Item Details API (V2) ​

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

Retrieves Douyin E-commerce product details by item ID. Use it to inspect a known marketplace item for catalog or product research.

Highlights ​

Capability

This endpoint includes product sales data.

Parameters ​

NameInTypeRequiredDefaultDescription
tokenquerystringYes-Access token for this API service.
itemIdquerystringYes-The unique ID of the item on Douyin E-commerce.

Code Samples ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/douyin-ec/get-item-detail/v2?token=YOUR_API_KEY&itemId=VALUE'
text
I want to use the "Item Details (V2)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/douyin-ec/get-item-detail/v2?token=YOUR_API_KEY&itemId=VALUE
API Endpoint: BASE_URL + /api/douyin-ec/get-item-detail/v2?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/item-details-v2-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
import requests

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

url = BASE_URL + "/api/douyin-ec/get-item-detail/v2?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
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/douyin-ec/get-item-detail/v2?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
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-detail/v2?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
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-detail/v2?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
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/douyin-ec/get-item-detail/v2?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;
}

Response Fields ​

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

Item identifiers3 fields

data

Douyin E-commerce item details with any available shop information and service labels.

FieldTypeDescription
product_idstringIdentifier of the underlying Douyin E-commerce product.
promotion_idstringPromotion identifier returned for this lookup. It can match the supplied itemId.
item_typeintegerItem type code reported for the product.
Product information10 fields

data.model.product

Structured information about the product.

FieldTypeDescription
product_baseobjectBasic product information and images.
product_base.titlestringProduct title.
product_base.coverstringProduct cover image URL.
product_base.imagesarrayProduct image URLs.
product_base.images[]stringURL of a product image.
product_base.white_backgroundstringProduct image URL for the white-background version.
product_base.big_imgsarrayImage URLs from the product's large-image list.
product_base.big_imgs[]stringURL of an image in the large-image list.
product_base.is_global_shopingbooleanIndicates whether the product is marked as part of Douyin Global Shopping.
product_base.is_sui_xin_tuibooleanIndicates whether the product is marked for the Sui Xin Tui (随心推) promotion feature.
Sales and reviews10 fields

data.model.product

FieldTypeDescription
product_salesobjectSales counts and a display label for the product.
product_sales.product_labelobjectProduct sales label with a numeric count and a display string.
product_sales.product_label.sales_numintegerNumeric sales count in the product label.
product_sales.product_label.sales_textstringSales count display text in the product label.
product_sales.sell_numintegerSales count returned for the product.
product_sales.total_salesintegerTotal sales count reported for the product.
product_commentobjectPositive review percentage for the product, with its display label.
product_comment.good_rationumberPositive review percentage as a number. A value of 83.6 means 83.6%. The display label may round this value.
product_comment.comment_labelobjectDisplay label for the product review metric.
product_comment.comment_label.good_ratiostringFormatted positive review percentage for display.
Product benefits11 fields

data.model.product.product_privilege

Benefits and service promises displayed for the product.

FieldTypeDescription
privilege_info_labelobjectDisplay information for the product benefits.
privilege_info_label.privilege_idintegerReported identifier of the product benefits group.
privilege_info_label.privilege_info_detailarrayBenefit entries displayed for the product.
privilege_info_label.privilege_info_detail[]objectOne product benefit entry.
privilege_info_label.privilege_info_detail[].tag_idstringTag identifier for this benefit.
privilege_info_label.privilege_info_detail[].titlestringDisplay title for this benefit.
privilege_info_label.privilege_info_detail[].contentstringDisplay text describing this benefit.
privilege_info_label.privilege_info_detail[].iconobjectIcon for the displayed benefit.
privilege_info_label.privilege_info_detail[].icon.url_listarrayImage URLs for the benefit icon.
privilege_info_label.privilege_info_detail[].icon.url_list[]stringOne image URL for this benefit icon.
privilege_info_label.privilege_info_detail[].linkstringDouyin app link associated with the benefit, when provided.
Shop information5 fields

data.model.shop

Information about the shop associated with the product.

FieldTypeDescription
shop_idstringDouyin E-commerce shop ID.
shop_baseobjectBasic shop information.
shop_base.shop_namestringShop display name.
shop_base.shop_logostringShop logo image URL.
shop_base.platform_sourceintegerPlatform source code reported for the shop.
Auxiliary module status14 fields

data.model

Product, shop and auxiliary module information.

FieldTypeDescription
promotion_dataobjectPromotion module status.
promotion_data.codeintegerStatus code reported for this module.
comment_dataobjectComment module status.
comment_data.codeintegerStatus code reported for this module.
author_dataobjectAuthor module status.
author_data.codeintegerStatus code reported for this module.
content_dataobjectContent module status.
content_data.codeintegerStatus code reported for this module.
hot_content_dataobjectPopular content module status.
hot_content_data.codeintegerStatus code reported for this module.
shop_product_dataobjectShop products module status.
shop_product_data.codeintegerStatus code reported for this module.
material_dataobjectMaterials module status.
material_data.codeintegerStatus code reported for this module.
Service labels2 fields

data.label

Display labels associated with the product.

FieldTypeDescription
service_moduleobjectService modules displayed for the product.
service_module.module_listarrayList of service modules.
Service module headings9 fields

data.label.service_module.module_list[]

One displayed service module.

FieldTypeDescription
module_typestringType identifier for the service module.
titleobjectDisplay heading for the service module.
title.title_listarrayDisplay segments that make up the module heading.
title.title_list[]objectOne display segment in the module heading.
title.title_list[].rich_textobjectRich-text information for the heading segment.
title.title_list[].rich_text.rich_text_typeintegerType code for the rich-text segment.
title.title_list[].rich_text.textobjectText object in the rich-text segment.
title.title_list[].rich_text.text.textstringDisplay text for the heading segment.
title.title_list[].suffix_typeintegerSuffix type code for this display entry.
Service module details13 fields

data.label.service_module.module_list[].content

Details shown in the service module.

FieldTypeDescription
content_listarrayDisplay entries in the service module details.
content_list[]objectOne entry in the service module details.
content_list[].content_typestringType identifier for the display entry.
content_list[].contentobjectDisplay content for this entry.
content_list[].content.title_listarrayTitle segments for the display content.
content_list[].content.title_list[]objectOne display title segment.
content_list[].content.title_list[].rich_textobjectRich-text information for the content title segment.
content_list[].content.title_list[].rich_text.rich_text_typeintegerType code for the rich-text segment.
content_list[].content.title_list[].rich_text.textobjectText object in the rich-text segment.
content_list[].content.title_list[].rich_text.text.textstringDisplay text for the content title segment.
content_list[].content.title_list[].rich_text.text.font_colorstringColor value for the text. This field can be an empty string.
content_list[].content.title_list[].suffix_typeintegerSuffix type code for this display entry.
content_list[].suffix_typeintegerSuffix type code for this display entry.

Response Example ​

Loading the response example...