get_brand_voice

Get brand voice guidelines, company profile, and writing style for content that matches the brand's tone.

Get brand voice guidelines, company profile, and writing style for a brand. Use this to write content that matches the brand's tone, personality, and positioning.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent ID to get brand voice for.

Response

{
  "syntheticId": 1234,
  "brandName": "Example",
  "brandVoice": {
    "voiceSummary": "Confident but approachable. Technical depth without jargon.",
    "coreToneTraits": ["authoritative", "helpful", "direct"],
    "styleGuide": {
      "sentenceLength": "Mix short and medium. Avoid run-ons.",
      "vocabulary": "Use industry terms but explain them on first use.",
      "formatting": "Use headers, bullet points, and short paragraphs."
    },
    "emotionalToneTargets": ["empowered", "informed", "confident"],
    "storytellingStyle": "Data-first narratives with real examples.",
    "examples": [...],
    "writingExamples": [...]
  },
  "companyProfile": {
    "name": "Example Inc.",
    "tagline": "Make AI work for your brand",
    "industry": "MarTech / AI",
    "description": "Example helps businesses monitor and improve their AI visibility.",
    "missionStatement": "...",
    "productsOrServices": [...],
    "targetAudience": {
      "demographics": "Marketing leaders and founders at B2B SaaS companies",
      "segments": [...]
    },
    "brandPersonality": ["innovative", "trustworthy", "data-driven"],
    "competitorsOrPeers": ["CompetitorA", "CompetitorB"],
    "uniqueValueProposition": "...",
    "geographicFocus": "Global, primarily US and EU",
    "toneExamples": [...]
  }
}

Key fields

Brand Voice

Field	Description
`voiceSummary`	One-line summary of the brand's writing voice
`coreToneTraits`	Array of tone adjectives (e.g., "authoritative", "helpful")
`styleGuide`	Writing style preferences: sentence length, vocabulary, formatting
`writingExamples`	Sample text that exemplifies the brand voice

Company Profile

Field	Description
`tagline`	Brand's tagline or value proposition
`industry`	Industry or market category
`targetAudience`	Who the brand serves — demographics and segments
`competitorsOrPeers`	Known competitors or peer companies
`uniqueValueProposition`	What differentiates this brand

Either brandVoice or companyProfile may be null if the brand hasn't completed onboarding for that data.

Parameters

Response

Key fields

Brand Voice

Company Profile

On this page