List Briefs

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

Returns all content briefs generated for a brand.

Path parameters

brand_idstringrequired

The brand UUID.

Response

{
  "brand_id": "brand-uuid",
  "total": 3,
  "briefs": [
    {
      "id": "brief-uuid",
      "queue_item_id": "qi-uuid-1",
      "format": "comparison",
      "content": {
        "strategy": "Position as the definitive comparison guide for AI marketing tools",
        "pages": [
          {
            "title": "Best AI Marketing Tools in 2026: Complete Comparison",
            "slug": "best-ai-marketing-tools",
            "target_keywords": ["ai marketing tools", "best ai marketing software"],
            "sections": [
              {
                "heading": "What Makes a Great AI Marketing Tool",
                "guidance": "Define evaluation criteria...",
                "estimated_words": 400
              }
            ]
          }
        ],
        "internal_links": [
          { "anchor": "content automation", "target": "/guides/content-automation" }
        ],
        "key_entities": ["HubSpot", "Jasper", "Semrush"],
        "competitive_angle": "Focus on closed-loop measurement — competitors show dashboards, we show outcomes"
      },
      "created_at": "2026-04-07T10:30:00Z"
    }
  ]
}

The content shape mirrors whatever the current brief generator emits — it is not a stable API contract. The example above shows the typical fields (strategy, pages[], internal_links, key_entities, competitive_angle) but new keys may appear or be reshaped between deployments. Tolerate unknown keys when consuming briefs.

Example

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