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, and published post.

Authorizations

apiKey

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.

postIdstringOptional

Filter to comments on a single Blotato-published post.

Responses

200

Default Response

application/json

cursorstringOptional

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

404

Not found

application/json

422

Validation error

application/json

500

Server error

application/json

get

/v2/comments

HTTPcURLJavaScriptPython

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",
      "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.

Authorizations

apiKey

blotato-api-keystringRequired

Body

application/json

postIdstringRequired

Blotato id of the published post to comment on.

textstring · min: 1 · max: 10000Required

Plain-text comment body.

Responses

201

Default Response

application/json

404

Not found

application/json

422

Validation error

application/json

429

Rate limit exceeded

application/json

500

Server error

application/json

post

/v2/comments

HTTPcURLJavaScriptPython

POST /v2/comments HTTP/1.1
Host: backend.blotato.com
blotato-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "postId": "text",
  "text": "text"
}

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