> 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/api/openapi-reference/comments.md).

# Comments

Endpoints related to reading and posting comments on social posts.

## List comments

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

```json
{"openapi":"3.0.3","info":{"title":"Blotato API","version":"2.0.0"},"tags":[{"name":"comments","description":"Endpoints related to reading and posting comments on social posts."}],"servers":[{"url":"https://backend.blotato.com","description":"Blotato API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"blotato-api-key","in":"header"}}},"paths":{"/v2/comments":{"get":{"summary":"List comments","tags":["comments"],"description":"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.","parameters":[{"schema":{"minimum":1,"maximum":250,"default":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Maximum number of comments to return. Defaults to 50."},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor returned by a previous call. Pass it to fetch the next page."},{"schema":{"type":"array","items":{"type":"string","enum":["facebook","instagram","twitter"]}},"in":"query","name":"platform","required":false,"description":"Filter comments by platform. Pass multiple values to include any of them."},{"schema":{"type":"string"},"in":"query","name":"accountId","required":false,"description":"Filter to comments belonging to a single connected account."},{"schema":{"type":"string"},"in":"query","name":"postId","required":false,"description":"Filter to comments on a single Blotato-published post."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"description":"List of comments.","type":"array","items":{"type":"object","properties":{"accountId":{"description":"ID of the social account this comment belongs to.","type":"string"},"authorId":{"description":"Platform-native id of the comment author.","type":"string","nullable":true},"createdAt":{"type":"string"},"errorCode":{"description":"Set only when status is `failed`.","type":"integer","nullable":true},"errorMessage":{"description":"Set only when status is `failed`.","type":"string","nullable":true},"id":{"type":"string"},"platform":{"type":"string","enum":["facebook","instagram","twitter"]},"platformCommentId":{"description":"Platform-native id of the comment.","type":"string","nullable":true},"platformPostId":{"description":"Platform-native id of the parent post being commented on.","type":"string"},"postId":{"description":"Blotato ID of the post (if published through Blotato).","type":"string","nullable":true},"status":{"type":"string","enum":["deleted","failed","posted","processing","queued"]},"text":{"type":"string"}},"required":["accountId","authorId","createdAt","errorCode","errorMessage","id","platform","platformCommentId","platformPostId","postId","status","text"]}},"cursor":{"description":"Cursor for the next page. Absent when there are no more comments.","type":"string"}},"required":["items"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Resource not found","type":"string"}},"required":["message"]}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"description":"Validation error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Validation error","type":"string"}},"required":["message"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"description":"Server error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"An error occurred","type":"string"}},"required":["message"]}}}}}}}}}
```

## Post a comment

> Posts a comment on a published post.

```json
{"openapi":"3.0.3","info":{"title":"Blotato API","version":"2.0.0"},"tags":[{"name":"comments","description":"Endpoints related to reading and posting comments on social posts."}],"servers":[{"url":"https://backend.blotato.com","description":"Blotato API Server"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"blotato-api-key","in":"header"}}},"paths":{"/v2/comments":{"post":{"summary":"Post a comment","tags":["comments"],"description":"Posts a comment on a published post.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"postId":{"description":"Blotato id of the published post to comment on.","type":"string"},"text":{"minLength":1,"maxLength":10000,"description":"Plain-text comment body.","type":"string"}},"required":["postId","text"]}}},"required":true},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"accountId":{"description":"ID of the social account this comment belongs to.","type":"string"},"authorId":{"description":"Platform-native id of the comment author.","type":"string","nullable":true},"createdAt":{"type":"string"},"errorCode":{"description":"Set only when status is `failed`.","type":"integer","nullable":true},"errorMessage":{"description":"Set only when status is `failed`.","type":"string","nullable":true},"id":{"type":"string"},"platform":{"type":"string","enum":["facebook","instagram","twitter"]},"platformCommentId":{"description":"Platform-native id of the comment.","type":"string","nullable":true},"platformPostId":{"description":"Platform-native id of the parent post being commented on.","type":"string"},"postId":{"description":"Blotato ID of the post (if published through Blotato).","type":"string","nullable":true},"status":{"type":"string","enum":["deleted","failed","posted","processing","queued"]},"text":{"type":"string"}},"required":["accountId","authorId","createdAt","errorCode","errorMessage","id","platform","platformCommentId","platformPostId","postId","status","text"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Resource not found","type":"string"}},"required":["message"]}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"description":"Validation error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Validation error","type":"string"}},"required":["message"]}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"description":"Rate limit exceeded","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"Rate limit exceeded","type":"string"}},"required":["message"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"description":"Server error","type":"object","properties":{"code":{"type":"number"},"reqId":{"description":"Request ID for tracking","type":"string"},"message":{"description":"An error occurred","type":"string"}},"required":["message"]}}}}}}}}}
```


---

# 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:

```
GET https://help.blotato.com/api/openapi-reference/comments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.