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

# Get Competitors

> Get competitors visibility leaderboard.



## OpenAPI

````yaml get /competitors
openapi: 3.1.0
info:
  title: Geogen API
  description: >-
    API for accessing LLM visibility data, managing entities, and tracking AI
    mentions.
  version: 1.0.0
servers:
  - url: https://api.geogen.io/v1
    description: Production server
security:
  - bearerAuth: []
paths:
  /competitors:
    get:
      tags:
        - Analytics
      summary: Get Competitors
      description: >-
        Get competitors visibility leaderboard.


        **Domain groups:** if the queried entity or any of its competitors
        belongs to a domain group in this workspace, entities sharing the same
        group are collapsed into a single row in the leaderboard, with mentions
        summed and avg position/sentiment computed as a mention-weighted
        average. The merged row reports the group's primary entity identity and
        includes `groupName` and `groupEntityUuids` so clients can render a
        badge.
      operationId: getCompetitors
      parameters:
        - name: entityId
          in: query
          required: true
          schema:
            type: string
          description: Entity ID
        - name: period
          in: query
          required: false
          schema:
            type: string
            enum:
              - 7d
              - 14d
              - 30d
          description: Time period
        - name: models
          in: query
          required: false
          schema:
            type: string
          description: Comma-separated model UUIDs
        - name: limit
          in: query
          required: false
          schema:
            type: number
          description: Results per page
        - name: offset
          in: query
          required: false
          schema:
            type: number
          description: Pagination offset
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        rank:
                          type: number
                        entityUuid:
                          type: string
                          description: >-
                            Entity UUID. For merged group rows, the primary
                            entity's UUID.
                        domain:
                          type: string
                        name:
                          type: string
                        visibility:
                          type: number
                          description: >-
                            Percentage of responses mentioning this entity (or
                            any member of its domain group).
                        mentions:
                          type: number
                          description: >-
                            Total number of mentions (summed across the domain
                            group when applicable).
                        avgPosition:
                          type: number
                          nullable: true
                          description: >-
                            Mention-weighted average position across the domain
                            group.
                        avgSentiment:
                          type: number
                          nullable: true
                          description: >-
                            Mention-weighted average sentiment across the domain
                            group.
                        isCurrentEntity:
                          type: boolean
                          description: >-
                            True if this row represents the queried entity or
                            any of its domain-group siblings.
                        groupName:
                          type: string
                          description: >-
                            Present only when the row was assembled from a
                            domain group; the group's display name.
                        groupEntityUuids:
                          type: array
                          items:
                            type: string
                          description: >-
                            Present only when the row was assembled from a
                            domain group; all entity UUIDs that merged into this
                            row.
                  pagination:
                    $ref: '#/components/schemas/Pagination'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Pagination:
      type: object
      properties:
        total:
          type: number
          description: Total count
        limit:
          type: number
          description: Items per page
        offset:
          type: number
          description: Current offset
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key authentication. Format: Bearer wsk_your_api_key'

````