---
title: "Get Brand Perception Competitive Breakdown"
method: GET
path: "/brand-perception/competitive-breakdown"
tags: ["Brand Perception"]
---

# Get Brand Perception Competitive Breakdown

`GET /brand-perception/competitive-breakdown`

## Request

- Base URL: `https://api.peec.ai/customer/v1`
- URL: `https://api.peec.ai/customer/v1/brand-perception/competitive-breakdown`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
  - HTTP bearer

The full competitive breakdown matrix: for every brand-perception attribute, the average prominence (0-100) of each brand — the project's own brand and its competitors — across AI answers. A higher score means the brand tends to be mentioned earlier when AI talks about that attribute. The data is aggregated across the brand-perception runs of one industry and one target market — there is no date range. Pass `industry` to pick the industry; omitted, it is the one with the most recent completed run. The target market is always the industry's most recently completed one and cannot be picked. Both are returned as `industry` and `target_market`. Pagination applies to attributes.

## Query parameters

- `project_id` string: Required if using a company api key
- `model_channel_ids` string[]: Only include answers from these AI engine channels (repeat the parameter for multiple values). Omit to aggregate across all tracked channels.
- `industry` string: Only read the runs dispatched for this industry, as returned by the brand-perception industries endpoint. Omit to read the industry marked `is_default` there — the one with the most recent completed run.
- `limit` integer
- `offset` integer

## Response `200`

Success

- object: Success
  - `data` object[], required: Attributes sorted by the own brand's score, strongest first.
    - `attribute` string, required: The attribute (cluster representative name).
    - `brands` object[], required: Brands sorted by score, most prominent first.
      - `name` string, required
      - `score` number, required: Average prominence of the brand for this attribute across AI answers, 0-100. Higher means the brand tends to be mentioned earlier when AI talks about the attribute.
      - `is_own` boolean, required: True when this is one of the project's own brands.
  - `total_count` number, required: Total number of attributes, ignoring pagination
  - `industry` string, nullable, required: The industry the data was read from; null when the project has no brand-perception runs yet.
  - `target_market` string, nullable, required: The target market the read narrowed to within that industry — its most recently completed one. Runs dispatched for the industry's other markets are not included.
  - `industries` object[]: Every industry the project has runs for, latest-started first — present only when there is more than one. Pass a name as `industry` to read that one instead.
    - `name` string, required
    - `has_completed_run` boolean, required: False while the industry's first run is still in flight, so its data is partial.

## Changes

- **2026-11-03** `9d774600c8eb`: 1 info
  - added the enum value `exa-0` to the property `items/` of the `query` request parameter `model_channel_ids`
- **2026-11-03** `9fdffdff48a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peec/apis/peec-ai-customer-api/changes/brand-perception/competitive-breakdown/get.md)

---

[API](https://skmtc.dev/peec/apis/peec-ai-customer-api.md) - [All operations](https://skmtc.dev/peec/apis/peec-ai-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peec/apis/peec-ai-customer-api/revisions/9d774600c8eb?raw)