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

# Retrieve knowledge base statistics

Returns time-series data for knowledge base usage metrics. Data is aggregated by date based on the specified or automatically determined interval. The response includes total search count for the period.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /reporting/knowledge/statistics
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /reporting/knowledge/statistics:
    get:
      tags:
        - Knowledge Base Reporting
      summary: Retrieve knowledge base statistics
      description: >-
        Returns time-series data for knowledge base usage metrics. Data is
        aggregated by date based on the specified or automatically determined
        interval. The response includes total search count for the period.
      operationId: getKnowledgeStatistics
      parameters:
        - name: start
          in: query
          required: true
          schema:
            type: string
            format: date
          description: Start date for the statistics range in YYYY-MM-DD format.
          example: '2026-01-01'
        - name: end
          in: query
          required: true
          schema:
            type: string
            format: date
          description: End date for the statistics range in YYYY-MM-DD format.
          example: '2026-01-31'
      responses:
        '200':
          description: Knowledge base statistics retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  visitors:
                    type: object
                    description: >-
                      Unique visitor counts grouped by date. Each key is a
                      formatted date string based on the interval.
                    additionalProperties:
                      type: integer
                      description: Number of unique visitors for this date.
                    example:
                      '2026-01-01': 42
                      '2026-01-02': 38
                      '2026-01-03': 51
                  views:
                    type: object
                    description: >-
                      Total article view counts grouped by date. Each key is a
                      formatted date string based on the interval.
                    additionalProperties:
                      type: integer
                      description: Number of article views for this date.
                    example:
                      '2026-01-01': 156
                      '2026-01-02': 142
                      '2026-01-03': 189
                  searches:
                    type: object
                    description: >-
                      Count of searches with no matching results, grouped by
                      date. Each key is a formatted date string based on the
                      interval.
                    additionalProperties:
                      type: integer
                      description: Number of searches with zero matches for this date.
                    example:
                      '2026-01-01': 8
                      '2026-01-02': 12
                      '2026-01-03': 6
                  total_searches:
                    type: integer
                    description: >-
                      Total number of all searches (including those with
                      results) during the entire period.
                    example: 427
        '400':
          description: Invalid input parameters or date validation error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message describing the validation failure.
                    example: Invalid date for 'end'
        '403':
          description: Insufficient permissions to access reporting data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message.
                    example: Access denied
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````