This tool is part of the Comments Tools category.

Parameters

NameTypeRequiredDescription
user_account_idstringYesThe ID of the user account to get comments for
limitnumberNoMaximum number of comments to return (default: 20)

Example Request

{
  "user_account_id": "user_acc_12345678",
  "limit": 5
}

Example Response

[
  {
    "id": "comment_12345678",
    "platform_account_id": "platform_acc_123",
    "platform_account_comment_id": "platform_comment_123",
    "platform_account_content_id": "platform_content_123",
    "content_id": "content_123",
    "user_platform": "YOUTUBE",
    "text": "Great content! Looking forward to more videos.",
    "author_username": "UserOne",
    "author_display_name": "User One",
    "author_profile_url": "https://platform.com/users/userone",
    "author_image_url": "https://platform.com/users/userone/profile.jpg",
    "like_count": 25,
    "reply_count": 2,
    "parent_id": null,
    "published_at": "2023-06-15T10:30:00.000Z",
    "user_account_id": "user_acc_12345678"
  },
  {
    "id": "comment_23456789",
    "platform_account_id": "platform_acc_123",
    "platform_account_comment_id": "platform_comment_456",
    "platform_account_content_id": "platform_content_456",
    "content_id": "content_456",
    "user_platform": "YOUTUBE",
    "text": "This information was really helpful!",
    "author_username": "UserTwo",
    "author_display_name": "User Two",
    "author_profile_url": "https://platform.com/users/usertwo",
    "author_image_url": "https://platform.com/users/usertwo/profile.jpg",
    "like_count": 15,
    "reply_count": 0,
    "parent_id": null,
    "published_at": "2023-06-14T16:45:00.000Z",
    "user_account_id": "user_acc_12345678"
  },
  {
    "id": "comment_34567890",
    "platform_account_id": "platform_acc_123",
    "platform_account_comment_id": "platform_comment_789",
    "platform_account_content_id": "platform_content_456",
    "content_id": "content_456",
    "user_platform": "YOUTUBE",
    "text": "I have a question about this topic. Can you explain more?",
    "author_username": "UserThree",
    "author_display_name": "User Three",
    "author_profile_url": "https://platform.com/users/userthree",
    "author_image_url": "https://platform.com/users/userthree/profile.jpg",
    "like_count": 5,
    "reply_count": 1,
    "parent_id": null,
    "published_at": "2023-06-14T09:20:00.000Z",
    "user_account_id": "user_acc_12345678"
  }
]

Usage Notes

  • Comments are returned in reverse chronological order (newest first).
  • By default, the limit is set to 20 comments, but you can specify a different value.
  • This tool is useful for monitoring recent engagement across all your content.
  • The response includes full comment objects with all available metadata.
  • Like and reply counts are returned as numerical values.
  • This endpoint is optimized for retrieving the most recent comments, regardless of which content they belong to.
  • The response includes both comments on content and content groups.
  • Comment replies are included in the results.

Error Responses

  • 404 Not Found: Returned when the user account with the specified ID doesn’t exist.
  • 500 Internal Server Error: Returned when there’s a server-side error processing the request.