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.

This tool is part of the Comment Tools category.

Parameters

Name	Type	Required	Description
content_id	string	Yes	The ID of the content item to retrieve comments for

Example Request

{
  "content_id": "cont_12345678"
}

Example Response

[
  {
    "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 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 - Retrieve a specific comment by ID
• Get Recent Comments - Get recent comments for a user account
• Publish Comment - Post a new comment on content
• Get Content By ID - Get information about the content item