The social media comments API.Every network's comments, one shape.
Breakreach's comments API returns the recent comments on your Instagram, Facebook and Threads posts, the replies to your X posts and the reviews of your Google Business Profile locations, in one list with one shape, and POST /v1/comments/reply answers any of them. It reads posts made outside Breakreach too, and comments are read live from each network.
Checked against the API code on October 12, 2026. Breakreach is our product.


Is Morning Light good as an espresso?
northbeam.coffeeRepliedIt is! Pull it a little longer, 30 seconds.

The bag design is so good
Comments API endpoints5 endpoints, one API key.
- GET
/v1/commentsRecent comments, newest first, on the latest 10 posts of each account; filter by platform or accountId - GET
/v1/posts/:id/commentsLive comments on one post published with Breakreach, on every network it went to - POST
/v1/comments/replyReply to a comment as the account, or answer a Google review - DELETE
/v1/comments/:commentIdDelete a comment on Instagram or Facebook, or your reply to a Google review - GET
/v1/post-insightsOne post's metrics with its comments, for posts made outside Breakreach too
Base URL https://api.breakreach.com. Every call sends your key as Authorization: Bearer br_…; errors answer { "error": "…" } with a 4xx or 5xx status. Every parameter is in the OpenAPI spec.
What POST /v1/comments/reply takes
| Field | Type | What it does |
|---|---|---|
accountId | string, required | The account that owns the post, from the comment |
platform | string, required | instagram, facebook, threads, x or googlebusiness |
commentId | string, required | The comment's id, from either list; for a Google review, the review's id |
message | string, required | The reply text; up to 4,096 bytes for a Google review |
workspace | string | Workspace slug; your first workspace when left out |
Which networks it coversChecked against the code, not a feature list.
| Network | Read | Reply | Hide (MCP) | Delete |
|---|---|---|---|---|
| Yes, Latest 10 posts, any origin | Yes | Yes | Yes | |
| Yes, Latest 10 posts, any origin | Yes | Yes | Yes | |
| Yes, Latest 10 posts, any origin | Yes | Yes | No | |
| Yes, Replies to posts made with Breakreach | Yes | No | No | |
| Yes, Latest 50 reviews per location, with stars | Yes, Checked by Google before it shows | No | Your reply only | |
| Waiting on Google's approval | Waiting | No | No | |
| No | No | No | No |
Which comments does the API read?Your latest posts, made with Breakreach or not.
GET /v1/comments looks at the latest 10 posts of every connected Instagram, Facebook and Threads account, including posts published in the network's own app, and returns their comments newest first. Replies to a comment are nested under it. On X it reads the replies to posts published through Breakreach only, because reading a whole X timeline costs API credits on X's side.
It also returns the latest 50 reviews of every connected Google Business Profile location, as comments on the location: each one carries its rating from 1 to 5, the business's reply is nested under it, and ratings gives each location's average and review count. A review with no reply hasn't been answered yet.
Each comment carries what you need to answer it (id, accountId, platform), plus the post's text, link and image so a person or an agent knows what the comment is about. Filter with platform or accountId.
For one post, GET /v1/posts/:id/comments reads the comments live on every network the post went to. GET /v1/post-insights returns a post's comments next to its metrics, for any post on a connected account.
Are comments stored or read live?
Read live from each network on every call, so a deleted comment disappears and a new one shows at once. Nothing is cached on Breakreach's side.
When one account fails (an expired token, a permission the network withdrew), the others still answer: the failure comes back in errors with the account and the reason, instead of failing the whole call.
Can I hide or delete comments?
Hiding keeps a comment from the public without deleting it, and it can be undone: Instagram, Facebook and Threads support it, through the MCP tool hide_comment. Deleting is permanent and works on Instagram and Facebook, with DELETE /v1/comments/:commentId or the MCP tool delete_comment, so an agent in Claude Code or OpenClaw can clear spam on request.
On Google, a business can't delete or hide a review. The same DELETE removes your reply to it instead, and the review shows as unanswered again.
What are the rules for replying?
- InstagramReplies thread under the comment. Instagram's API only reaches professional accounts, which is what Breakreach connects.
- FacebookReplies post as the Page.
- ThreadsReplies post as the profile, under the reply you answer.
- XReplies post as a reply to the reply, from your account.
- Google Business ProfileA review takes one reply from the business, up to 4,096 bytes, so replying again replaces it. Google checks each reply before it shows: the reply comes back with
statuspending, then approved or rejected. Reviews of a location Google hasn't verified can't be read or answered.
Keep replies human. Every network limits automated replies in its own terms, and a reply posted through the API is public under your name like any other.
What does the comments API cost?
The Developer plan costs $5 a month per connected account up to 20, $3 from 21 to 100 and $2 after that, never per call or per post. The API also comes with every regular plan, from Starter at $29 a month for 5 accounts. Comment reads and replies aren't counted.
Agents get the same calls.As MCP tools, no code to write.
Comments are where an agent saves the most time: “answer the questions in today's comments and hide the spam” is one sentence in Claude Code or OpenClaw, and the agent shows you its replies first if you ask it to.
list_recent_comments“Any new comments today?” across every account, Google reviews includedget_post_commentsThe comments on one postreply_to_commentAnswers as the account, or replies to a Google reviewhide_commentHides or unhides (Instagram, Facebook, Threads)delete_commentDeletes for good (Instagram, Facebook), or your reply to a Google review
What the comments API doesn't do yetSo you know before you build.
- TikTok, LinkedIn, Pinterest, Bluesky and Reddit comments
- YouTube comments, until Google approves the permission
- Deleting a Google review: Google doesn't let a business do it
- Webhooks for new comments: poll
GET /v1/comments - Liking a comment
The rest of the API (webhooks, workspaces per customer, connect links for your users, the price per connected account) is on the developers page.
The rest of the API
Questions, answered.
Short answers about the Comments API.
Breakreach reads Instagram, Facebook and Threads comments on your latest posts, the replies to your X posts and your Google Business Profile reviews in one call, with one shape. TikTok, LinkedIn, Pinterest, Bluesky and Reddit comments aren't available.
Yes on Instagram, Facebook and Threads: it reads the latest 10 posts of each account, whatever published them. On X it reads replies to posts made with Breakreach.
Yes. POST /v1/comments/reply with the accountId, platform, commentId and message posts the reply as your professional account, threaded under the comment.
Yes. GET /v1/comments?platform=googlebusiness lists the latest 50 reviews of each connected location with their stars, and POST /v1/comments/reply with the review's id posts the business's reply, up to 4,096 bytes. Google checks the reply before it shows. Only verified locations work.
Not yet. Poll GET /v1/comments, which is read live, on the schedule you need.
Yes, through the MCP server: list_recent_comments, reply_to_comment, hide_comment and delete_comment. Hiding is reversible, deleting isn't.
Your first call is five minutes away.From $5 a month per account.
Billed per connected account. Cancel anytime.