---
title: "List Brand Perception Attribute Clusters"
method: GET
path: "/brand-perception/attribute-clusters"
tags: ["Brand Perception"]
---

# List Brand Perception Attribute Clusters

`GET /brand-perception/attribute-clusters`

## Request

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

The project's brand-perception attribute taxonomy: every attribute with its id, name and terms (the raw phrasings from AI answers grouped under it), plus the unassigned terms no attribute claims. Unlike the brand-attributes endpoint this is the editable grouping rather than the scored snapshot, so it also lists attributes that carry no score yet. Use it to resolve the `cluster_id` values the edit endpoint takes and the create endpoint returns.

## Query parameters

- `project_id` string: Required if using a company api key
- `limit` integer
- `offset` integer

## Response `200`

Success

- object: Success
  - `data` object[], required: Attributes sorted by name.
    - `cluster_id` string, required: Stable id of the attribute. Pass it to the edit endpoint; it survives renames.
    - `name` string, required: The attribute's name, as the Market view and the brand-perception reads show it.
    - `is_custom` boolean, required: True when a user added the attribute by hand rather than Peec extracting it from AI answers.
    - `members` string[], required: The attribute's terms: raw phrasings from AI answers grouped under it, alphabetically sorted.
  - `total_count` number, required: Total number of attributes, ignoring pagination
  - `unassigned` string[], required: Terms that belong to no attribute yet. Move one into an attribute to give it a home. Not paginated.

## Changes

- **2026-11-03** `9fdffdff48a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peec/apis/peec-ai-customer-api/changes/brand-perception/attribute-clusters/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)