Skip to main content
GET
/
inbox
/
comments
/
{postId}
List comments on a post
curl --request GET \
  --url https://api.social-api.ai/v1/inbox/comments/{postId} \
  --header 'Authorization: <api-key>'
{
  "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,
      "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

Max results per page (default 25)

cursor
string

Pagination cursor from previous response

moderation_status
string

Filter by moderation status: published (default), held_for_review, likely_spam. YouTube only; ignored by other platforms.

order
string

Order: recent (default) or relevance. YouTube only; ignored by other platforms.

q
string

Keyword search across comment text (max 256 chars). YouTube only; ignored by other platforms.

Response

Paginated list of comments with capabilities

data
object[]
pagination
object