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

# Get Share of Voice

> Returns competitor mention analysis and share of voice data



## OpenAPI

````yaml GET /share-of-voice
openapi: 3.0.3
info:
  title: Mentioned API
  description: API for accessing your competitor monitoring and Reddit visibility data
  version: 1.0.0
servers:
  - url: https://mentioned.to/api/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /share-of-voice:
    get:
      summary: Get share of voice
      description: Returns competitor mention analysis and share of voice data
      operationId: getShareOfVoice
      parameters:
        - name: start_date
          in: query
          description: Start date (ISO 8601 format)
          schema:
            type: string
            format: date
            example: '2025-01-01'
        - name: end_date
          in: query
          description: End date (ISO 8601 format)
          schema:
            type: string
            format: date
            example: '2025-01-31'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      results:
                        type: array
                        items:
                          $ref: '#/components/schemas/ShareOfVoiceResult'
                      total_mentions:
                        type: integer
                      date_range:
                        type: object
                        properties:
                          start:
                            type: string
                            format: date-time
                          end:
                            type: string
                            format: date-time
        '400':
          description: Invalid date format
        '401':
          description: Invalid or missing API key
components:
  schemas:
    ShareOfVoiceResult:
      type: object
      properties:
        competitor_id:
          type: integer
        competitor_name:
          type: string
        total_mentions:
          type: integer
        subreddit_breakdown:
          type: array
          items:
            type: object
            properties:
              subreddit:
                type: string
              mentions:
                type: integer
        posts:
          type: array
          items:
            type: object
            properties:
              id:
                type: integer
              title:
                type: string
              link:
                type: string
              snippet:
                type: string
              subreddit:
                type: string
              score:
                type: integer
              num_comments:
                type: integer
              date:
                type: string
                format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key from Settings > API. Format: `rm_live_xxx`'

````