Comments

Blotato allows you to read and post comments on your published Instagram posts. Twitter/X, TikTok, Pinterest, Threads, Bluesky, and YouTube are not supported at this time. Three endpoints let you list, read, and post comments:

• List Comments — GET /v2/comments

• Get Comment — GET /v2/comments/:commentId

• Post Comment — POST /v2/comments

Comments are available on all plans.

Blotato does not backfill comments. It starts capturing comments once your account has comments enabled and you connect or reconnect your account. Comments left before then do not appear in these endpoints.

Blotato retains comments for up to 45 days. Comments older than 45 days are not available through these endpoints.

The /comments endpoints cover two directions:

• Inbound comments your audience leaves on your posts. These have isAuthor: false.

• Outbound comments you post through Blotato. These have isAuthor: true.

The comments API lists and posts top-level comments and one level of replies. You can reply to a top-level comment on your post, but you cannot reply to a reply.

Before You Start

Blotato must have permissions to read and post comments on your account before you can use the Blotato comments endpoints.

If you connected your account before comments launched, reconnect it so Blotato has the new permission.

• For Instagram, see Connect Instagram.

---

List Comments

Endpoint

Base URL: https://backend.blotato.com/v2

URL: /comments

Method: GET

Description

Returns your comments across connected accounts, ordered by creation time (most recent first). Use cursor-based pagination and the optional filters below.

Query Parameters

Field	Type	Required	Description
limit	integer	No	Maximum comments to return (1-250). Default 50.
cursor	string	No	Cursor from a previous response. Pass it to fetch the next page.
platform	array	No	Filter by platform. Value: instagram.
accountId	string	No	Filter to a single connected account.
parentCommentId	string	No	Filter to direct replies to a single comment.
postId	string	No	Filter to comments on a single Blotato-published post.
since	string	No	Only include comments created on or after this ISO 8601 timestamp.
until	string	No	Only include comments created on or before this ISO 8601 timestamp.

Response

Status Code: 200 OK

{
  "items": [
    {
      "id": "cmt_abc123",
      "accountId": "98434",
      "platform": "instagram",
      "postId": "post_xyz789",
      "platformPostId": "17851234567890",
      "platformCommentId": "17899876543210",
      "authorId": "1784000000",
      "isAuthor": false,
      "text": "Love this!",
      "status": "posted",
      "errorCode": null,
      "errorMessage": null,
      "createdAt": "2026-07-01T12:34:56Z"
    }
  ],
  "cursor": "eyJz..."
}

Field	Type	Description
items	array	List of comments. See Comment Object.
cursor	string	Cursor for the next page. Absent when there are no more comments.

---

Get Comment

Endpoint

URL: /comments/:commentId

Method: GET

Description

Fetches a single comment by its Blotato ID. The comment is an inbound reply from your audience or an outbound comment you posted through Blotato.

Path Parameters

Field	Type	Required	Description
commentId	string	Yes	Blotato ID of the comment.

Response

Status Code: 200 OK

Returns a Comment Object.

---

Post Comment

Endpoint

URL: /comments

Method: POST

Description

Posts a comment on one of your published posts, or a reply to an existing top-level comment when you pass parentCommentId. Blotato queues the comment and posts it in the background, so the response returns status queued. Poll Get Comment with the returned id to confirm the comment reached posted or failed.

Request Body

{
  "postId": "post_xyz789",
  "text": "Thanks everyone!"
}

Field	Type	Required	Description
postId	string	Yes	Blotato ID of the published post to comment on. Get it from List Posts, from items whose state.type is published.
text	string	Yes	Plain-text comment body. Instagram allows up to 2200 characters.
parentCommentId	string	No	Blotato ID of a top-level, posted comment on the same post to reply to. Replies to replies are not supported.

Response

Status Code: 201 Created

Returns a Comment Object with status queued.

Errors

Status	Reason
404	The published post or parent comment was not found, or comments are not enabled for your account.
422	The post's platform does not support comments, the comment exceeds the platform's character limit, the parent comment is invalid, or you reached your plan's monthly active-contacts limit (error code 20101).
429	Rate limit exceeded (30 requests per minute).

Replies and Your Contacts Limit

Replying to a comment from your audience counts the person as an active contact for the month, and your plan limits how many active contacts you reach. When you pass the limit, Post Comment returns 422 with error code 20101. Replying to your own comment does not count.

See Active Contacts for the definition and per-plan limits.

---

Comment Object

Field	Type	Description
id	string	Blotato comment ID.
accountId	string	ID of the connected account the comment belongs to.
platform	string	instagram.
postId	string or null	Blotato ID of the post, when published through Blotato.
parentCommentId	string or null	Blotato ID of the parent comment when this comment is a reply. null for top-level comments.
platformPostId	string	Social platform (e.g. Instagram) ID of the parent post.
platformCommentId	string or null	Social platform (e.g. Instagram) ID of the comment.
authorId	string or null	Social platform (e.g. Instagram) ID of the comment author.
isAuthor	boolean	true when your connected account authored the comment. false for an audience reply.
text	string	Comment text.
status	string	Comment status. See Status Values.
errorCode	integer or null	Set only when status is failed. See Comments Errors.
errorMessage	string or null	Set only when status is failed.
createdAt	string	ISO 8601 timestamp when the comment was created.

Status Values

Status	Meaning
queued	Accepted and waiting to post.
processing	Posting to the social platform.
posted	Live on the social platform.
failed	Did not post. See errorMessage.
deleted	Removed from the social platform.

Rate Limits

Endpoint	Limit
GET /comments	60 / min
GET /comments/:commentId	60 / min
POST /comments	30 / min