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

# Get Dashboard Commenting Statistics

> Returns the Commenting section of the Dashboard for a period: comments posted, the average per day, and the daily posted and pending comments. The period is `startDate`–`endDate`, both calendar days included, in `timezone`: 1 to 31 days, and `endDate` is not later than today in that timezone. A period outside these rules or an unknown timezone is refused with 400. To get the same numbers as the Extrovert Dashboard, pass the `timezone` of the user's profile (the `timezone` field of the user in the Team Members list). Comparison values are against the preceding range of the same number of days. Pending counts the actions waiting right now (not yet published or sent) whose date lies in the period; it is not the historical size of the queue on that day. Both id filters are optional: an omitted or empty filter does not narrow that dimension, and without filters every campaign of the caller's scope is counted. `campaignsIds` come from the Campaign list and `ownersIds` from the Team Members list; when both are given they narrow the scope together (AND), and an id outside the caller's scope is refused with 403.



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json get /client/v2/dashboard/commenting
openapi: 3.1.0
info:
  title: Extrovert Client API
  description: >-
    Public API for Extrovert platform integration. Use your API key for
    authentication.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.goextrovert.com/
    description: API Server
security: []
tags: []
paths:
  /client/v2/dashboard/commenting:
    get:
      tags:
        - Dashboard
      summary: Get Dashboard Commenting Statistics
      description: >-
        Returns the Commenting section of the Dashboard for a period: comments
        posted, the average per day, and the daily posted and pending comments.
        The period is `startDate`–`endDate`, both calendar days included, in
        `timezone`: 1 to 31 days, and `endDate` is not later than today in that
        timezone. A period outside these rules or an unknown timezone is refused
        with 400. To get the same numbers as the Extrovert Dashboard, pass the
        `timezone` of the user's profile (the `timezone` field of the user in
        the Team Members list). Comparison values are against the preceding
        range of the same number of days. Pending counts the actions waiting
        right now (not yet published or sent) whose date lies in the period; it
        is not the historical size of the queue on that day. Both id filters are
        optional: an omitted or empty filter does not narrow that dimension, and
        without filters every campaign of the caller's scope is counted.
        `campaignsIds` come from the Campaign list and `ownersIds` from the Team
        Members list; when both are given they narrow the scope together (AND),
        and an id outside the caller's scope is refused with 403.
      operationId: DashboardStatisticsClientApiController_getCommenting
      parameters:
        - description: >-
            Optional campaign-owner user IDs in the accessible workspace scope.
            Omit or pass `[]` for no owner filter; combined with `campaignsIds`
            using AND.
          required: false
          name: ownersIds
          in: query
          schema:
            type: array
        - description: >-
            Optional campaign IDs in the accessible workspace scope. Omit or
            pass `[]` for no campaign filter; combined with `ownersIds` using
            AND.
          required: false
          name: campaignsIds
          in: query
          schema:
            type: array
        - description: First calendar day of the period, included, `YYYY-MM-DD`.
          examples:
            example1:
              value: '2026-09-12'
          required: true
          name: startDate
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - description: >-
            Last calendar day of the period, included, `YYYY-MM-DD`. Not later
            than today in `timezone`.
          examples:
            example1:
              value: '2026-10-11'
          required: true
          name: endDate
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - description: >-
            Required IANA timezone the calendar days are taken in. Use the
            user's profile `timezone` to match the Dashboard.
          examples:
            example1:
              value: Europe/Paris
            example2:
              value: America/New_York
          required: true
          name: timezone
          in: query
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCommentingResponseDto'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    GetCommentingResponseDto:
      type: object
      properties:
        status:
          type: string
          const: success
          description: Response status
        data:
          type: object
          properties:
            period:
              type: object
              properties:
                startDate:
                  type: string
                  description: First calendar day of the period, included, `YYYY-MM-DD`.
                endDate:
                  type: string
                  description: Last calendar day of the period, included, `YYYY-MM-DD`.
                timezone:
                  type: string
                  description: IANA timezone the period was computed in.
                daysCount:
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                  description: Number of calendar days in the period.
              required:
                - startDate
                - endDate
                - timezone
                - daysCount
              description: The validated period the values were computed for.
            postedComments:
              description: >-
                Comments posted in the period, with the comparison to the
                preceding range.
              type: object
              properties:
                currentIntervalValue:
                  type: number
                  description: Value for the period.
                changePercentVsPreviousPeriod:
                  type: number
                  description: >-
                    Percent change of `currentIntervalValue` against the
                    preceding range of the same number of days (e.g. `-50` is
                    half, `100` is double) — a change, not the preceding value
                    itself. `0` both when nothing changed and when the preceding
                    range had nothing.
              required:
                - currentIntervalValue
                - changePercentVsPreviousPeriod
            postedCommentsPerDayAverage:
              description: >-
                Comments posted per day: the period total divided by its number
                of days, with the comparison to the preceding range.
              type: object
              properties:
                currentIntervalValue:
                  type: number
                  description: Value for the period.
                changePercentVsPreviousPeriod:
                  type: number
                  description: >-
                    Percent change of `currentIntervalValue` against the
                    preceding range of the same number of days (e.g. `-50` is
                    half, `100` is double) — a change, not the preceding value
                    itself. `0` both when nothing changed and when the preceding
                    range had nothing.
              required:
                - currentIntervalValue
                - changePercentVsPreviousPeriod
            dailyStatisticsList:
              type: array
              items:
                type: object
                properties:
                  date:
                    type: string
                    description: Calendar day, `YYYY-MM-DD`.
                  pendingPostsCount:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: >-
                      Comments waiting for approval or publishing. Pending
                      counts the actions waiting right now (not yet published or
                      sent) whose date lies in the period; it is not the
                      historical size of the queue on that day.
                  respondedPostsCount:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: Comments posted on this day.
                required:
                  - date
                  - pendingPostsCount
                  - respondedPostsCount
              description: >-
                One item per calendar day of the period, days without activity
                included.
          description: Commenting section for the period
          required:
            - dailyStatisticsList
        message:
          type: string
          description: Success message
          examples:
            - Operation completed successfully
      required:
        - status
        - data
        - message
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: object
          description: Response data
          example: null
          nullable: true
        message:
          type: string
          description: Error message
          example: An error occurred while processing the request
      required:
        - status
        - data
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````

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