---
title: Insights
api: GET /brands/{brand_id}/insights
description: "Get brand findings from enrichment — trust gaps, E-E-A-T issues, content gaps, and technical issues."
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.boringmarketing.com/llms.txt). Append `.md` to any page URL for its markdown version.

Returns brand findings generated during brand enrichment. Each finding is categorized and severity-ranked.

## Path parameters

<ParamField path="brand_id" type="string" required>
  The brand UUID.
</ParamField>

## Query parameters

<ParamField query="category" type="string">
  Filter by category: `trust_gap`, `eeat_gap`, `content_gap`, `technical_gap`.
</ParamField>

<ParamField query="severity" type="string">
  Filter by severity: `high`, `medium`, `low`.
</ParamField>

<ParamField query="source" type="string">
  Filter by source: `brand_crawl`, `technical_audit`.
</ParamField>

<ParamField query="run_id" type="string">
  Pin to a specific pipeline run.
</ParamField>

## Response

```json
{
  "brand_id": "brand-uuid",
  "total": 12,
  "insights": [
    {
      "id": "insight-uuid",
      "text": "No Google reviews widget detected on homepage",
      "category": "trust_gap",
      "severity": "high",
      "source": "brand_crawl",
      "fixable": true,
      "fix_action": "Add Google Reviews embed to homepage"
    },
    {
      "id": "insight-uuid-2",
      "text": "Missing author bio on blog posts",
      "category": "eeat_gap",
      "severity": "medium",
      "source": "brand_crawl",
      "fixable": true,
      "fix_action": "Add structured author bios with credentials"
    }
  ]
}
```

## Example

```bash
curl -H "X-API-Key: $BM_API_KEY" \
  "https://api.boringmarketing.com/brands/$BRAND_ID/insights?category=trust_gap&severity=high"
```