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.
| Name | Type | Required | Description |
|---|---|---|---|
user | String | Yes | Profile username with a YouTube channel connected. |
video_id | String | One of | Threads of one video. |
scope | String | One of | channel: the inbox of the whole channel (every video). |
ids | String | One of | Up to 50 comment thread IDs, comma separated. |
moderation_status | String | No | published (default), heldForReview or likelySpam. Only for your own channel's videos. |
order | String | No | time (default) or relevance. |
search | String | No | Only threads whose comments contain this text (up to 200 characters). |
text_format | String | No | html (default) or plainText. |
include_replies | Boolean | No | Also return the replies YouTube includes with each thread (a partial list; use replies for all of them). |
max_results | Integer | No | 1-100 (YouTube's default is 20). |
page_token | String | No | The 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
| Name | Type | Required | Description |
|---|---|---|---|
user | String | Yes | Profile username. |
parent_id | String | One of | ID of a top-level comment: returns its replies. |
ids | String | One of | Up to 50 comment IDs, comma separated. |
text_format | String | No | html (default) or plainText. |
max_results | Integer | No | 1-100, not with ids. |
page_token | String | No | Not with ids. |
Items are YouTube's comment resources.
Reply or comment
POST /api/uploadposts/youtube/comments
| Name | Type | Required | Description |
|---|---|---|---|
user | String | Yes | Profile username. |
parent_id | String | One of | Reply to this top-level comment. |
video_id | String | One of | Post a new top-level comment on this video. |
text | String | Yes | The comment (message also works). Must be a string. |
idempotency_key | String | No | Your 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
| Name | Type | Required | Description |
|---|---|---|---|
user | String | Yes | Profile username. |
comment_ids | String or array | Yes | Up to 50 comment IDs of your channel, applied in one call. |
status | String | Yes | published (approve), heldForReview (hold) or rejected (remove from public view). |
ban_author | Boolean | No | With status=rejected: also reject every future comment of those authors on your channel. |
confirm | Boolean | With rejected | Must 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 thisidempotency_keywas 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.