Skip to main content

YouTube Comments Inbox

Manage the comments of the connected YouTube channel: read the inbox of one video or of the whole channel, see the comments YouTube held for review or flagged as likely spam, reply, post a new comment, edit or delete your own comments, and approve, hold or reject comments (optionally banning their authors).

The generic comments endpoints (/api/uploadposts/comments with platform=youtube) keep working exactly as before. The endpoints on this page add everything else YouTube offers.

All endpoints need the header Authorization: Apikey your-api-key-here and the profile in user (query string for GET/DELETE, JSON body for the rest). They follow the common rules of the YouTube endpoints.

List comment threads​

GET /api/uploadposts/youtube/comments

Send user and exactly one of video_id, scope=channel or ids.

NameTypeRequiredDescription
userStringYesProfile username with a YouTube channel connected.
video_idStringOne ofThreads of one video.
scopeStringOne ofchannel: the inbox of the whole channel (every video).
idsStringOne ofUp to 50 comment thread IDs, comma separated.
moderation_statusStringNopublished (default), heldForReview or likelySpam. Only for your own channel's videos.
orderStringNotime (default) or relevance.
searchStringNoOnly threads whose comments contain this text (up to 200 characters).
text_formatStringNohtml (default) or plainText.
include_repliesBooleanNoAlso return the replies YouTube includes with each thread (a partial list; use replies for all of them).
max_resultsIntegerNo1-100 (YouTube's default is 20).
page_tokenStringNoThe next_page_token of the previous page.

With ids, YouTube does not accept moderation_status, order, search, max_results or page_token.

curl -G https://api.upload-post.com/api/uploadposts/youtube/comments \
-H 'Authorization: Apikey your-api-key-here' \
--data-urlencode 'user=my-profile' \
--data-urlencode 'scope=channel' \
--data-urlencode 'moderation_status=heldForReview'
{
"success": true,
"items": [
{
"id": "UgzABCDEFGHIJKLMNOP",
"snippet": {
"videoId": "dQw4w9WgXcQ",
"canReply": true,
"totalReplyCount": 0,
"topLevelComment": {
"id": "UgzABCDEFGHIJKLMNOP",
"snippet": {
"textDisplay": "Check my channel https://…",
"authorDisplayName": "@someone",
"authorChannelId": {"value": "UC…"},
"moderationStatus": "heldForReview",
"likeCount": 0,
"publishedAt": "2026-11-14T09:00:00Z"
}
}
}
}
],
"next_page_token": "QURTSl9p…",
"page_info": {"totalResults": 1, "resultsPerPage": 20}
}

Items are YouTube's commentThread resources. A page you just read is reused for up to a minute (the response then carries "cached": true); any write on this page clears it.

List replies​

GET /api/uploadposts/youtube/comments/replies
NameTypeRequiredDescription
userStringYesProfile username.
parent_idStringOne ofID of a top-level comment: returns its replies.
idsStringOne ofUp to 50 comment IDs, comma separated.
text_formatStringNohtml (default) or plainText.
max_resultsIntegerNo1-100, not with ids.
page_tokenStringNoNot with ids.

Items are YouTube's comment resources.

Reply or comment​

POST /api/uploadposts/youtube/comments
NameTypeRequiredDescription
userStringYesProfile username.
parent_idStringOne ofReply to this top-level comment.
video_idStringOne ofPost a new top-level comment on this video.
textStringYesThe comment (message also works). Must be a string.
idempotency_keyStringNoYour own key for this comment (1-200 printable characters). Sending the same key again for the same channel within 24 hours does not post twice: you get the first answer again with "idempotent_replay": true. While the first request has no confirmed result, the repeat answers 409 youtube_duplicate_request and nothing new is sent to YouTube.
curl -X POST https://api.upload-post.com/api/uploadposts/youtube/comments \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{"user": "my-profile", "parent_id": "UgzABCDEFGHIJKLMNOP", "text": "Thanks for watching!"}'

Answers 201 with {"success": true, "comment": {…}} (the new comment or thread as YouTube returns it). If the call answers 502 youtube_write_outcome_unknown, send it again with the same idempotency_key only after checking the comments list: the key stays reserved and the repeat answers 409 youtube_duplicate_request.

Edit your comment​

PATCH /api/uploadposts/youtube/comments/{comment_id}

Body: user and text. Only comments written by the connected channel can be edited.

Delete your comment​

DELETE /api/uploadposts/youtube/comments/{comment_id}?user=my-profile&confirm=true

confirm=true is required: deleting cannot be undone. YouTube only lets the author delete a comment; to remove someone else's comment from your channel, reject it.

Moderate comments​

POST /api/uploadposts/youtube/comments/moderate
NameTypeRequiredDescription
userStringYesProfile username.
comment_idsString or arrayYesUp to 50 comment IDs of your channel, applied in one call.
statusStringYespublished (approve), heldForReview (hold) or rejected (remove from public view).
ban_authorBooleanNoWith status=rejected: also reject every future comment of those authors on your channel.
confirmBooleanWith rejectedMust be true to reject (and to ban).
curl -X POST https://api.upload-post.com/api/uploadposts/youtube/comments/moderate \
-H 'Authorization: Apikey your-api-key-here' \
-H 'Content-Type: application/json' \
-d '{"user": "my-profile", "comment_ids": ["UgzABCDEFGHIJKLMNOP"], "status": "rejected", "ban_author": true, "confirm": true}'
{"success": true, "comment_ids": ["UgzABCDEFGHIJKLMNOP"], "status": "rejected", "ban_author": true}

Good to know (from YouTube):

  • A rejected comment can never be published again.
  • Rejecting a comment also hides its replies.
  • Only the channel that owns the video can moderate its comments.

Not available in YouTube's API: pinning or hearting a comment, and marking it as spam.

Daily allowance​

Reading a page costs 1 YouTube quota unit; replying, commenting, editing, deleting and moderating cost 50 units per call (moderating up to 50 comments is a single call). They count towards the YouTube daily allowance of your Upload-Post account, described in video details. Uploads are never affected.

Errors​

Same shape as the rest of the YouTube endpoints (success: false, error, error_code, plus youtube_status and youtube_reason when they come from YouTube):

  • 400 — invalid_filter, invalid_scope, invalid_video_id, invalid_comment_id, too_many_ids, invalid_moderation_status, invalid_order, invalid_text_format, invalid_search, invalid_include_replies, invalid_max_results, invalid_target, missing_text, invalid_field (the text is not a string), text_too_long, invalid_idempotency_key, missing_comment_ids, invalid_ban_author, ban_requires_reject, confirmation_required, invalid_json, youtube_invalid_page_token; or YouTube rejected the call.
  • 401 — youtube_reauth_required: reconnect the channel.
  • 403 — youtube_comments_disabled (comments are off on that video), youtube_insufficient_scope, youtube_forbidden.
  • 404 — youtube_comment_not_found, youtube_video_not_found.
  • 409 — youtube_duplicate_request: a request with this idempotency_key was already sent and its result is not confirmed yet.
  • 429 — daily allowance or YouTube quota used up (retry_after, resets_at).
  • 502 — youtube_write_outcome_unknown: YouTube did not confirm the result in time, so the action may or may not have been applied. List the comments to check before retrying; it is never resent automatically. youtube_unreachable / youtube_upstream_error: YouTube could not be reached or failed; retry later.
  • 503 — youtube_feature_disabled: YouTube management features are temporarily off on Upload-Post. Uploads keep working.