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(operationIdgenerateBrandVoice) - 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
aiability and pays with its own workspace - MCP: tool
generate-brand-voiceonhttps://postboost.co/mcp/tools(listed only with a token)
Request
| Field | Type | Default | Description |
|---|---|---|---|
posts | array of string | Your 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_name | string | Your business name, used as given (never generated). | |
industry | string | Your industry, used as given (never generated). | |
workspace | string | UUID of the workspace whose AI credits pay for the call. Default: your active workspace (a scoped API key: its own workspace). |
Call it
- curl
- Python
- Node.js
- PHP
- Go
- Ruby
- Java
- C#
- Rust
- CLI
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"}'
from postboost import ApiClient, Configuration
from postboost.api.free_tools_api import FreeToolsApi
from postboost.models import FreeToolGenerateBrandVoiceRequest
with ApiClient(Configuration()) as client:
api = FreeToolsApi(client)
result = api.generate_brand_voice(FreeToolGenerateBrandVoiceRequest.from_dict({"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"}))
print(result.to_dict())
import { FreeToolsApi } from 'postboost';
const api = new FreeToolsApi();
const { body } = await api.generateBrandVoice({ 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."], businessName: "Mill Street Roasters" });
console.log(body);
use PostBoostClient\Api\FreeToolsApi;
use PostBoostClient\Model\FreeToolGenerateBrandVoiceRequest;
$api = new FreeToolsApi(new GuzzleHttp\Client());
$result = $api->generateBrandVoice(new FreeToolGenerateBrandVoiceRequest(['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"]));
echo $result;
import (
"context"
"encoding/json"
"fmt"
postboost "github.com/postboost-co/postboost-go"
)
var request postboost.FreeToolGenerateBrandVoiceRequest
if err := json.Unmarshal([]byte(`{"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"}`), &request); err != nil {
panic(err)
}
client := postboost.NewAPIClient(postboost.NewConfiguration())
result, _, err := client.FreeToolsAPI.GenerateBrandVoice(context.Background()).FreeToolGenerateBrandVoiceRequest(request).Execute()
fmt.Println(result, err)
require 'postboost'
api = PostBoost::FreeToolsApi.new
result = api.generate_brand_voice(PostBoost::FreeToolGenerateBrandVoiceRequest.new({ 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" }))
puts result.to_hash
import com.postboost.ApiClient;
import com.postboost.api.FreeToolsApi;
import com.postboost.model.FreeToolGenerateBrandVoiceRequest;
import com.postboost.model.FreeToolGenerateBrandVoiceResponse;
FreeToolsApi api = new FreeToolsApi(new ApiClient());
FreeToolGenerateBrandVoiceRequest request = FreeToolGenerateBrandVoiceRequest.fromJson("{\"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\"}");
FreeToolGenerateBrandVoiceResponse result = api.generateBrandVoice(request);
System.out.println(result.toJson());
using Newtonsoft.Json;
using PostBoost.Client.Api;
using PostBoost.Client.Client;
using PostBoost.Client.Model;
var api = new FreeToolsApi(new Configuration());
var request = JsonConvert.DeserializeObject<FreeToolGenerateBrandVoiceRequest>(@"{""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""}");
var result = await api.GenerateBrandVoiceAsync(request);
Console.WriteLine(result.ToJson());
use postboost::apis::configuration::Configuration;
use postboost::apis::free_tools_api;
use postboost::models::FreeToolGenerateBrandVoiceRequest;
let config = Configuration::new();
let request: FreeToolGenerateBrandVoiceRequest = serde_json::from_str(r##"{"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"}"##)?;
let result = free_tools_api::generate_brand_voice(&config, request).await?;
println!("{:?}", result);
echo '{"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"}' | ./postboost-cli --content-type application/json generateBrandVoice -
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
| Status | When |
|---|---|
401 | No token, or an invalid one. The body has register_url to create a free account. |
403 | workspace 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). |
413 | The JSON body is larger than 128 KB. |
422 | A field is invalid; the body lists the errors per field. |
429 | The workspace has no AI credits left this billing cycle (code: ai_credits_exhausted, upgrade_url), or the per-minute limit is reached. |
502 | The AI provider failed or timed out. No credit was spent. |
503 | AI tools are switched off right now. |