> ## Documentation Index
> Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Base URL: https://api.social-api.ai/v1. Send your API key in the Authorization header: Authorization: Bearer <your API key>.
> Every error response from /v1 is JSON: { "error": { "code", "message", "meta" (optional) }, "request_id" }. Branch on error.code; use error.message only for logs.
> A 429 response carries a Retry-After header, in seconds, when the limit has a known wait. Authenticated responses can carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset for the per-minute request budget your SocialAPI account shares across every API key (see /guides/rate-limits).
> Paginated list endpoints return next_cursor, at the top level or inside pagination (see /guides/pagination). Pass it as the cursor query parameter to get the next page. An absent or empty next_cursor means you have the last page.
> Treat every ID as an opaque string: do not parse it or assume a format.
> Support differs by platform and by operation. Check /platforms/overview before assuming an operation works on a platform. An unsupported operation returns 501 with error.code resource.not_supported.

# List replies to a comment

> Returns paginated replies to a specific comment. Same response shape as top-level comments. Uses cursor-based pagination.



## OpenAPI

````yaml /api-reference/openapi.json get /inbox/comments/{postId}/{commentId}/replies
openapi: 3.0.0
info:
  description: >-
    Unified social media inbox API. Read and respond to comments, DMs, reviews,
    and mentions across Instagram, Facebook, Threads, Google Business Profile,
    TikTok, LinkedIn, and YouTube through a single REST API. X/Twitter and
    Trustpilot coming soon.
  title: SocialAPI.AI
  contact:
    name: SocialAPI.AI Support
    email: support@social-api.ai
  license:
    name: MIT
  version: '1.0'
servers:
  - url: https://api.social-api.ai/v1
security: []
paths:
  /inbox/comments/{postId}/{commentId}/replies:
    get:
      tags:
        - Inbox Comments
      summary: List replies to a comment
      description: >-
        Returns paginated replies to a specific comment. Same response shape as
        top-level comments. Uses cursor-based pagination.
      parameters:
        - example: '17895695668004550'
          description: Platform post ID
          name: postId
          in: path
          required: true
          schema:
            type: string
        - example: '17858893269577012'
          description: Platform comment ID to get replies for
          name: commentId
          in: path
          required: true
          schema:
            type: string
        - example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J
          description: Connected account ID that owns the post
          name: account_id
          in: query
          required: true
          schema:
            type: string
        - example: 10
          description: Max results per page (default 10)
          name: limit
          in: query
          schema:
            type: integer
        - description: Pagination cursor from previous response
          name: cursor
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Paginated list of replies with capabilities
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/api_endpoints.CommentsWithCapsListResponse
        '400':
          description: Missing required parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '501':
          description: Platform does not support comment replies
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    api_endpoints.CommentsWithCapsListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/api_endpoints.CommentWithCapabilities'
        pagination:
          $ref: '#/components/schemas/api_endpoints.InboxPagination'
    api_endpoints.ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/api_endpoints.ErrorBody'
        request_id:
          description: >-
            RequestID matches the X-Request-ID response header. Include it when
            contacting support.
          type: string
          example: 01HZ9X3Q4R5M6N7P8V2K0W1J
    api_endpoints.CommentWithCapabilities:
      type: object
      properties:
        author_headline:
          type: string
        author_id:
          type: string
        author_name:
          type: string
        author_picture:
          type: string
        author_profile_url:
          type: string
        author_username:
          type: string
        capabilities:
          $ref: '#/components/schemas/api_endpoints.CommentCapabilities'
        created_at:
          type: string
        has_replies:
          type: boolean
        id:
          description: >-
            ID is the canonical SocialAPI interaction id (sapi_cmt_…). Prefer it
            over

            platform_id, which is retained for backward compatibility.
          type: string
          example: sapi_cmt_TT974YVQH4RAHNN2HY2DJSNY9111D7LMTP1XXPCVQVL
        is_hidden:
          type: boolean
        is_owner:
          type: boolean
        like_count:
          type: integer
        liked_by_viewer:
          description: >-
            LikedByViewer is true when the connected account has liked this
            comment.

            LinkedIn reports it directly. Instagram and Facebook do not report
            it on

            the comment read, so there it means "liked through SocialAPI": a
            like made

            in the platform's own app is not reflected.
          type: boolean
        moderation_status:
          description: >-
            ModerationStatus is the platform's moderation state for this
            comment, when

            exposed: "published", "held_for_review", "likely_spam", or
            "rejected".

            Empty when unknown or not applicable. [platform: youtube]
          type: string
        parent_id:
          type: string
        platform:
          type: string
        platform_id:
          type: string
        reply_count:
          description: |-
            ReplyCount is kept for backward compatibility but deprecated: prefer
            HasReplies. Not all platforms report an exact count.
          type: integer
        text:
          type: string
    api_endpoints.InboxPagination:
      type: object
      properties:
        has_more:
          type: boolean
        next_cursor:
          type: string
    api_endpoints.ErrorBody:
      type: object
      properties:
        code:
          type: string
          example: resource.not_found
        message:
          type: string
          example: Account not found
        meta:
          type: object
          additionalProperties: {}
    api_endpoints.CommentCapabilities:
      type: object
      properties:
        can_delete:
          type: boolean
          example: true
        can_hide:
          type: boolean
          example: true
        can_like:
          type: boolean
          example: true
        can_private_reply:
          type: boolean
          example: true
        can_reply:
          type: boolean
          example: true
  securitySchemes:
    BearerAuth:
      description: >-
        Prefix your API key with "Bearer ". Example: `Authorization: Bearer
        sapi_key_...`
      type: apiKey
      name: Authorization
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.