Skip to content

TikTok Post Comments API (V1) ​

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

Retrieves comments for a TikTok post with cursor pagination. Use it to review audience discussion, continue through comment pages, or support comment analysis for a known post.

Parameters ​

NameInTypeRequiredDefaultDescription
tokenquerystringYes-Security token for API access.
awemeIdquerystringYes-The unique ID of the TikTok post (awemeId).
cursorquerystringNo0Pagination cursor. Start with '0'.

Code Samples ​

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

Parameters:
- token (query): Security token for API access. (Required)
- awemeId (query): The unique ID of the TikTok post (awemeId). (Required)
- cursor (query): Pagination cursor. Start with '0'.

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/tiktok/get-post-comment/v1?token=YOUR_API_KEY&awemeId=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/tiktok/get-post-comment/v1?token=YOUR_API_KEY&awemeId=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/tiktok/get-post-comment/v1?token=YOUR_API_KEY&awemeId=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/tiktok/get-post-comment/v1?token=YOUR_API_KEY&awemeId=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/tiktok/get-post-comment/v1?token=YOUR_API_KEY&awemeId=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).

Comment content10 fields

data.comments[]

One top-level comment on the requested post.

FieldTypeDescription
cidstringTikTok identifier of this comment.
aweme_idstringTikTok post identifier associated with this comment.
textstringText of the comment.
create_timeintegerComment creation time as a Unix timestamp in seconds.
comment_languagestringReported language code of the comment.
content_typeintegerNumeric content type reported for the comment.
text_extraarraySupplementary text annotations for the comment. This array can be empty.
image_list-Comment image attachment field. The verified responses returned null.
is_comment_translatablebooleanWhether TikTok marks the comment as translatable.
statusintegerNumeric status reported for the comment.
Pagination and status7 fields

data

TikTok post comment results and pagination information.

FieldTypeDescription
cursorintegerCursor returned for pagination. When has_more is 1, pass this integer as exact decimal text in the next cursor request parameter.
has_moreintegerReported pagination flag. The value 1 indicates another page and 0 indicates the end.
totalintegerReported total comments for the queried post. The current page can contain fewer comments.
has_filtered_commentsintegerNumeric flag reported for filtered comments.
status_codeintegerNumeric status code in the TikTok comment payload.
status_msgstringStatus message in the TikTok comment payload. It can be an empty string.
commentsarray | nullTop-level comments on this page. An empty result can be an empty array or null.
Comment engagement6 fields

data.comments[]

FieldTypeDescription
digg_countintegerReported number of likes on the comment.
is_author_diggedbooleanWhether the post author liked the comment.
author_pinbooleanWhether the comment is marked as pinned by the post author.
reply_idstringParent comment identifier field. Verified top-level comments returned the string 0.
reply_to_reply_idstringReply target identifier field. Verified top-level comments returned the string 0.
reply_comment_totalintegerReported total replies to this comment. The preview can contain fewer replies.
Comment author12 fields

data.comments[]

FieldTypeDescription
userobjectTikTok user who wrote the comment.
user.uidstringTikTok user ID.
user.sec_uidstringSecondary TikTok user identifier.
user.unique_idstringPublic username of the TikTok user.
user.nicknamestringDisplay name of the TikTok user.
user.avatar_uristringImage reference for the user avatar.
user.avatar_thumbobjectThumbnail avatar and its available image URLs.
user.avatar_thumb.uristringImage reference for the avatar thumbnail.
user.avatar_thumb.widthintegerAvatar thumbnail width in pixels.
user.avatar_thumb.heightintegerAvatar thumbnail height in pixels.
user.avatar_thumb.url_listarrayAvailable URLs of the avatar thumbnail.
user.avatar_thumb.url_list[]stringURL of the avatar thumbnail.
Labels and sharing8 fields

data.comments[]

FieldTypeDescription
share_infoobjectShare information associated with the comment.
share_info.titlestringTitle in the comment share information.
share_info.descstringDescription in the comment share information.
share_info.urlstringURL in the comment share information.
label_listarray | nullLabels attached to the comment. The field can be null.
label_list[]objectOne label attached to the comment.
label_list[].textstringDisplay text of the comment label.
label_list[].typeintegerNumeric type of the comment label.
Preview replies35 fields

data.comments[]

FieldTypeDescription
reply_commentarray | nullPreview replies included with this comment. The field can be null.
reply_comment[]objectOne preview reply included with a top-level comment.
reply_comment[].cidstringTikTok identifier of this comment.
reply_comment[].aweme_idstringTikTok post identifier associated with this comment.
reply_comment[].textstringText of the comment.
reply_comment[].create_timeintegerComment creation time as a Unix timestamp in seconds.
reply_comment[].comment_languagestringReported language code of the comment.
reply_comment[].content_typeintegerNumeric content type reported for the comment.
reply_comment[].text_extraarraySupplementary text annotations for the comment. This array can be empty.
reply_comment[].image_list-Comment image attachment field. The verified responses returned null.
reply_comment[].digg_countintegerReported number of likes on the comment.
reply_comment[].is_author_diggedbooleanWhether the post author liked the comment.
reply_comment[].author_pinbooleanWhether the comment is marked as pinned by the post author.
reply_comment[].is_comment_translatablebooleanWhether TikTok marks the comment as translatable.
reply_comment[].statusintegerNumeric status reported for the comment.
reply_comment[].share_infoobjectShare information associated with the comment.
reply_comment[].share_info.titlestringTitle in the comment share information.
reply_comment[].share_info.descstringDescription in the comment share information.
reply_comment[].share_info.urlstringURL in the comment share information.
reply_comment[].userobjectTikTok user who wrote the preview reply.
reply_comment[].user.uidstringTikTok user ID.
reply_comment[].user.sec_uidstringSecondary TikTok user identifier.
reply_comment[].user.unique_idstringPublic username of the TikTok user.
reply_comment[].user.nicknamestringDisplay name of the TikTok user.
reply_comment[].user.avatar_uristringImage reference for the user avatar.
reply_comment[].user.avatar_thumbobjectThumbnail avatar and its available image URLs.
reply_comment[].user.avatar_thumb.uristringImage reference for the avatar thumbnail.
reply_comment[].user.avatar_thumb.widthintegerAvatar thumbnail width in pixels.
reply_comment[].user.avatar_thumb.heightintegerAvatar thumbnail height in pixels.
reply_comment[].user.avatar_thumb.url_listarrayAvailable URLs of the avatar thumbnail.
reply_comment[].user.avatar_thumb.url_list[]stringURL of the avatar thumbnail.
reply_comment[].reply_idstringIdentifier of the parent comment for this preview reply.
reply_comment[].reply_to_reply_idstringIdentifier in the reply-to-reply field. Verified preview replies returned the string 0.
reply_comment[].label_textstringDisplay text of the label attached to this preview reply.
reply_comment[].label_typeintegerNumeric label type reported for this preview reply.

Response Example ​

Loading the response example...