Full Pipeline
Run the complete intelligence pipeline end-to-end: brand enrichment, competitor discovery, keyword universe, evidence collection, opportunity synthesis, and leverage scoring.
Triggers the full pipeline in sequence. This is the simplest way to analyze a brand — one call does everything.
Stages emitted (in order): brand_enrichment, competitor_discovery, family_discovery, evidence_collection, leverage_scoring, queue_building. The competitor_discovery stage is only emitted when the brand has no competitors set — if the brand already has competitors, the pipeline skips that stage silently. Opportunity synthesis runs inside evidence_collection and does not emit its own stage string. /analyze is the only pipeline trigger that emits stages; every other endpoint runs with meta.current_stage = null.
Duration: 15-30 minutes depending on keyword universe size.
Path parameters
brand_idstringrequiredThe brand UUID.
Response (202 Accepted)
{
"run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "queued"
}Poll GET /brands/{brand_id}/runs/{run_id} for progress.
Example
curl -X POST \
-H "X-API-Key: $BM_API_KEY" \
https://api.boringmarketing.com/brands/$BRAND_ID/analyzeReturns 409 Conflict if any other pipeline run is currently active for this brand — /analyze writes to every table, so it cannot run concurrently with anything else (including partial enrichment / discovery / scoring runs). Check the X-Running-Run-Id header for the existing run, then poll that instead. Active runs older than 15 minutes are auto-expired before the conflict check.