Ground AI in real brand data
The profile the API returns is already grounded: tagline, mission, value proposition, products, target audiences, and voice guidance, verified brand data in one document. Using it is one call and one prompt: fetch it as Markdown, put it in the system prompt, and the model answers from the brand’s verified facts instead of training data. The example uses Claude, but the pattern is identical for any model.- Preview
- Code
Why not just ask the model?
A good LLM can describe famous brands from memory, so it’s fair to ask what the API adds. Five things:- Long-tail coverage. Models are weak on small businesses, regional companies, and brands that launched or rebranded after their training cutoff. Brand Context resolves domains live when they’re not yet in the dataset, so coverage extends to brands no model’s memory holds.
- Consistent structure at scale. Run enrichment over 10,000 companies and you need the same fields back every time. Request
Accept: application/jsonand every response follows the same schema: no reformatting between calls, no invented fields, no phrasing drift. At scale, that consistency is the product. - Cost and latency. A cached, deterministic API call is faster and cheaper than an LLM inference per lookup, and the difference compounds when you’re personalizing 50,000 landing pages by visitor domain.
- Freshness. Taglines, audiences, and messaging get updated by marketing teams all the time. A live-resolved profile reflects this month’s positioning; a model reflects whatever was true when it was trained.
- Auditability. Every response is tied to a fetchable source rather than a model’s recollection, and for compliance-sensitive tools in sales or finance, “the model guessed” isn’t good enough.
Implementation
1
Fetch the context
One call returns the brand profile, in Markdown by default, ready for a prompt. Keep it server-side so the API key stays secret, and cache by domain.
2
Inject it into the model
Add the profile to the system prompt or retrieval context before the model answers. Prefer structured fields over Markdown? Request
Accept: application/json, see content negotiation.Brandfetch MCP
Already building with an AI assistant or agent framework? The Brandfetch MCP server exposes brand lookups as tools your model can call directly, so an agent can fetch a company’s logo, colors, and profile mid-conversation without you wiring up the APIs by hand.Brandfetch MCP
Connect the MCP server and give your agent brand lookups as ready-made tools.
Pricing
Requests to the Brand Context API count as brand fetches, the shared usage unit across the Brand API, Brand Context API, and Transaction API, one quota pool covers all three. Caching by domain keeps repeat questions about the same company free.Measuring impact
Grounding is easiest to judge on answer quality: track how often the model returns accurate, on-brand facts instead of stale or invented ones, and watch guesses give way to grounded answers for brands the model previously got wrong. Synthesia generates an entire brand kit from nothing but a company URL this way, and the same grounding works for any generation flow.Going further
Brand Context API reference
The exact response shape: identity, positioning, products, and style.
Brandfetch MCP
Brand lookups as ready-made tools for AI assistants and agents.
Get started
Create a free account and start building.