Skip to content

Douyin (TikTok China) Comment Replies API (V1) ​

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

Retrieves replies to a top-level Douyin (TikTok China) video comment with page-based pagination. Use it to inspect threaded discussions and review feedback under a known comment.

Parameters ​

NameInTypeRequiredDefaultDescription
tokenquerystringYes-Access token for this API service.
commentIdquerystringYes-The unique identifier of the top-level comment.
pagequeryintegerNo1Page number (starting from 1).

Code Samples ​

bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/douyin/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=VALUE'
text
I want to use the "Comment Replies (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/douyin/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=VALUE
API Endpoint: BASE_URL + /api/douyin/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-tiktok-china/comment-replies-v1-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- commentId (query): The unique identifier of the top-level comment. (Required)
- page (query): Page number (starting from 1).

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/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=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/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=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/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=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/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=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/get-video-sub-comment/v1?token=YOUR_API_KEY&commentId=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).

Results and pagination6 fields

data

One page of replies under a requested top-level Douyin comment.

FieldTypeDescription
status_codeintegerPlatform status code inside the Douyin reply data.
cursorintegerNumeric cursor returned for the reply page. Use the page request parameter to select a page.
has_moreintegerNumeric flag indicating whether additional reply pages are available. Observed values are 1 for more pages and 0 at the end.
totalintegerTotal number of replies reported for the requested comment.
commentsarray | nullReplies on this page. A successful response with no replies can return null.
comments[]objectOne reply under the requested top-level comment.
Reply details and engagement12 fields

data.comments[]

FieldTypeDescription
cidstringID of this reply comment, returned as a string.
aweme_idstringID of the Douyin post containing the comment thread.
textstringText of the reply comment.
create_timeintegerPublication time of the reply as Unix epoch seconds.
digg_countintegerNumber of likes reported for the reply.
statusintegerNumeric status code reported for the reply.
levelintegerNesting level reported for the reply.
comment_reply_totalintegerNumber of replies reported for this comment entry.
is_hotbooleanWhether Douyin marks the reply as hot.
is_foldedbooleanWhether Douyin reports the reply as collapsed.
is_author_diggedbooleanWhether Douyin marks the reply as liked by the author.
content_typeintegerNumeric content type code reported for the reply.
Reply relationships5 fields

data.comments[]

FieldTypeDescription
reply_idstringID of the top-level parent comment, matching the commentId request parameter.
reply_to_reply_idstringID of the reply targeted by this reply. The string 0 can indicate no specific reply target.
reply_to_usernamestringDisplayed name associated with the user being replied to, when available.
reply_to_useridstringDouyin ID of the user being replied to, when available.
reply_to_user_sec_idstringOpaque Douyin identifier of the user being replied to, when available.
Reply author45 fields

data.comments[]

