Tool to retrieve comment threads from YouTube videos or channels matching API request parameters. Use when you need to fetch comments with filtering by video, channel, or specific thread IDs.
idstringComma-separated list of comment thread IDs to retrieve. Use this to fetch specific comment threads by their IDs. Mutually exclusive with 'allThreadsRelatedToChannelId', 'channelId', and 'videoId'.
partRequiredstringComma-separated list of commentThread resource properties to include in the API response. Valid values: 'id' (thread ID only), 'snippet' (top-level comment metadata including authorDisplayName, textDisplay, likeCount, publishedAt), 'replies' (up to 5 reply comments if present).…
orderstringSorting order for comment threads. 'time' returns newest first (default), 'relevance' returns most relevant first based on popularity and engagement.
videoIdstringReturns comment threads associated with the specified video ID. This is the most common use case for retrieving comments on a specific video. Mutually exclusive with 'allThreadsRelatedToChannelId', 'channelId', and 'id'.
channelIdstringReturns comment threads for the specified channel ID. This retrieves comments about the channel itself, not comments on the channel's videos. Mutually exclusive with 'allThreadsRelatedToChannelId', 'videoId', and 'id'.
pageTokenstringToken for pagination. Use the 'nextPageToken' value from a previous response to retrieve the next page of results.
maxResultsintegerMaximum number of comment threads to return per page. Must be between 1 and 100. Default is 20 if not specified.
textFormatstringFormat for text fields in the response. 'html' preserves HTML formatting (default), 'plainText' returns plain text without formatting.
searchTermsstringFilter comment threads to only those matching the search query. Only works with 'allThreadsRelatedToChannelId' parameter and cannot be used with other filter parameters.
moderationStatusstringFilter comment threads by moderation status. Only valid for comments on channel's own videos when authorized as the channel owner. 'heldForReview' shows comments held for review, 'likelySpam' shows comments marked as likely spam, 'published' shows published comments.
allThreadsRelatedToChannelIdstringReturns all comment threads associated with the specified channel ID. This includes comments on the channel page itself, not video comments. Mutually exclusive with 'channelId', 'videoId', and 'id'. Requires OAuth authorization.
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
OAuth connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.