---
title: "List comments"
method: GET
path: "/v2/comments"
tags: ["comments"]
---

# List comments

`GET /v2/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, published post, and creation time window.

## Query parameters

- `limit` integer
- `cursor` string
- `platform` string[]
- `accountId` string
- `parentCommentId` string
- `postId` string
- `since` string
- `until` string

## Response `200`

Default Response

- object
  - `items` object[], required — List of comments.
    - `accountId` string, required — ID of the social account this comment belongs to.
    - `authorId` string, nullable, required — Platform-native id of the comment author.
    - `createdAt` string, required
    - `errorCode` integer, nullable, required — Set only when status is `failed`.
    - `errorMessage` string, nullable, required — Set only when status is `failed`.
    - `id` string, required
    - `isAuthor` boolean, required — `true` if the user's own connected account authored this comment.
    - `parentCommentId` string, nullable, required — Blotato id of the parent comment when this comment is a reply. null for top-level comments.
    - `platform` 'facebook' | 'instagram', required
    - `platformCommentId` string, nullable, required — Platform-native id of the comment.
    - `platformPostId` string, required — Platform-native id of the parent post being commented on.
    - `postId` string, nullable, required — Blotato ID of the post (if published through Blotato).
    - `status` 'deleted' | 'failed' | 'posted' | 'processing' | 'queued', required
    - `text` string, required
  - `cursor` string — Cursor for the next page. Absent when there are no more comments.

## Other responses

- `403` — Forbidden
- `404` — Not found
- `422` — Validation error
- `500` — Server error

---

[API](https://skmtc.net/blotato/apis/blotato-api.md) · [All operations](https://skmtc.net/blotato/apis/blotato-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blotato/blotato-api/revisions/c93447ba6b9d/schema)