PEpeec
Brand Perception

Get Brand Perception Attribute History

Changed on

How one brand's prominence on each brand-perception attribute has moved over time: one series per attribute, each point a day and the brand's average prominence (0-100) across that day's AI answers about the attribute. These are the same scores as the competitive breakdown, split by day instead of aggregated. The brand defaults to the project's own brand. The data covers the brand-perception runs of one industry and one target market. 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.

get/brand-perception/attribute-history

Request

  • Base URL
    https://api.peec.ai/customer/v1
  • URL
    https://api.peec.ai/customer/v1/brand-perception/attribute-history
  • 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
brandstring

The brand whose history to read, spelled as the competitive-breakdown endpoint reports it. Omit to read the project's own brand.

Example:Porsche
model_channel_idsstring[]

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

industrystring

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.

Example:Luxury Sports Cars
limitinteger
offsetinteger

Response

Success

total_countnumber required

Total number of attributes, ignoring pagination

brandstring nullable required

The brand the series describe; null when no brand was passed and the project has no own brand.

industrystring nullable required

The industry the data was read from; null when the project has no brand-perception runs yet.

target_marketstring 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.

Example response

{
  "data": [
    {
      "attribute": "Racing Heritage",
      "points": [
        {
          "date": "2026-09-01",
          "score": 29
        }
      ]
    }
  ],
  "total_count": 8,
  "brand": "Ferrari",
  "industry": "Luxury Sports Cars",
  "target_market": "Germany",
  "industries": [
    {
      "name": "Athleisure"
    }
  ]
}

Changes