Comments

Read and reply to conversations on your connected accounts.

Check account capabilities

Read account.capabilities.comments before displaying comment controls. Instagram professional accounts, Facebook Pages, and YouTube channels can support comments when the required access was granted. TikTok comment management is not available through the public Content Posting API.

List comments

Pass the Castrook account and post IDs. The destination must have been published successfully.

curl 'https://castrook.com/api/v1/comments?account_id=acc_example&post_id=pst_example' \
  -H "Authorization: Bearer $CASTROOK_API_KEY"

{
  "data": [
    {
      "id": "platform_comment_id",
      "text": "When is the collection available?",
      "author": "studio.follower",
      "created_at": "2026-09-26T12:00:00.000Z",
      "account_id": "acc_example",
      "post_id": "pst_example"
    }
  ],
  "meta": { "next_cursor": null, "has_more": false }
}

Reply to a comment

const { data: reply } = await castrook.comments.reply({
  account_id: 'acc_example',
  post_id: 'pst_example',
  comment_id: 'platform_comment_id',
  text: 'The collection launches this Friday.',
});

V1 boundaries

This release lists top-level comments and sends replies. Deleting, hiding, liking, DMs, and a cross-platform comment search are outside the API. Comment availability also depends on the post’s privacy and moderation settings.