Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brandfetch.com/llms.txt

Use this file to discover all available pages before exploring further.

If you have custom requirements, or any questions contact us.
The Brand Context API returns a structured, narrative-rich profile of a brand for a given domain. Where the Brand API focuses on a brand’s assets (logos, colors, fonts) and firmographics, the Brand Context API focuses on a brand’s identity, positioning, voice, and visual style — the kind of context useful for grounding LLMs, generating on-brand content, and powering personalized experiences. For each domain, the API returns:
  • Identity — tagline, mission, description, and tags.
  • Positioning — value proposition, target audience segments, and products & services.
  • Brand — a summary of the brand’s voice and visual style, with descriptive attributes.
Brand Context API works in real-time. If a brand is not part of our dataset, it will be resolved live, ensuring global coverage for businesses of all sizes, geographies, and industries.

​
Implementation guide

For more details, refer to our API Reference.
1

Get your API key

You’ll need to create an account on our Developer Portal. Creating an account is quick and easy, and will give you access to your dashboard where you’ll find your API key.
2

Make your first API call

Implement or run the code below to make your first API request.
curl --request GET \
--url https://api.brandfetch.io/v2/context/{domain} \
--header 'Authorization: Bearer <token>' \
--header 'Accept: application/json'
Authentication is done by passing your API key as a Bearer Authentication, the same way as the Brand API.
3

Test and deploy

All requests for the domain brandfetch.com are free and will not count towards your usage/quotas. You can make as many requests to Brandfetch’s own brand as you need while you iterate on and test your integration.Once you are ready to go live, simply replace brandfetch.com with the domain name you want to look up.

​
Query by domain

The Brand Context API is queried by domain name: 
curl --request GET \
--url https://api.brandfetch.io/v2/context/brandfetch.com \
--header 'Authorization: Bearer <token>' \
--header 'Accept: application/json'
If you only have company names, use the Brand Search API to match brand names to the most likely domains first.

​
Response shape

The response is grouped into a few top-level objects:
  • meta — the resolved domain, the canonical brand name, and the timestamp at which the context was resolved.
  • identity — tagline, mission, description, and a list of tags that characterize the brand.
  • positioning — the brand’s value_proposition, an array of target_audience segments (each with a segment and description), and an array of products_and_services (each with a name, type, and description).
  • brand
    • voice — a summary of the brand’s voice, descriptive attributes, and a list of things to avoid.
    • style — a summary of the brand’s visual style and descriptive attributes.

​
API Reference

For more details, refer to our API Reference.