List Comment Threads
youtube.list_comment_threads
ActionChat & messagingconnection required
Calls youtube v3 GET /youtube/v3/commentThreads.
Retrieves a list of resources, possibly filtered.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- YouTube
- Secret shape
- {"client_id", "client_secret", "refresh_token"}
- Resolved by
- config.connection_id, else node.connection_id
Configuration
11 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
part The *part* parameter specifies a comma-separated list of one or more commentThread resource properties that the API response will include. Required. | string | Yes | — | — | — |
max_results Max results, 1-100. Optional; default 20. | integer | No | — | 1–100 | — |
page_token The previous response's nextPageToken; blank = first page. | string | No | — | — | — |
video_id Returns the comment threads of the specified video. Optional. | string | No | — | — | — |
channel_id Returns the comment threads for all the channel comments (ie does not include comments left on videos). Optional. | string | No | — | — | — |
id Returns the comment threads with the given IDs for Stubby or Apiary. Optional. | string | No | — | — | — |
all_threads_related_to_channel_id Returns the comment threads of all videos of the channel and the channel comments as well. Optional. | string | No | — | — | — |
order Order — YouTube accepts only the listed values. | string | No | — | one of "orderUnspecified", "time", "relevance" | — |
search_terms Limits the returned comment threads to those matching the specified key words. Optional. | string | No | — | — | — |
text_format The requested text format for the returned comments. Optional. | string | No | — | one of "textFormatUnspecified", "html", "plainText" | — |
moderation_status Limits the returned comment threads to those with the specified moderation status. Optional. | string | No | — | one of "published", "heldForReview", "likelySpam", "rejected" | — |
- At least one of video_id, channel_id, id, all_threads_related_to_channel_id must be set.
Output
One shape.
result
Extra keys beyond the ones listed can appear.
| Field | Type | Example |
|---|---|---|
etag | string | — |
eventId | string | — |
items | array | — |
kind | string | — |
nextPageToken | string | — |
pageInfo | object | — |
tokenPagination | object | — |
visitorId | string | — |
{
"etag": "",
"eventId": "",
"items": [],
"kind": "",
"nextPageToken": "",
"pageInfo": {},
"tokenPagination": {},
"visitorId": ""
}Related YouTube nodes
See List Comment Threads run in a workflow.
In a technical demo we add the YouTube connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.