Comment Threads

This query allows you to retrieve comment threads for YouTube videos or channels. You can search for comments on specific videos, filter by keywords, and customize the order of results.

Parameters

Video(s) ID

The unique identifier of the video for which you want to retrieve comment threads.

• Example: -vsCJpEnszYs
• This parameter is required.
• Enter a single video ID.

Tip: How can I find the video ID of a YouTube video?

Channel ID

The unique identifier of the channel for which you want to retrieve comment threads.

• This parameter is optional.
• Enter a single channel ID.

Maximum Results

Specifies the maximum number of results to return. The API natively supports 50 results for this type of query.

Note: Pagination allows Tube2Sheet to retrieve more than the 50 results natively supported by the YouTube API for this query type. When you request more than 50 results, Tube2Sheet automatically makes multiple API calls, each retrieving up to 50 results, to fulfill your request. Each of these calls counts separately against your monthly request quota, so requesting 500 results would use 10 requests from your quota.

Tip: Learn more about pagination

Order

Determines the order of the returned comment threads.

• Options:
  • Time (default)
  • Relevance
  • Held for Review
• This parameter is optional.

Search Terms

Filter comments by specific keywords.

• This parameter is optional.

Text Format

Specify the format of the returned comment text.

• Options:
  • HTML
  • Plain Text
• This parameter is optional and advanced.

Columns

The data returned from this query can be customized using various output columns. Columns are categorized into basic columns and advanced columns.

Note: Advanced columns are marked with the icon.

Basic Columns

These columns are included by default in the output:

• Comment Thread ID: The unique identifier for the comment thread.
• Comment Thread Text Display: The text content of the top-level comment.
• Comment Thread Author Name: The display name of the comment author.
• Comment Thread Like Count: The number of likes for the top-level comment.
• Total Reply Count: The total number of replies to the top-level comment.

Advanced Columns

These columns provide additional details and are available for more in-depth data analysis:

• eTag: Entity tag for the resource.
• Content kind: The type of resource, typically "youtube#commentThread".
• Channel ID: The ID of the channel associated with the comment thread.
• Video ID: The ID of the video associated with the comment thread.
• Comment Thread Kind: The kind of resource for the top-level comment.
• Comment Thread eTag: Entity tag for the top-level comment.
• Comment Thread Channel ID: The channel ID associated with the top-level comment.
• Comment Thread Video ID: The video ID associated with the top-level comment.
• Comment Thread Text Original: The original text of the top-level comment.
• Comment Thread Profile Image URL: The URL of the author's profile image.
• Comment Thread Channel URL: The URL of the author's YouTube channel.
• Comment Thread ID: The unique identifier for the author's channel.
• Comment Thread Can Rate: Indicates if the comment can be rated.
• Comment Thread Viewer Rating: The viewer's rating of the comment.
• Comment Thread Published At: The date and time when the comment was published.
• Can reply: Indicates if replies can be added to the comment thread.
• Is public: Indicates if the comment thread is public.

API Details

• Resource: CommentThreads
• Method: list
• Part: snippet,replies

For more information about the YouTube Data API and its capabilities, please refer to the official documentation.

---

For additional help, visit our FAQ or Troubleshooting sections.