> ## 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 search statistics from the knowledge base

Returns analytics on knowledge base search behavior, including the 10 most frequently searched terms and the 10 most common searches that returned no results. This data helps identify content gaps and popular topics in the knowledge base.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /reporting/knowledge/searches
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/searches:
    get:
      tags:
        - Knowledge Base Reporting
      summary: Retrieve search statistics from the knowledge base
      description: >-
        Returns analytics on knowledge base search behavior, including the 10
        most frequently searched terms and the 10 most common searches that
        returned no results. This data helps identify content gaps and popular
        topics in the knowledge base.
      operationId: getKnowledgeSearches
      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: Search analytics retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  most_searched:
                    type: array
                    description: Top 10 most frequently searched terms across all searches.
                    items:
                      type: object
                      properties:
                        term:
                          type: string
                          description: The search term.
                          example: password reset
                        quantity:
                          type: integer
                          description: Number of times this term was searched.
                          example: 847
                  no_results:
                    type: array
                    description: >-
                      Top 10 most common search terms that returned zero
                      results, indicating potential content gaps.
                    items:
                      type: object
                      properties:
                        term:
                          type: string
                          description: The search term that found no matches.
                          example: api documentation
                        quantity:
                          type: integer
                          description: >-
                            Number of times this term was searched with no
                            results.
                          example: 94
        '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 'start'
        '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

````