This tool is part of the Comment Tools category.

​
Parameters

NameTypeRequiredDescription
content_idstringYesThe 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.