> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapti.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Comments

> Retrieves all comments for a specific content item. This tool allows you to access user comments, replies, and associated metadata for social media and content platform posts.

<Info>
  This tool is part of the [Comment Tools](./index) category.
</Info>

## Parameters

| Name        | Type   | Required | Description                                         |
| ----------- | ------ | -------- | --------------------------------------------------- |
| content\_id | string | Yes      | The ID of the content item to retrieve comments for |

## Example Request

```json theme={null}
{
  "content_id": "cont_12345678"
}
```

## Example Response

```json theme={null}
[
  {
    "id": "comm_12345678",
    "content_id": "cont_12345678",
    "platform": "YOUTUBE",
    "platform_comment_id": "yt_comment_abc123",
    "user": {
      "platform_user_id": "yt_user_def456",
      "username": "ViewerName",
      "display_name": "Viewer Name",
      "profile_picture_url": "https://example.com/profile.jpg"
    },
    "text": "This is a great tutorial! I learned a lot about content management.",
    "parent_id": null,
    "likes_count": 42,
    "replies_count": 3,
    "published_at": "2023-06-16T09:45:00.000Z",
    "created_at": "2023-06-16T09:45:00.000Z",
    "updated_at": "2023-06-16T09:45:00.000Z",
    "last_refreshed_at": "2023-06-20T14:15:00.000Z"
  },
  {
    "id": "comm_23456789",
    "content_id": "cont_12345678",
    "platform": "YOUTUBE",
    "platform_comment_id": "yt_comment_ghi789",
    "user": {
      "platform_user_id": "yt_user_jkl012",
      "username": "AnotherUser",
      "display_name": "Another User",
      "profile_picture_url": "https://example.com/profile2.jpg"
    },
    "text": "Could you explain the part about OAuth in more detail?",
    "parent_id": null,
    "likes_count": 5,
    "replies_count": 1,
    "published_at": "2023-06-17T11:30:00.000Z",
    "created_at": "2023-06-17T11:30:00.000Z",
    "updated_at": "2023-06-17T11:30:00.000Z",
    "last_refreshed_at": "2023-06-20T14:15:00.000Z"
  },
  {
    "id": "comm_34567890",
    "content_id": "cont_12345678",
    "platform": "YOUTUBE",
    "platform_comment_id": "yt_comment_mno345",
    "user": {
      "platform_user_id": "yt_user_def456",
      "username": "ContentCreator",
      "display_name": "Content Creator",
      "profile_picture_url": "https://example.com/profile3.jpg"
    },
    "text": "Thanks for watching! I'll cover OAuth in more detail in a future video.",
    "parent_id": "comm_23456789",
    "likes_count": 3,
    "replies_count": 0,
    "published_at": "2023-06-17T14:15:00.000Z",
    "created_at": "2023-06-17T14:15:00.000Z",
    "updated_at": "2023-06-17T14:15:00.000Z",
    "last_refreshed_at": "2023-06-20T14:15:00.000Z"
  }
]
```

## Usage Notes

* The response is an array of comment objects for the specified content item.
* Comments are typically returned in chronological order, but this may vary by platform.
* Top-level comments have `parent_id: null`, while replies have the ID of the parent comment.
* The `user` object contains information about the commenter as provided by the platform.
* Comment counts (likes, replies) are included when available from the platform.
* For the most up-to-date comments, consider using [Refresh Comments](./refreshComments) before retrieving them.
* Some platforms may have limitations on the number of comments and replies returned.
* If the content item has no comments, an empty array will be returned.
* If the content item does not exist, a `404 Not Found` error will be returned.

## Platform-Specific Notes

* **YouTube**: Provides detailed comment data including likes, replies, and user information.
* **Instagram**: May include comment data but might not expose all engagement metrics.
* **Facebook**: Provides comment data with reactions and reply counts.
* **TikTok**: Provides comment data including likes and reply counts.
* **LinkedIn**: Comment data may be more limited compared to other platforms.

## Related Tools

* [Get Comment](./getComment) - Retrieve a specific comment by ID
* [Get Recent Comments](./getRecentComments) - Get recent comments for a user account
* [Publish Comment](./publishComment) - Post a new comment on content
* [Get Content By ID](../content/getContentById) - Get information about the content item