Boring Marketingdocs

Insights

Get brand findings from enrichment — trust gaps, E-E-A-T issues, content gaps, and technical issues.

GEThttps://api.boringmarketing.com/brands/{brand_id}/insights

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

Path parameters

brand_idstringrequired

The brand UUID.

Query parameters

categorystring

Filter by category: trust_gap, eeat_gap, content_gap, technical_gap.

severitystring

Filter by severity: high, medium, low.

sourcestring

Filter by source: brand_crawl, technical_audit.

run_idstring

Pin to a specific pipeline run.

Response

{
  "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

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