PEpeec
Brand Perception

Get Brand Perception Competitive Breakdown

Changed on

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.

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

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

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",
      "brands": [
        {
          "name": "Ferrari",
          "score": 29
        }
      ]
    }
  ],
  "total_count": 8,
  "industry": "Luxury Sports Cars",
  "target_market": "Germany",
  "industries": [
    {
      "name": "Athleisure"
    }
  ]
}

Changes