Skip to main content

Brand voice generator API

Paste 3 to 10 of your own posts and get your brand voice: personality, audience, topics, tone and calls to action, each backed by quotes from your posts. Copy or download it as a guide, a system prompt for ChatGPT, Claude or your agent, or JSON.

  • Endpoint: POST https://postboost.co/app/api/tools/brand-voice-generator (operationId generateBrandVoice)
  • Web tool: postboost.co/tools/brand-voice-generator
  • Token: required. A new generation spends 1 AI credit of the workspace you name (or your active workspace); a repeated identical request is answered from the cache for free. A scoped API key needs the ai ability and pays with its own workspace
  • MCP: tool generate-brand-voice on https://postboost.co/mcp/tools (listed only with a token)

Request​

FieldTypeDefaultDescription
postsarray of stringYour own posts, one per item: 3 to 10 different posts of 20 to 3,200 characters, 20,000 in total. An exact copy counts once.
business_namestringYour business name, used as given (never generated).
industrystringYour industry, used as given (never generated).
workspacestringUUID of the workspace whose AI credits pay for the call. Default: your active workspace (a scoped API key: its own workspace).

Call it​

curl -X POST https://postboost.co/app/api/tools/brand-voice-generator \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"posts":["Monday fact: a cooled espresso shot loses most of its aroma in 3 minutes. Drink it while it'\''s warm ☕\n\nWhat'\''s your go-to morning order?","New on the shelf: our Ethiopia Guji, washed process. Think peach, black tea and a clean finish. Roasted on Tuesday, shipped on Wednesday.","We don'\''t do flavoured syrups. Good beans don'\''t need them. Ask us for a recommendation instead ☕","Brew guide, part 3: grind for the V60 should look like coarse sand. Too fine and it drips forever, too coarse and it tastes thin.\n\nSave this for your next pour-over.","Thank you for 5 years on Mill Street! Coffee is on us this Saturday from 8 to 10. Bring a friend."],"business_name":"Mill Street Roasters"}'

This tool needs a token: send Authorization: Bearer YOUR_API_TOKEN as a default header (how, per SDK).

Response​

