---
title: "Get competitors mentioned"
method: GET
path: "/api/v1/analysis/{uuid}/competitors"
tags: ["Analysis"]
---

# Get competitors mentioned

`GET /api/v1/analysis/{uuid}/competitors`

## Request

- Base URL: `https://botsee.io`
- URL: `https://botsee.io/api/v1/analysis/{uuid}/competitors`
- Auth: HTTP bearer

Returns competitors mentioned in responses, grouped by customer type. Each competitor includes appearance percentage (% of responses mentioning them), mentions count, average ranking, and confidence scores.

## Path parameters

- `uuid` string, required

## Response `200`

Successful response.

- object
  - `by_customer_type` object[]
    - `competitors` object[]
      - `appearance_percentage` number
      - `avg_confidence` number
      - `avg_rank` number
      - `best_rank` integer
      - `mentions` integer
      - `name` string
      - `unique_responses` integer
      - `url` string
    - `customer_type_name` string
    - `customer_type_uuid` string
    - `total_responses` integer
    - `total_unique_competitors` integer
  - `overall_summary` object
    - `own_company_mentioned` boolean
    - `total_responses_analyzed` integer
    - `total_unique_competitors` integer

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but lacks permission (e.g. botsee_disabled).
- `404`: The requested resource does not exist or is not accessible.
- `422`: Request body or parameters failed validation.
- `429`: Too many requests. Wait and retry per Retry-After header.

---

[API](https://skmtc.dev/botsee/apis/botsee-api.md) · [All operations](https://skmtc.dev/botsee/apis/botsee-api/llms.txt) · [OpenAPI document](https://skmtc.dev/botsee/apis/botsee-api/revisions/f815b844e73b?raw)