List comments on a post

Returns comments for a specific inbox post, including per-platform capability flags (can_reply, can_delete, can_hide, can_like, can_private_reply). Uses cursor-based pagination.

GET /inbox/comments/{postId}

List comments on a post

cURL

curl --request GET \
  --url https://api.social-api.ai/v1/inbox/comments/{postId} \
  --header 'Authorization: <api-key>'

200

{
  "data": [
    {
      "author_headline": "<string>",
      "author_id": "<string>",
      "author_name": "<string>",
      "author_picture": "<string>",
      "author_profile_url": "<string>",
      "author_username": "<string>",
      "capabilities": {
        "can_delete": true,
        "can_hide": true,
        "can_like": true,
        "can_private_reply": true,
        "can_reply": true
      },
      "created_at": "<string>",
      "has_replies": true,
      "id": "sapi_cmt_TT974YVQH4RAHNN2HY2DJSNY9111D7LMTP1XXPCVQVL",
      "is_hidden": true,
      "is_owner": true,
      "like_count": 123,
      "liked_by_viewer": true,
      "moderation_status": "<string>",
      "parent_id": "<string>",
      "platform": "<string>",
      "platform_id": "<string>",
      "reply_count": 123,
      "text": "<string>"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Path Parameters

postId · string · required

Platform post ID

Query Parameters

account_id · string · required

Connected account ID that owns the post

limit · integer

Results per page (default 25). Some platforms return fewer, and on TikTok the first page can return more

cursor · string

Pagination cursor from previous response

moderation_status · string

Filter by moderation status: published (default), held_for_review, likely_spam. YouTube only; other platforms do not filter by it.

order · string

Order: recent (default) or relevance. YouTube only; other platforms do not sort by it.

q · string

Keyword search across comment text (max 256 chars). YouTube only; other platforms do not filter by it.

Response

200

application/json

Paginated list of comments with capabilities

data · object[]

Show child attributes

pagination · object

Show child attributes