Endpoint
POST https://api.ugc.inc/comment/status
Overview
Check the current status of a comment created with the Create Comment endpoint. The comment will progress through different states as it is being posted.
pending - Comment is queued and waiting to be processed
running - Comment is currently being posted
completed - Comment was successfully posted
failed - Comment failed to post (error message included)
Request Body
Comment ID returned from the Create Comment endpoint
Response
Status information for the comment The response structure varies based on the status: Show Pending/Running Status
Current status of the comment
Error message explaining why the comment failed
Direct URL to the posted comment on TikTok Format: https://www.tiktok.com/@username/video/{video_id}?comment_id={comment_id}
cURL
Python
JavaScript
React
curl -X POST https://api.ugc.inc/comment/status \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"commentId": "550e8400-e29b-41d4-a716-446655440000"
}'
Success Response (Completed)
Success Response (Failed)
Success Response (Pending)
Success Response (Running)
Error Response (Comment Not Found)
{
"ok" : true ,
"code" : 200 ,
"message" : "Success" ,
"data" : {
"status" : "completed" ,
"commentUrl" : "https://www.tiktok.com/@creator/video/7234567890123456789?comment_id=7000000000000000001"
}
}