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

# Get topics analytics

> Get conversation topics analysis with daily breakdown showing top discussion topics



## OpenAPI

````yaml get /api/v2/analytics/topics
openapi: 3.0.1
info:
  title: LiveChatAI API v2
  description: >-
    LiveChatAI API v2 - Build powerful AI-powered customer support experiences.
    This API follows REST principles with predictable, resource-oriented URLs,
    JSON responses, and standard HTTP methods.
  version: 2.0.0
servers:
  - url: https://app.livechatai.com
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/v2/analytics/topics:
    get:
      tags:
        - Analytics
      summary: Get topics analytics
      description: >-
        Get conversation topics analysis with daily breakdown showing top
        discussion topics
      parameters:
        - in: query
          name: agentId
          required: true
          schema:
            type: string
            example: clx1234567890abcdef
          description: The ID of the agent/chatbot
        - in: query
          name: startDate
          required: true
          schema:
            type: string
            format: date
            example: '2024-01-01'
          description: Start date for analytics (ISO 8601 format)
        - in: query
          name: endDate
          required: true
          schema:
            type: string
            format: date
            example: '2024-01-31'
          description: End date for analytics (ISO 8601 format)
        - in: query
          name: showAllTopics
          schema:
            type: boolean
            default: false
            example: false
          description: Show all topics instead of just top 6
        - in: query
          name: timezone
          schema:
            type: string
            example: America/New_York
          description: Timezone for date calculations (defaults to system timezone)
      responses:
        '200':
          description: Successfully retrieved topics analytics data
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          example: '2024-01-15'
                          description: Date of the topic data
                        Pricing:
                          type: number
                          example: 25
                          description: Number of conversations about pricing
                        Features:
                          type: number
                          example: 18
                          description: Number of conversations about features
                        Support:
                          type: number
                          example: 12
                          description: Number of conversations about support
                      additionalProperties:
                        type: number
                    description: >-
                      Daily breakdown of conversation topics (dynamic properties
                      based on topics)
                  keys:
                    type: array
                    items:
                      type: string
                    example:
                      - Pricing
                      - Features
                      - Support
                      - Billing
                      - Integration
                      - Account
                    description: >-
                      Top topic names (top 6 by default, all if
                      showAllTopics=true)
                  allTopics:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          example: Pricing
                          description: Topic name
                        count:
                          type: number
                          example: 425
                          description: Total count for this topic
                    description: >-
                      All topics with their total counts across the entire
                      period
                  areAllTopicsVisible:
                    type: boolean
                    example: false
                    description: >-
                      Whether all topics are currently visible or filtered to
                      top 6
        '400':
          description: Bad request - Missing or invalid parameters
        '401':
          description: Unauthorized - Invalid API token
        '403':
          description: Forbidden - API access not available for plan
        '404':
          description: Chatbot not found or access denied
        '500':
          description: Internal server error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````