Create Comment

curl -X POST https://api.ugc.inc/comment/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_123456",
    "postUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
    "commentText": "Great video! 🔥"
  }'

import requests

response = requests.post(
    'https://api.ugc.inc/comment/create',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'accountId': 'acc_123456',
        'postUrl': 'https://www.tiktok.com/@creator/video/7234567890123456789',
        'commentText': 'Great video! 🔥'
    }
)

data = response.json()

if data['ok']:
    print('Comment created:', data['data']['commentId'])
    # Use this commentId to check status later

const response = await fetch("https://api.ugc.inc/comment/create", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    accountId: "acc_123456",
    postUrl: "https://www.tiktok.com/@creator/video/7234567890123456789",
    commentText: "Great video! 🔥",
  }),
});

const data = await response.json();

if (data.ok) {
  console.log("Comment created:", data.data.commentId);
  // Use this commentId to check status later
}

import { UGCClient } from "ugcinc";

const client = new UGCClient({
  apiKey: "YOUR_API_KEY",
});

const response = await client.comments.createComment({
  accountId: "acc_123456",
  postUrl: "https://www.tiktok.com/@creator/video/7234567890123456789",
  commentText: "Great video! 🔥",
});

if (response.ok) {
  console.log(`Comment created: ${response.data.commentId}`);

  // Poll for status
  const checkStatus = async (commentId: string) => {
    const statusResponse = await client.comments.getComments({
      commentIds: [commentId],
    });

    if (statusResponse.ok && statusResponse.data.length > 0) {
      const comment = statusResponse.data[0];
      if (comment.status === "completed") {
        console.log("Comment posted!", comment.commentUrl);
      } else if (comment.status === "failed") {
        console.log("Comment failed:", comment.error);
      } else {
        // Still processing - check again later
        setTimeout(() => checkStatus(commentId), 5000);
      }
    }
  };

  checkStatus(response.data.commentId);
}

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "commentId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "ok": false,
  "code": 404,
  "message": "Account not found"
}

{
  "ok": false,
  "code": 400,
  "message": "Account is not fully configured"
}

{
  "ok": false,
  "code": 403,
  "message": "Account does not belong to this organization"
}

Endpoint

POST https://api.ugc.inc/comment/create

Overview

Create a comment on a TikTok video using one of your accounts. Use the returned commentId to check the status of the comment.

Request Body

string

required

Account ID to use for commenting The account must: - Be in setup status - Belong to your organization

string

required

Full URL to the TikTok post to comment on Format: https://www.tiktok.com/@username/video/{video_id} Example: https://www.tiktok.com/@creator/video/7234567890123456789

string

required

The text content of the comment - Can include emojis - Maximum length: 150 characters (TikTok limit) - Cannot be empty

Response

object

Comment creation response

Show Response properties

string

Unique comment identifier - use this to check the comment status

curl -X POST https://api.ugc.inc/comment/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_123456",
    "postUrl": "https://www.tiktok.com/@creator/video/7234567890123456789",
    "commentText": "Great video! 🔥"
  }'

import requests

response = requests.post(
    'https://api.ugc.inc/comment/create',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'accountId': 'acc_123456',
        'postUrl': 'https://www.tiktok.com/@creator/video/7234567890123456789',
        'commentText': 'Great video! 🔥'
    }
)

data = response.json()

if data['ok']:
    print('Comment created:', data['data']['commentId'])
    # Use this commentId to check status later

const response = await fetch("https://api.ugc.inc/comment/create", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    accountId: "acc_123456",
    postUrl: "https://www.tiktok.com/@creator/video/7234567890123456789",
    commentText: "Great video! 🔥",
  }),
});

const data = await response.json();

if (data.ok) {
  console.log("Comment created:", data.data.commentId);
  // Use this commentId to check status later
}

import { UGCClient } from "ugcinc";

const client = new UGCClient({
  apiKey: "YOUR_API_KEY",
});

const response = await client.comments.createComment({
  accountId: "acc_123456",
  postUrl: "https://www.tiktok.com/@creator/video/7234567890123456789",
  commentText: "Great video! 🔥",
});

if (response.ok) {
  console.log(`Comment created: ${response.data.commentId}`);

  // Poll for status
  const checkStatus = async (commentId: string) => {
    const statusResponse = await client.comments.getComments({
      commentIds: [commentId],
    });

    if (statusResponse.ok && statusResponse.data.length > 0) {
      const comment = statusResponse.data[0];
      if (comment.status === "completed") {
        console.log("Comment posted!", comment.commentUrl);
      } else if (comment.status === "failed") {
        console.log("Comment failed:", comment.error);
      } else {
        // Still processing - check again later
        setTimeout(() => checkStatus(commentId), 5000);
      }
    }
  };

  checkStatus(response.data.commentId);
}

{
  "ok": true,
  "code": 200,
  "message": "Success",
  "data": {
    "commentId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "ok": false,
  "code": 404,
  "message": "Account not found"
}

{
  "ok": false,
  "code": 400,
  "message": "Account is not fully configured"
}

{
  "ok": false,
  "code": 403,
  "message": "Account does not belong to this organization"
}

Getting Started

Data Structures

Posts

Comments

Accounts

Statistics

Tasks

Organization

Media

Billing

Automations

Endpoint

Overview

Request Body

Response

​Endpoint

​Overview

​Request Body

​Response

Endpoint

Overview

Request Body

Response