---
title: "Get Brand Perception Attributes"
method: GET
path: "/brand-perception/brand-attributes"
tags: ["Brand Perception"]
---

# Get Brand Perception Attributes

`GET /brand-perception/brand-attributes`

## Request

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

How AI models describe the project's own brand: attribute clusters (e.g. "Luxury", "Racing Heritage") scored by average prominence per AI answer (0-100). The data is a snapshot of the latest brand-perception run — there is no date range. An empty result means the first run has not completed yet.

## 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.
- `limit` integer
- `offset` integer

## Response `200`

Success

- object: Success
  - `data` object[], required: Attributes sorted by score, most prominent first.
    - `name` string, required: The attribute's name.
    - `score` number, required: Average prominence per AI answer, 0-100. Higher means the attribute is mentioned earlier and more often when AI describes the brand.
    - `members` string[], required: The attribute's terms: the raw phrasings from AI answers grouped under it.
  - `total_count` number, required: Total number of attributes, ignoring pagination

## 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/brand-attributes/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)