PEpeec
Brand Perception

Get Brand Perception Attributes

Changed on

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.

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
    • API key in header X-API-Key
    • or API key in query parameter api_key
    • or HTTP bearer

Query parameters

project_idstring

Required if using a company api key

Example:or_f45b94ba-5e35-4982-93ed-285e72ee14eb
model_channel_idsstring[]

Only include answers from these AI engine channels (repeat the parameter for multiple values). Omit to aggregate across all tracked channels.

limitinteger
offsetinteger

Response

Success

total_countnumber required

Total number of attributes, ignoring pagination

Example response

{
  "data": [
    {
      "name": "Luxury",
      "score": 67,
      "members": [
        "luxury",
        "prestige",
        "exclusivity"
      ]
    }
  ],
  "total_count": 8
}

Changes