Comments with the TypeScript SDK ​

The comments resource reads comments that people leave on your published posts and replies to them as the connected account. It needs the Team or Agency plan. Supported platforms are YouTube, Bluesky, Reddit and Mastodon.

Methods ​

How do I list comments? ​

const { results, total, supportedPlatforms } = await socifyr.comments.list({
  status: 'open',                 // 'open' (default) | 'done' | 'all'
  platform: 'youtube',            // optional
  connection: 'youtube-mybrand',  // optional slug
  limit: 50,                      // 1 to 100, default 25
})

for (const c of results) {
  console.log(`${c.platform} ${c.author.name}: ${c.text}`)
}

CommentListParams also takes postId (a Socifyr post ID) and page. Your own replies are not included. supportedPlatforms lists the platforms the inbox reads.

Each result is a Comment:

How do I fetch new comments now? ​

Comments sync every 30 minutes. To queue a sync now:

const { queued } = await socifyr.comments.sync() // true
await new Promise((r) => setTimeout(r, 15_000))
const { results } = await socifyr.comments.list()

The API answers 202 with { queued: true } (CommentSyncResult) and the sync runs in the background, so list comments again after a short wait. A sync checks up to 50 posts published in the last 30 days. It is limited to 3 calls per minute.

YouTube comment sync runs on a daily quota budget: a post is only re-read when its comment count changed, or on an age-based backoff. New YouTube comments can take a while to appear.

Comments older than 60 days are removed, and comments deleted on the platform disappear on the next full sync. Disconnecting an account or deleting a workspace deletes its stored comments.

How do I reply to a comment? ​

const reply = await socifyr.comments.reply(comment.id, {
  text: 'Thanks! Part two is out next week.',
})
console.log(reply.url)

text is 1 to 5000 characters, and must fit the platform's own limit (300 graphemes on Bluesky; on Mastodon the @mention of the author counts). The reply is public as soon as it returns and cannot be edited from Socifyr. The original comment is marked done.

How do I mark a comment done? ​

await socifyr.comments.markDone(comment.id)   // no reply needed
await socifyr.comments.reopen(comment.id)     // back to open

Example: answer open questions ​

const { results } = await socifyr.comments.list({ status: 'open' })

for (const c of results) {
  if (c.text.trim().endsWith('?')) {
    await socifyr.comments.reply(c.id, { text: `Thanks ${c.author.name}, we'll answer in our next video.` })
  } else {
    await socifyr.comments.markDone(c.id)
  }
}

What errors should I handle? ​

The plan error message is The comments inbox is not available on your current plan. Upgrade to Team or Agency to continue. See Errors.

Next steps ​

• Comments API
• Method reference
• Comments inbox in the dashboard