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

# List Instagram comments

> List comments on Instagram posts.



## OpenAPI

````yaml /en/instagram-api/api-reference/openapi-instagram.json get /v1/instagram/comments
openapi: 3.0.3
info:
  title: Notifique API — Instagram
  version: 1.0.0
  description: >-
    Send Instagram DMs and manage connections. Authenticate with `Authorization:
    Bearer sk_live_...` or `x-api-key`.
servers:
  - url: https://api.notifique.dev
    description: Production
security:
  - ntfIgBearerAuth: []
  - ntfIgApiKeyHeader: []
tags:
  - name: 'Instagram: instances'
    description: Criar, listar, desconectar e remover conexões Instagram.
  - name: 'Instagram: messages'
    description: Enviar, listar, editar, cancelar, apagar e inbound.
  - name: 'Instagram: comments'
    description: Listr, responder e moderar comentários.
  - name: 'Instagram: media'
    description: Recent account posts and media (automation triggers).
paths:
  /v1/instagram/comments:
    get:
      tags:
        - 'Instagram: comentários'
      summary: List Instagram comments
      description: List comments on Instagram posts.
      operationId: ntfIg_listComments
      parameters:
        - name: instanceId
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: List de comentários.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ntfIg_ListCommentsResponse'
              example:
                success: true
                data:
                  - id: cmt_abc
                    instanceId: inst_abc
                    mediaId: media_123
                    text: Adorei!
                    username: cliente
                    hidden: false
                    createdAt: '2026-07-20T12:00:00.000Z'
                meta:
                  page: 1
                  limit: 20
                  total: 1
        '403':
          description: Missing scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfIg_ErrorResponse'
              example:
                success: false
                error: Bad Request
                code: VALIDATION_ERROR
                message: Campo inválido ou ausente.
components:
  schemas:
    ntfIg_ListCommentsResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                example: cmt_abc
              instanceId:
                type: string
                example: inst_abc
              mediaId:
                type: string
                example: media_123
              text:
                type: string
                example: Adorei!
              username:
                type: string
                example: cliente
              hidden:
                type: boolean
                example: false
              createdAt:
                type: string
                example: '2026-07-20T12:00:00.000Z'
          example:
            - id: cmt_abc
              instanceId: inst_abc
              mediaId: media_123
              text: Adorei!
              username: cliente
              hidden: false
              createdAt: '2026-07-20T12:00:00.000Z'
        meta:
          type: object
          properties:
            page:
              type: integer
              example: 1
            limit:
              type: integer
              example: 20
            total:
              type: integer
              example: 1
      example:
        success: true
        data:
          - id: cmt_abc
            instanceId: inst_abc
            mediaId: media_123
            text: Adorei!
            username: cliente
            hidden: false
            createdAt: '2026-07-20T12:00:00.000Z'
        meta:
          page: 1
          limit: 20
          total: 1
    NtfIg_ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
        message:
          type: string
        code:
          type: string
        details:
          type: object
          additionalProperties: true
        data:
          type: object
          additionalProperties: true
          properties:
            id:
              type: string
              example: inst_abc
            status:
              type: string
              example: PENDING
            active:
              type: boolean
              example: true
            dailyLimit:
              type: integer
              example: 15
            sentToday:
              type: integer
              example: 15
            daysRemaining:
              type: integer
              example: 4
        retryAfterSec:
          type: integer
          description: >-
            Segundos até poder tentar de novo (presente em 429 de cooldown/abuse
            pause).
      example:
        success: false
        error: string
        message: string
        code: string
        details: {}
        data: {}
        retryAfterSec: 1
  securitySchemes:
    ntfIgBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Authorization: Bearer sk_live_...'
    ntfIgApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````