PEpeec
Brand Perception

Get Brand Perception Attribute Sources

Changed on

The sources feeding one attribute's associations: the URLs AI answers cited when describing the brand with this attribute. Data is aggregated across all brand-perception runs (no date range), and unlike the attribute rankings it is not scoped to one industry. An unknown attribute returns an empty result.

get/brand-perception/attribute-sources

Request

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

The attribute name, exactly as returned by the brand-attributes or attribute-rankings endpoints.

Example:Italian Heritage
model_channel_idsstring[]

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

field'occurrences' | 'retrievals' | 'citation_rate' required
direction'asc' | 'desc'
[
  {
    "field": "occurrences",
    "direction": "desc"
  }
]
limitinteger
offsetinteger

Response

Success

total_countnumber required

Total number of sources, ignoring pagination

Example response

{
  "data": [
    {
      "url": "https://www.ferrari.com/en-EN/history",
      "title": "Ferrari History",
      "domain": "ferrari.com",
      "url_classification": "OWNED",
      "domain_classification": "OWNED",
      "occurrences": 12,
      "retrievals": 34,
      "citation_rate": 1.4
    }
  ],
  "total_count": 42
}

Changes