---
title: "List all comments"
method: GET
path: "/social/{connection_id}/comment"
tags: ["social", "comment"]
---

# List all comments

`GET /social/{connection_id}/comment`

## Request

- Base URL: `https://api.unified.to`
- URL: `https://api.unified.to/social/{connection_id}/comment`
- Auth: API key in header `authorization`
- TypeScript: <https://skmtc.dev/unified/apis/unified-to-api/docs/social/:connection_id/comment/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of SocialComments. Narrow the results with the query parameters before paging, then page through them with `limit` and `offset` (the default and maximum page size depend on the integration). Use `fields` to return only the fields you need and reduce the response size. When the integration supports a total count, it is returned in the `X-Total-Count` response header. Use each item's `id` to retrieve, update, or delete it where those operations are supported.

## Path parameters

- `connection_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `updated_gte` string
- `sort` string
- `order` string
- `query` string
- `post_id` string
- `parent_id` string
- `fields` string[]
- `raw` string

## Response `200`

Successful

- SocialComment[]
  - `id` string: Unique identifier for the comment
  - `created_at` string, date-time: When the comment was posted (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: When the comment was last edited, when the provider reports it (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `post_id` string: The post (or video) the comment belongs to
  - `parent_id` string: Set when this comment is a reply; the id of the comment being replied to
  - `author_identifier` string: Provider id of the commenter (not a Unified id)
  - `author_name` string: Display name of the commenter
  - `author_username` string: Handle / username of the commenter
  - `author_avatar_url` string: Avatar URL of the commenter
  - `content` string: The comment text
  - `url` string: Permalink to the comment, when available
  - `is_hidden` boolean: True if the comment is hidden or held for moderation
  - `metrics` PropertySocialCommentMetrics
    - `like_count` number: Number of likes on the comment
    - `reply_count` number: Number of replies to the comment
  - `raw` object: Raw data from integration

## Changes

- **2026-11-09** `b81703b69915`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unified/apis/unified-to-api/changes/social/:connection_id/comment/get.md)

---

[API](https://skmtc.dev/unified/apis/unified-to-api.md) - [All operations](https://skmtc.dev/unified/apis/unified-to-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api/revisions/b81703b69915?raw)