> ## Documentation Index
> Fetch the complete documentation index at: https://myco-29fc6df6-sweetmantech-myc-3925-docs-document-the-apiar.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Post Comments

> Retrieve comments for a specific social media post. This endpoint should be called after obtaining post IDs from the Social Posts endpoint. Returns detailed information about each commenter including their profile data, follower counts, and geographic region.



## OpenAPI

````yaml GET /api/post/comments
openapi: 3.1.0
info:
  title: Recoup API
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://recoup-api.vercel.app
security:
  - apiKeyAuth: []
paths:
  /api/post/comments:
    get:
      description: >-
        Retrieve comments for a specific social media post. This endpoint should
        be called after obtaining post IDs from the Social Posts endpoint.
        Returns detailed information about each commenter including their
        profile data, follower counts, and geographic region.
      parameters:
        - name: post_id
          in: query
          description: The unique identifier of the post to fetch comments for
          required: true
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: 'The page number to retrieve (default: 1)'
          required: false
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: 'The number of records per page (default: 20, max: 100)'
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
      responses:
        '200':
          description: Post comments retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCommentsResponse'
        '400':
          description: Bad request - missing required parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCommentsErrorResponse'
      servers:
        - url: https://api.recoupable.com
components:
  schemas:
    PostCommentsResponse:
      type: object
      required:
        - status
        - comments
        - pagination
      properties:
        status:
          type: string
          enum:
            - success
          description: Status of the request
        comments:
          type: array
          items:
            $ref: '#/components/schemas/PostComment'
          description: List of comments for the specified post
        pagination:
          $ref: '#/components/schemas/PostCommentsPagination'
          description: Pagination metadata for the response
    PostCommentsErrorResponse:
      type: object
      required:
        - status
        - error
      properties:
        status:
          type: string
          enum:
            - error
          description: Status of the request
        error:
          type: string
          description: Error message describing what went wrong
    PostComment:
      type: object
      required:
        - id
        - post_id
        - social_id
        - comment
        - commented_at
        - username
        - profile_url
        - post_url
      properties:
        id:
          type: string
          format: uuid
          description: UUID of the comment record
        post_id:
          type: string
          format: uuid
          description: UUID of the post this comment belongs to
        social_id:
          type: string
          format: uuid
          description: UUID of the social profile that made the comment
        comment:
          type: string
          description: Text content of the comment
        commented_at:
          type: string
          format: date-time
          description: ISO timestamp of when the comment was posted
        username:
          type: string
          description: Username of the commenter
        avatar:
          type: string
          nullable: true
          description: URL to the commenter's avatar image
        profile_url:
          type: string
          description: URL to the commenter's profile
        post_url:
          type: string
          description: URL to the post where the comment was made
        region:
          type: string
          nullable: true
          description: Geographic region of the commenter
        bio:
          type: string
          nullable: true
          description: Commenter's biography or description
        follower_count:
          type: integer
          nullable: true
          description: Number of followers the commenter has
        following_count:
          type: integer
          nullable: true
          description: Number of accounts the commenter follows
    PostCommentsPagination:
      type: object
      properties:
        total_count:
          type: integer
          description: Total number of comments available
        page:
          type: integer
          description: Current page number
        limit:
          type: integer
          description: Number of comments per page
        total_pages:
          type: integer
          description: Total number of pages available
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Recoup API key. [Learn more](/quickstart#api-keys).

````