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

# Comments, replies and mentions, most recent first

> Defaults to what still needs an answer. Each row carries the post it belongs to, so a comment can be read in context.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/engagement
openapi: 3.0.0
info:
  title: PlugKit API
  description: >-
    One API to publish, schedule and message across Instagram, WhatsApp, TikTok,
    Telegram, YouTube and X.
  version: 1.0.0
  contact: {}
servers: []
security: []
tags: []
paths:
  /v1/engagement:
    get:
      tags:
        - engagement
      summary: Comments, replies and mentions, most recent first
      description: >-
        Defaults to what still needs an answer. Each row carries the post it
        belongs to, so a comment can be read in context.
      operationId: EngagementController_list
      parameters:
        - name: profileId
          required: false
          in: query
          description: Restrict to one profile.
          schema:
            type: string
        - name: accountId
          required: false
          in: query
          description: Restrict to one connected account.
          schema:
            type: string
        - name: platform
          required: false
          in: query
          schema:
            type: string
            enum:
              - instagram
              - whatsapp
              - tiktok
              - telegram
              - youtube
              - x
              - facebook
              - meta_ads
              - linkedin
              - threads
        - name: kind
          required: false
          in: query
          description: >-
            `comment` = left on one of your posts (you can reply, hide, delete).
            `mention` = someone else’s post naming you (you can only reply).
          schema:
            enum:
              - comment
              - mention
            type: string
        - name: postId
          required: false
          in: query
          description: Restrict to the comments of one post (platform post id).
          schema:
            type: string
        - name: status
          required: false
          in: query
          description: >-
            Defaults to `pending` — what still needs an answer. `pending`
            excludes your own replies and anything deleted, since neither is
            waiting on you.
          schema:
            enum:
              - pending
              - handled
              - all
            type: string
        - name: limit
          required: false
          in: query
          description: Page size (1-200, default 50).
          schema:
            type: string
        - name: before
          required: false
          in: query
          description: The `nextCursor` of the previous call, to walk further back.
          schema:
            type: string
      responses:
        '200':
          description: ''
      security:
        - api-key: []
components:
  securitySchemes:
    api-key:
      scheme: bearer
      bearerFormat: sk_...
      type: http

````