Skip to content

socifyr comments ​

socifyr comments works with the comments inbox: comments that people leave on your published posts. It needs the Team or Agency plan. Supported platforms are YouTube, Bluesky, Reddit and Mastodon.

bash
socifyr comments [list] [--status open|done|all] [--platform <name>] [--connection <slug>] [--post <id>] [--limit <n>] [--page <n>] [--json]
socifyr comments sync [--json]
socifyr comments reply <id> <text> [--json]
socifyr comments done <id> [--json]
socifyr comments reopen <id> [--json]

How do I list comments? ​

socifyr comments and socifyr comments list are the same command.

FlagDescriptionDefault
--status <status>open, done or allopen
--platform <platform>Only this platform, for example youtubeall
--connection <slug>Only this account, for example youtube-mybrandall
--post <id>Only comments on this Socifyr postall
--limit <n>Results per page, 1 to 10025
--page <n>Page number1
--jsonPrint JSONoff
bash
socifyr comments --platform youtube
Comments · Open · 2 total

  Platform   Connection               Author             Comment                                                 Age  ID
  youtube    youtube-mybrand          @janedoe           Great video! Is there a follow-up coming?                3h  6a1f0c2a9d3e4f5a6b7c8d01
  youtube    youtube-mybrand          @sam               Which mic do you use?                                    1d  6a1f0c2a9d3e4f5a6b7c8d03

  Reply: socifyr comments reply <id> "text"   Resolve: socifyr comments done <id>

Text is cut to one line. Age is minutes, hours or days, then the date after 30 days. Done comments show a ✓ after the ID. Your own replies are not listed. --json prints the full API response, including supportedPlatforms.

An invalid --status, --limit or --page prints an error and exits with 1.

How do I fetch new comments now? ​

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

bash
socifyr comments sync
✓ Sync started — new comments will appear shortly
  Run socifyr comments in a minute to see them. YouTube comments can take longer (its sync is budgeted).

The sync runs in the background, so run socifyr comments again after a short wait. --json prints the API response as-is: { "queued": true }. The API allows 3 syncs 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.

How do I reply to a comment? ​

bash
socifyr comments reply 6a1f0c2a9d3e4f5a6b7c8d01 "Thanks Jane! Part two is out next week."
✓ Replied on youtube
  URL: https://www.youtube.com/watch?v=dQw4w9WgXcQ&lc=UgxKz3m2Qv8bT9.9xYz

The reply is posted as the connected account and is public right away. The comment is marked done. Text can be 1 to 5000 characters, and must fit the platform's own limit (300 graphemes on Bluesky; on Mastodon the @mention of the author counts). Quote it so the shell keeps it as one argument; unquoted words are joined with spaces.

How do I mark a comment done? ​

bash
socifyr comments done 6a1f0c2a9d3e4f5a6b7c8d03
# ✓ Marked 6a1f0c2a9d3e4f5a6b7c8d03 done

socifyr comments reopen 6a1f0c2a9d3e4f5a6b7c8d03
# ✓ Reopened 6a1f0c2a9d3e4f5a6b7c8d03

What errors can I get? ​

MessageCause
The comments inbox is not available on your current plan. Upgrade to Team or Agency to continue.Free or Creator plan
Comment not foundThe ID is not in this workspace
Could not reply on <platform>: ...The platform refused the reply
Reply is too long for <platform>: N of M charactersThe reply is over the platform's limit
A reply to this comment is already being sentAnother reply to the same comment is in flight (409)
<platform> is rate limiting replies right now — try again later or Rate limit exceeded. Retry after 60sThe platform or the API is rate limiting (429)
Connection "<slug>" not found--connection does not match an active (not disconnected) account
This API key has guardrails and cannot call this endpoint ...A guarded key can only list comments

Next steps ​