FieldTypeDescription
userobjectPublic profile information reported for the reply author.
user.uidstringDouyin user ID of the reply author, returned as text.
user.sec_uidstringOpaque Douyin user identifier for the reply author.
user.short_idstringShort account ID reported for the author.
user.unique_idstringPublic account handle reported for the author.
user.nicknamestringDisplay name of the reply author.
user.avatar_thumbobjectThumbnail avatar information.
user.avatar_thumb.uristringMedia resource identifier reported by Douyin.
user.avatar_thumb.url_listarrayLinks for the media resource. The array can be empty.
user.avatar_thumb.url_list[]stringOne link for this media resource.
user.avatar_thumb.widthintegerWidth reported for the media resource.
user.avatar_thumb.heightintegerHeight reported for the media resource.
user.avatar_mediumobjectMedium-size avatar information.
user.avatar_medium.uristringMedia resource identifier reported by Douyin.
user.avatar_medium.url_listarrayLinks for the media resource. The array can be empty.
user.avatar_medium.url_list[]stringOne link for this media resource.
user.avatar_medium.widthintegerWidth reported for the media resource.
user.avatar_medium.heightintegerHeight reported for the media resource.
user.avatar_largerobjectLarger avatar information.
user.avatar_larger.uristringMedia resource identifier reported by Douyin.
user.avatar_larger.url_listarrayLinks for the media resource. The array can be empty.
user.avatar_larger.widthintegerWidth reported for the media resource.
user.avatar_larger.heightintegerHeight reported for the media resource.
user.avatar_168x168objectAvatar information in the 168×168 variant field.
user.avatar_168x168.uristringMedia resource identifier reported by Douyin.
user.avatar_168x168.url_listarrayLinks for the media resource. The array can be empty.
user.avatar_168x168.widthintegerWidth reported for the media resource.
user.avatar_168x168.heightintegerHeight reported for the media resource.
user.avatar_300x300objectAvatar information in the 300×300 variant field.
user.avatar_300x300.uristringMedia resource identifier reported by Douyin.
user.avatar_300x300.url_listarrayLinks for the media resource. The array can be empty.
user.avatar_300x300.widthintegerWidth reported for the media resource.
user.avatar_300x300.heightintegerHeight reported for the media resource.
user.is_verifiedbooleanWhether the author is marked as verified.
user.verification_typeintegerNumeric verification type code reported for the author.
user.custom_verifystringCustom verification text reported for the author.
user.enterprise_verify_reasonstringEnterprise verification description reported for the author.
user.aweme_countintegerPost count reported for the author.
user.follower_countintegerFollower count reported for the author.
user.follower_count_strstringDisplay text for the author’s follower count.
user.following_countintegerNumber of accounts followed by the author.
user.favoriting_countintegerCount of items the author liked, as reported in the author data.
user.total_favoritedintegerTotal likes received by the author as reported by Douyin.
user.room_idintegerNumeric live room identifier reported for the author, when present.
user.room_id_strstringText representation of the reported live room identifier.
Text entities and labels15 fields

data.comments[]

FieldTypeDescription
text_extraarrayStructured mentions or topic metadata attached to the reply text. The array can be empty.
text_extra[]objectMetadata for one span of the reply text.
text_extra[].startintegerStart offset of the text entity, as reported by Douyin.
text_extra[].endintegerEnd offset of the text entity, as reported by Douyin.
text_extra[].typeintegerNumeric type code for the text entity.
text_extra[].user_idstringUser identifier reported for the text entity, when available.
text_extra[].sec_uidstringOpaque Douyin user identifier for the text entity, when available.
text_extra[].hashtag_idstringHashtag identifier reported for the text entity, when available.
text_extra[].hashtag_namestringDisplay name of the hashtag reported for the text entity.
label_textstringDisplay label shown with the reply. The string can be empty.
label_typeintegerNumeric type code for the reply’s display label.
label_listarray | nullDisplay labels attached to the reply, returned as an array or null.
label_list[]objectOne display label on the reply.
label_list[].typeintegerNumeric reply label type.
label_list[].textstringVisible text of the reply label.
Sticker19 fields

data.comments[]

FieldTypeDescription
stickerobjectSticker attachment reported for the reply, when available.
sticker.idintegerSticker identifier returned as an integer.
sticker.id_strstringSticker identifier returned as text.
sticker.widthintegerWidth reported for the sticker.
sticker.heightintegerHeight reported for the sticker.
sticker.static_urlobjectStatic image information for the sticker.
sticker.static_url.uristringMedia resource identifier reported by Douyin.
sticker.static_url.url_listarrayLinks for the media resource. The array can be empty.
sticker.static_url.url_list[]stringOne link for this media resource.
sticker.static_url.widthintegerWidth reported for the media resource.
sticker.static_url.heightintegerHeight reported for the media resource.
sticker.animate_urlobjectAnimated image information for the sticker.
sticker.animate_url.uristringMedia resource identifier reported by Douyin.
sticker.animate_url.url_listarrayLinks for the media resource. The array can be empty.
sticker.animate_url.url_list[]stringOne link for this media resource.
sticker.animate_url.widthintegerWidth reported for the media resource.
sticker.animate_url.heightintegerHeight reported for the media resource.
sticker.sticker_typeintegerNumeric type code reported for the sticker.
sticker.origin_package_idintegerIdentifier of the original sticker pack.

Response Example ​

Loading the response example...