Skip to main content
GET
/
v1
/
intelligence
/
brand-context
Get Brand Context
curl --request GET \
  --url https://app.uselamina.ai/v1/intelligence/brand-context \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "brandDna": {
      "voiceAttributes": [
        "bold",
        "confident",
        "playful"
      ],
      "visualIdentity": [
        "minimalist",
        "high-contrast",
        "warm tones"
      ],
      "contentPillars": [
        "product innovation",
        "sustainability",
        "community"
      ],
      "audienceSignals": [
        "Gen Z",
        "urban professionals",
        "eco-conscious"
      ],
      "guardrails": [
        "no political content",
        "avoid controversial topics"
      ],
      "toneSpectrum": {
        "primary": "energetic",
        "secondary": "witty",
        "avoid": [
          "corporate",
          "formal"
        ]
      },
      "performanceProfile": {
        "topPatterns": [
          "lifestyle imagery",
          "user-generated content style"
        ],
        "weakPatterns": [
          "stock photo aesthetic",
          "text-heavy posts"
        ],
        "avgEngagementTier": "high"
      }
    },
    "guidance": {
      "promptDirectives": [
        "Lead with bold colors and dynamic composition",
        "Include human subjects when possible"
      ],
      "negativePrompts": [
        "no text overlays",
        "avoid cluttered backgrounds"
      ],
      "recommendedMoves": [
        "Test carousel format",
        "Add behind-the-scenes content"
      ],
      "testIdeas": [
        "A/B test warm vs cool color palettes",
        "Try vertical video format"
      ],
      "winningPatterns": [
        "lifestyle imagery",
        "product-in-context shots"
      ],
      "weakPatterns": [
        "plain product shots on white background"
      ],
      "supportingMetrics": [
        "lifestyle posts avg 3.2x engagement",
        "video posts outperform static by 40%"
      ],
      "creativeStructure": null
    },
    "topPatterns": {
      "topItems": [
        {
          "id": "item-001",
          "title": "Summer Campaign Hero",
          "modality": "image",
          "platform": "instagram",
          "performanceScore": 92.5,
          "winningPatterns": [
            "lifestyle imagery",
            "warm tones",
            "human subjects"
          ]
        }
      ],
      "topPatterns": [
        {
          "pattern": "lifestyle imagery",
          "occurrences": 15,
          "avgPerformance": 88.3
        },
        {
          "pattern": "warm tones",
          "occurrences": 12,
          "avgPerformance": 85.7
        }
      ],
      "weakPatterns": [
        {
          "pattern": "stock photo aesthetic",
          "occurrences": 4,
          "avgPerformance": 32.1
        }
      ]
    }
  }
}
Retrieve the intelligence layer’s understanding of your brand: voice attributes, visual identity, content pillars, audience signals, guardrails, and performance patterns. The Creative Engine uses this context automatically when you call POST /v1/content/create. Use this endpoint when you want to inspect what the engine knows, feed brand data into your own pipelines, or build brand-aware agent prompts.

Authorizations

x-api-key
string
header
required

Workspace API key. Prefix: lma_. Example: lma_abc123...

Query Parameters

brandProfileId
string<uuid>

Scope to a specific brand profile. Omit for the workspace default.

campaignId
string<uuid>

Narrow guidance to a specific campaign.

workflowId
string<uuid>

Narrow guidance to a specific workflow/app.

platform
string

Target platform (e.g. instagram, tiktok, facebook, linkedin).

objective
string

Content objective (e.g. engagement, awareness, conversion).

modality
enum<string>

Content modality to optimize guidance for.

Available options:
image,
video,
text,
audio,
mixed
topK
integer
default:10

Number of top-performing items to include in the topPatterns section.

Response

Brand context package with DNA, guidance, and top patterns

data
object

Complete brand context package combining DNA, guidance, and top patterns.