Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Comments

Endpoints related to reading and posting comments on social posts.

List comments

get

Lists the current user's comments across their connected social accounts, ordered by creation time (most recent first). Supports cursor-based pagination and filtering by platform, account, published post, and creation time window.

Authorizations
blotato-api-keystringRequired
Query parameters
limitinteger · min: 1 · max: 250Optional

Maximum number of comments to return. Defaults to 50.

Default: 50
cursorstringOptional

Opaque cursor returned by a previous call. Pass it to fetch the next page.

accountIdstringOptional

Filter to comments belonging to a single connected account.

parentCommentIdstringOptional

Filter to direct replies to a single comment.

postIdstringOptional

Filter to comments on a single Blotato-published post. Accepts either the published post ID or the post submission ID returned when the post was published.

sincestringOptional

Only include comments created on or after this ISO 8601 timestamp. Omit to apply no lower bound.

Example: 2026-06-01T00:00:00.000Z
untilstringOptional

Only include comments created on or before this ISO 8601 timestamp. Omit to apply no upper bound.

Example: 2026-06-30T23:59:59.000Z
Responses
200

Default Response

application/json
cursorstringOptional

Cursor for the next page. Absent when there are no more comments.

get/v2/comments
GET /v2/comments HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "accountId": "text",
      "authorId": "text",
      "createdAt": "text",
      "errorCode": 1,
      "errorMessage": "text",
      "id": "text",
      "isAuthor": true,
      "parentCommentId": "text",
      "platform": "facebook",
      "platformCommentId": "text",
      "platformPostId": "text",
      "postId": "text",
      "status": "deleted",
      "text": "text"
    }
  ],
  "cursor": "text"
}

Post a comment

post

Posts a comment on a published post, or a reply to an existing comment on that post when parentCommentId is provided.

Authorizations
blotato-api-keystringRequired
Body
postIdstringRequired

Blotato id of the published post to comment on.

textstring · min: 1 · max: 10000Required

Plain-text comment body.

parentCommentIdstringOptional

Blotato id of an existing top-level, posted comment on the same post to reply to. Replies to replies are not supported.

Responses
201

Default Response

application/json
accountIdstringRequired

ID of the social account this comment belongs to.

authorIdstring · nullableRequired

Platform-native id of the comment author.

createdAtstringRequired
errorCodeinteger · nullableRequired

Set only when status is failed.

errorMessagestring · nullableRequired

Set only when status is failed.

idstringRequired
isAuthorbooleanRequired

true if the user's own connected account authored this comment.

parentCommentIdstring · nullableRequired

Blotato id of the parent comment when this comment is a reply. null for top-level comments.

platformstring · enumRequiredPossible values:
platformCommentIdstring · nullableRequired

Platform-native id of the comment.

platformPostIdstringRequired

Platform-native id of the parent post being commented on.

postIdstring · nullableRequired

Blotato ID of the post (if published through Blotato).

statusstring · enumRequiredPossible values:
textstringRequired
post/v2/comments
POST /v2/comments HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "postId": "text",
  "text": "text",
  "parentCommentId": "text"
}
{
  "accountId": "text",
  "authorId": "text",
  "createdAt": "text",
  "errorCode": 1,
  "errorMessage": "text",
  "id": "text",
  "isAuthor": true,
  "parentCommentId": "text",
  "platform": "facebook",
  "platformCommentId": "text",
  "platformPostId": "text",
  "postId": "text",
  "status": "deleted",
  "text": "text"
}

Get a comment

get

Fetches a single comment by its Blotato ID. The comment may be an inbound reply left by the user's audience on one of their posts, or an outbound comment the user posted through Blotato.

Authorizations
blotato-api-keystringRequired
Path parameters
commentIdstringRequired

Blotato id of the comment to fetch.

Responses
200

Default Response

application/json
accountIdstringRequired

ID of the social account this comment belongs to.

authorIdstring · nullableRequired

Platform-native id of the comment author.

createdAtstringRequired
errorCodeinteger · nullableRequired

Set only when status is failed.

errorMessagestring · nullableRequired

Set only when status is failed.

idstringRequired
isAuthorbooleanRequired

true if the user's own connected account authored this comment.

parentCommentIdstring · nullableRequired

Blotato id of the parent comment when this comment is a reply. null for top-level comments.

platformstring · enumRequiredPossible values:
platformCommentIdstring · nullableRequired

Platform-native id of the comment.

platformPostIdstringRequired

Platform-native id of the parent post being commented on.

postIdstring · nullableRequired

Blotato ID of the post (if published through Blotato).

statusstring · enumRequiredPossible values:
textstringRequired
get/v2/comments/{commentId}
GET /v2/comments/{commentId} HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Accept: */*

{
  "accountId": "text",
  "authorId": "text",
  "createdAt": "text",
  "errorCode": 1,
  "errorMessage": "text",
  "id": "text",
  "isAuthor": true,
  "parentCommentId": "text",
  "platform": "facebook",
  "platformCommentId": "text",
  "platformPostId": "text",
  "postId": "text",
  "status": "deleted",
  "text": "text"
}
PreviousMessaging
NextAutomations

Last updated