---
title: Evidence
api: GET /brands/{brand_id}/evidence
description: "Get raw SERP evidence, citation data, technical audit findings, and competitive signals collected during pipeline runs."
---

> **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 the typed evidence objects collected during the pipeline. Every opportunity, insight, and leverage score traces back to this evidence layer — it is the full audit trail for anything the pipeline produces.

## Path parameters

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

## Query parameters

<ParamField query="family_id" type="string">
  Filter by topic family UUID.
</ParamField>

<ParamField query="type" type="string">
  Filter by evidence type. Supported values:

  - `serp_pattern` — organic SERP competitive patterns
  - `gap_signal` — missing topic or content gap
  - `pain_signal` — user pain points extracted from SERPs
  - `competitive_pattern` — competitor domain patterns
  - `content_pattern` — content-type patterns across a family
  - `llm_gap` — LLM citation gap
  - `llm_citation` — LLM citation event
  - `technical_issue` — technical audit finding
</ParamField>

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

## Response

```json
{
  "brand_id": "brand-uuid",
  "total": 156,
  "evidence": [
    {
      "evidence_id": "ev-uuid",
      "brand_id": "brand-uuid",
      "run_id": "run-uuid",
      "family_id": "family-uuid",
      "family_name": "Marketing Automation",
      "evidence_type": "gap_signal",
      "signal": {
        "brand_position": "absent",
        "competitor_domains": ["hubspot.com", "mailchimp.com"],
        "pattern_strength": 0.92
      },
      "sources": [
        {
          "domain": "google.com",
          "query": "best marketing automation tools",
          "position": null
        }
      ],
      "created_at": "2026-04-08T12:00:00Z"
    }
  ]
}
```

The `signal` and `sources` shapes are evidence-type-specific and may add or remove keys without notice — treat the inner objects as advisory and tolerate unknown keys.

## Single-evidence lookup

Fetch a single evidence object by ID:

```bash
curl -H "X-API-Key: $BM_API_KEY" \
  https://api.boringmarketing.com/brands/$BRAND_ID/evidence/$EVIDENCE_ID
```

## Example

```bash
curl -H "X-API-Key: $BM_API_KEY" \
  "https://api.boringmarketing.com/brands/$BRAND_ID/evidence?family_id=family-uuid&type=gap_signal"
```

<Tip>
Every opportunity has a `contributing_signals` array that references these evidence objects. Cross-reference to see exactly which SERP, citation, or technical finding produced a given recommendation.
</Tip>