{
"voice": {
"business_name": "Mill Street Roasters",
"mission": null,
"industry": null,
"personality": "A friendly neighbourhood roaster that teaches as it sells: short, warm and practical, proud of good beans and plain about brewing.",
"audience": [
"Home brewers",
"Local coffee drinkers"
],
"topics_preferred": [
"Brew guides",
"New single-origin coffees",
"Community events"
],
"topics_avoided": [
"Flavoured syrups"
],
"tone_formal": 2,
"tone_playful": 3,
"tone_technical": 3,
"emoji_style": "rare",
"hashtag_strategy": "none",
"avoid_words": [],
"preferred_cta": [
"Ask us for a recommendation",
"Save this for your next pour-over"
],
"example_posts": [
"Brew guide, part 3: grind for the V60 should look like coarse sand. Too fine and it drips forever, too coarse and it tastes thin.\n\nSave this for your next pour-over.",
"New on the shelf: our Ethiopia Guji, washed process. Think peach, black tea and a clean finish. Roasted on Tuesday, shipped on Wednesday."
]
},
"evidence": {
"personality": [
"Good beans don't need them.",
"Coffee is on us this Saturday"
],
"mission": [],
"audience": [
"Save this for your next pour-over."
],
"tone_formal": [
"Drink it while it's warm"
],
"tone_playful": [],
"tone_technical": [],
"emoji_style": [
"Drink it while it's warm ☕"
],
"hashtag_strategy": [],
"topics_preferred": [],
"topics_avoided": [
"We don't do flavoured syrups."
],
"avoid_words": [],
"preferred_cta": []
},
"system_prompt": "Use the following brand voice guidelines when generating content:\n\nBrand Identity:\n- Business: Mill Street Roasters\n- Personality: A friendly neighbourhood roaster that teaches as it sells: short, warm and practical, proud of good beans and plain about brewing.\n\nAudience & Topics:\n- Target audience: Home brewers, Local coffee drinkers\n- Preferred topics: Brew guides, New single-origin coffees, Community events\n- Topics to avoid: Flavoured syrups\n\nTone:\n- Use a casual tone.\n\nStyle:\n- Do not use any hashtags unless the user explicitly asks for them.\n- Use these calls-to-action when appropriate: Ask us for a recommendation, Save this for your next pour-over\n\nExample Posts:\n1. Brew guide, part 3: grind for the V60 should look like coarse sand. Too fine and it drips forever, too coarse and it tastes thin.\n\nSave this for your next pour-over.\n2. New on the shelf: our Ethiopia Guji, washed process. Think peach, black tea and a clean finish. Roasted on Tuesday, shipped on Wednesday.",
"markdown": "# Brand voice: Mill Street Roasters\n\n## Personality\n\nA friendly neighbourhood roaster that teaches as it sells: short, warm and practical, proud of good beans and plain about brewing.\n\n- Business: Mill Street Roasters\n\n> Good beans don't need them.\n\n> Coffee is on us this Saturday\n\n## Audience\n\n- Home brewers\n- Local coffee drinkers\n\n> Save this for your next pour-over.\n\n## Tone\n\n- Formality: 2 of 5 (casual)\n- Playfulness: 3 of 5 (neutral)\n- Technical language: 3 of 5 (neutral)\n\n> Drink it while it's warm\n\n## Emoji\n\nRare\n\n> Drink it while it's warm ☕\n\n## Hashtags\n\nNone\n\n## Topics\n\nPreferred:\n\n- Brew guides\n- New single-origin coffees\n- Community events\n\nAvoided:\n\n- Flavoured syrups\n\n> We don't do flavoured syrups.\n\n## CTAs\n\n- Ask us for a recommendation\n- Save this for your next pour-over\n\n## Examples\n\n> Brew guide, part 3: grind for the V60 should look like coarse sand. Too fine and it drips forever, too coarse and it tastes thin.\n>\n> Save this for your next pour-over.\n\n> New on the shelf: our Ethiopia Guji, washed process. Think peach, black tea and a clean finish. Roasted on Tuesday, shipped on Wednesday.\n\n## System prompt\n\n```text\nUse the following brand voice guidelines when generating content:\n\nBrand Identity:\n- Business: Mill Street Roasters\n- Personality: A friendly neighbourhood roaster that teaches as it sells: short, warm and practical, proud of good beans and plain about brewing.\n\nAudience & Topics:\n- Target audience: Home brewers, Local coffee drinkers\n- Preferred topics: Brew guides, New single-origin coffees, Community events\n- Topics to avoid: Flavoured syrups\n\nTone:\n- Use a casual tone.\n\nStyle:\n- Do not use any hashtags unless the user explicitly asks for them.\n- Use these calls-to-action when appropriate: Ask us for a recommendation, Save this for your next pour-over\n\nExample Posts:\n1. Brew guide, part 3: grind for the V60 should look like coarse sand. Too fine and it drips forever, too coarse and it tastes thin.\n\nSave this for your next pour-over.\n2. New on the shelf: our Ethiopia Guji, washed process. Think peach, black tea and a clean finish. Roasted on Tuesday, shipped on Wednesday.\n```\n",
"credits_spent": 1,
"cached": false
}

With MCP​

Connect https://postboost.co/mcp/tools (setup) and ask, for example: Derive a brand voice from 3 to 10 of your posts with AI: traits with quoted evidence, a guide, an AI system prompt and PostBoost brand voice JSON (needs a token, spends AI credits) with the PostBoost generate-brand-voice tool.

Errors​

StatusWhen
401No token, or an invalid one. The body has register_url to create a free account.
403workspace is not a workspace you belong to, or your account has no workspace, or a scoped API key lacks the ai ability or is bound to another workspace (code: insufficient_scope).
413The JSON body is larger than 128 KB.
422A field is invalid; the body lists the errors per field.
429The workspace has no AI credits left this billing cycle (code: ai_credits_exhausted, upgrade_url), or the per-minute limit is reached.
502The AI provider failed or timed out. No credit was spent.
503AI tools are switched off right now.