Evidence

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

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

brand_idstringrequired

The brand UUID.

Query parameters

family_idstring

Filter by topic family UUID.

typestring

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

run_idstring

Pin to a specific pipeline run. Defaults to the latest completed run.

Response

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

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

Example

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

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.