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, YouTube channels and LinkedIn profiles/Pages can support comments when the required access was granted. LinkedIn comments require Community Management permissions; self-service sharing alone does not grant comment reads. Pinterest organic comment management is unsupported, and TikTok comment management is unavailable 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.',
});

Authorization and freshness

YouTube comments require an active channel connection and a current video record. Castrook refreshes records for connected channels, including older posts. If access is revoked, the video is deleted, or its record cannot be refreshed before expiry, comment access stops. Reconnecting restores channel access; it does not restore data previously removed. Private videos and disabled comments can also prevent replies.

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.