> For the complete documentation index, see [llms.txt](https://help.blotato.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blotato.com/start-with-an-ai-agent/llm/comments.md).

# Comment requests

Compact reference for agents making REST requests. All endpoint paths below are relative to `https://backend.blotato.com/v2`. For task instructions, read the [workflow guide](/agent-workflows/agent-workflows/comments.md). For tool calls, use the [MCP reference](/start-with-an-ai-agent/mcp/tools.md).

## Manage comments

```
Comments are public comments your audience leaves on your published posts, plus
comments you post back through Blotato.

Supported platforms: instagram, facebook

Notes:
- Blotato does not backfill comments. It captures new comments received after the account connects with the required permissions.
- For an Instagram post published outside Blotato, a new comment creates the post record shown in the Inbox.
- Test Instagram capture with a new top-level comment from another account. A reply to an older comment is not a valid test.
- Refresh the Inbox after the new comment arrives.
- Comments are retained for up to 45 days.
- Lists and posts top-level comments and one level of replies (no reply to a reply).

List comments:
GET /comments?limit=20&cursor=OPTIONAL_CURSOR&accountId=OPTIONAL_ACCOUNT_ID&postId=OPTIONAL_POST_ID&since=ISO_8601&until=ISO_8601
Response: { "items": [ <Comment>, ... ], "cursor": "..." }

Post a comment:
POST /comments
{
  "postId": "id-of-post-to-leave-comment-on",
  "text": "Comment text",
  "parentCommentId": "optional-id-of-comment-to-reply-to"
}
Response: a <Comment> object with status "queued"

PLATFORM-SPECIFIC FIELDS:

instagram:
  text limit: 2200 characters
facebook:
  text limit: 8000 characters
  comments post to your Facebook Page posts

Poll: GET /comments/:commentId
Status values: "queued" | "processing" | "posted" | "failed" | "deleted"
- posted: live on the platform
- failed: response includes errorMessage and errorCode

<Comment>:
{
  "id": "cmt_abc123",
  "accountId": "98434",
  "platform": "instagram",
  "postId": "post_xyz789",               // null if not published through Blotato
  "parentCommentId": null,               // set when this comment is a reply
  "platformPostId": "17851234567890",
  "platformCommentId": "17899876543210", // null until posted
  "authorId": "1784000000",              // null if unknown
  "isAuthor": false,                     // true = you authored it, false = audience
  "text": "Love this!",
  "status": "posted",
  "errorCode": null,
  "errorMessage": null,
  "createdAt": "2026-07-01T12:34:56Z"
}

NOTE: Replying to a new audience member counts toward the monthly active-contacts limit
(starter 1,000 / creator 6,000 / agency 15,000).
```

Return to the [agent reference index](/start-with-an-ai-agent/llm.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.blotato.com/start-with-an-ai-agent/llm/comments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.