# What is a brand context API?

> A brand context API returns what a model needs to work as a company: who it is, how it sounds, what it looks like, what to avoid. What you send and get back.

A brand context API returns what a model needs to write or design as a specific company. That includes who the company is, how it sounds, what it sells, what it looks like, what to avoid, and which files to use. You call the API before you call the model. Then you put the result into the prompt, or you give it to an agent.

"Brand Context API" is also the name of one product: `GET /v2/context/{domain}` from Brandfetch. It returns a profile of any company from the website of the company. This site covers that product and seven other endpoints that return parts of the same information. Each endpoint was called for the same company, linear.app.

## What do you send?

The input depends on whose brand it is.

- Any company, by domain. Brandfetch, Context.dev, and Logo.dev take a domain. Brandfetch and Context.dev also take an email or a page address. Firecrawl takes the address of one page. You do not set up anything first, because these APIs read the public website.
- A brand that you or your customer added. Rainbrand takes the ID of a brand that someone added from sources such as a website, a brand guide, or files. A [Brief](https://brandcontextapi.com/responses/rainbrand-brief) also takes the task, in plain words. A [Brand Skill](https://brandcontextapi.com/responses/rainbrand-brand-skill) returns the whole brand.

## What comes back?

| Part | Example from linear.app | Fields page |
| --- | --- | --- |
| Name and description | "The product development system for teams and agents." | [Name and description](https://brandcontextapi.com/fields/name-and-description) |
| Voice | "precise", "measured", and avoid "breathless hype" | [Voice and tone](https://brandcontextapi.com/fields/voice-and-tone) |
| Positioning | Three audience segments, five products, four competitors | [Positioning](https://brandcontextapi.com/fields/positioning) |
| Look | Colors, fonts, type sizes, button styles | [Colors](https://brandcontextapi.com/fields/colors), [Type](https://brandcontextapi.com/fields/type) |
| Files | Logos for light and dark backgrounds, banners, font files | [Logos](https://brandcontextapi.com/fields/logos), [Images and files](https://brandcontextapi.com/fields/images-and-files) |
| Rules | Write "Linear" with a capital L. Keep the logo artwork intact | [Rules and claims](https://brandcontextapi.com/fields/rules-and-claims) |
| Date or version | Read on 16 October. Brand Skill version `e16b6239…` | [Dates and versions](https://brandcontextapi.com/fields/dates-and-versions) |

No endpoint returned all of these parts. The [coverage chart](https://brandcontextapi.com/fields) shows which endpoint returned which part.

## Is that not a logo API?

A logo API returns files, for example to show the logo of a company in a list. The API of a digital asset manager returns the stored files of a company, with their rights. A brand context API returns what a model needs to act, and that is mostly words: descriptions, voice, and rules. Some products do more than one of these jobs. [The Brand API Register](https://brandapis.com) compares brand APIs product by product, with plans and limits. This site shows what their brand context endpoints send back.

## Where does the Brandfetch Brand Context API fit?

It is the only observed endpoint on this site that returned voice, positioning, products with prices, and competitors in one call. Observed means that the API reads the public website. The Brand Context API returns no color values and no files, but the Brandfetch Brand API does. The page [Brandfetch Brand Context API alternatives](https://brandcontextapi.com/brandfetch-brand-context-api-alternatives) shows what else covers the same information.

## How do you pass it to a model?

Pick the fields that the task needs. Write them as instructions, and keep the date. The [recipes](https://brandcontextapi.com/recipes) show how, in TypeScript and Python. The [templates](https://brandcontextapi.com/templates) give a schema and a prompt to copy.

---

Source: https://brandcontextapi.com/what-is-a-brand-context-api
Last updated: 2026-11-12
Published by The Brand Object. The Brand Object is run by Rainbrand, which makes two of the endpoints described here. Their pages follow the same rules as the others.