# The Brand Object > What brand context APIs return, field by field What brand context APIs return: Brandfetch's Brand Context API, Context.dev, Firecrawl, Logo.dev, and Rainbrand, with real responses marked up field by field. ## When to use this site - To see what a brand context endpoint returns before you call it: the request, the full response for one company (linear.app), and what each field holds. - To find which endpoint returns a part of brand context, such as voice, colors, type, logos, rules, or a version, and the key that holds it. - To look up the Brandfetch Brand Context API: its request, response, errors, and plans, and its alternatives. - To pick a brand context API for a job, such as prospect research, a site's styles, work under your own brand, or the brands of your customers. - To pass brand context to a model: the system prompt, JSON or Markdown, caching, versions, and slow or empty responses, with TypeScript and Python code. - To copy a brand context JSON Schema that is not tied to one vendor, and adapters that map the response of each endpoint to it. - Not for live brand data about a company. The site shows responses from a stated date, and it does not call the APIs. Every page is also available as Markdown: add `.md` to its address, or request it with `Accept: text/markdown`. The facts behind the pages, each with its source, are in [data.json](https://brandcontextapi.com/data.json). Facts were last checked on 2026-11-11. ## Pages - [What does a brand context API return?](https://brandcontextapi.com/index.md): What brand context APIs return, field by field: Brandfetch's Brand Context API, Context.dev, Firecrawl, Logo.dev, and Rainbrand, all called for Linear. ## About - [About The Brand Object](https://brandcontextapi.com/about.md): How The Brand Object calls each endpoint, how it makes sure that each fact matches its source, who runs the site, and how to report a mistake for correction. - [Change log](https://brandcontextapi.com/changes.md): Every change to the facts and responses on The Brand Object, with its date. We list each correction after we compare it with the documentation of the vendor. ## Fields - [Fields](https://brandcontextapi.com/fields.md): Brand context split into ten fields, from voice to versions. For each field, the endpoints that return it, the key that holds it, and how to pass it on. - [Name and description](https://brandcontextapi.com/fields/name-and-description.md): How each brand context API describes the company: names, taglines, short and long descriptions for linear.app, and the descriptions that were out of date. - [Voice and tone](https://brandcontextapi.com/fields/voice-and-tone.md): Which brand context APIs return the voice of a brand, in what form, and how to pass it to a model: a Brandfetch summary, Firecrawl words, a Rainbrand guide. - [Positioning, audience and competitors](https://brandcontextapi.com/fields/positioning.md): What brand context APIs say about who a company sells to, what it sells, and who it competes with, from Brandfetch's products to one word from Firecrawl. - [Logos](https://brandcontextapi.com/fields/logos.md): Logo files from six brand context APIs for linear.app: formats, sizes, light and dark versions, inline SVG, links that expire, and the rules for their use. - [Colors](https://brandcontextapi.com/fields/colors.md): The colors of Linear as six brand context APIs returned them on one day: four different main colors, generated color names, and the colors that are official. - [Type](https://brandcontextapi.com/fields/type.md): Fonts and type sizes from brand context APIs for linear.app: font names, heading sizes that disagree, and font files that you can ship only with a license. - [Spacing and components](https://brandcontextapi.com/fields/spacing-and-components.md): Spacing units, radii, shadows and button styles from brand context APIs for linear.app: what Context.dev's Styleguide and Firecrawl return, and how they differ. - [Rules and claims](https://brandcontextapi.com/fields/rules-and-claims.md): What brand context APIs say that a model must not do: the Brandfetch avoid list, the Rainbrand naming, logo and claim rules, and why observed APIs have few. - [Images and files](https://brandcontextapi.com/fields/images-and-files.md): Which files brand context APIs return besides the logo: banners, backdrops, font files, screenshots and Brand Skill assets, and how long their links work. - [Dates and versions](https://brandcontextapi.com/fields/dates-and-versions.md): How brand context APIs show how current a response is: read dates, cache ages, index dates and version IDs. For linear.app, the dates ran from September on. ## Recipes - [Recipes](https://brandcontextapi.com/recipes.md): Code that passes brand context to a model, in TypeScript and Python: prompts, JSON or Markdown, caching, failures, prospects, customers and agents. - [Brand context in a system prompt](https://brandcontextapi.com/recipes/system-prompt.md): Turn a brand context response into a system prompt: which fields to include, how to word them as instructions, and code in TypeScript and Python for Brandfetch. - [JSON or Markdown?](https://brandcontextapi.com/recipes/json-or-markdown.md): When to ask a brand context API for Markdown and when to keep JSON: Brandfetch offers both, Rainbrand's guidance is Markdown inside JSON, the rest is JSON. - [Cache, refresh and pin a version](https://brandcontextapi.com/recipes/cache-refresh-and-pin.md): How old each brand context API's data can be, what its docs say about storing it, when to ask again, and how to record which context a piece of work used. - [Slow, empty and failed responses](https://brandcontextapi.com/recipes/slow-empty-and-failed-responses.md): Handle the responses that are not a 200: the Brandfetch 503 while it builds a profile, the Logo.dev 202 while it indexes, cache misses and rate limits. - [Personalize for a prospect's brand](https://brandcontextapi.com/recipes/personalize-for-a-prospect.md): Use observed brand context to write to a company that you do not work with yet: from a work email to a first line in its terms, with code and limits. - [Customer brands in your product's jobs](https://brandcontextapi.com/recipes/customer-brands-in-your-product.md): For products that make work for their customers' brands: an observed lookup at signup, then each customer's own brand context for every job, with code. - [Brand context for agents over MCP](https://brandcontextapi.com/recipes/agents-over-mcp.md): Which brand context APIs have a Model Context Protocol server for Claude, ChatGPT or Cursor, the tools each one has, how they sign in, and what agents get back. ## Responses - [Responses](https://brandcontextapi.com/responses.md): Eight brand context endpoints, each called for linear.app on 11 November 2026: the request, the full response marked up field by field, failures and plans. - [Brandfetch Brand Context API](https://brandcontextapi.com/responses/brandfetch-brand-context-api.md): The request and full response of Brandfetch's Brand Context API for linear.app, marked up field by field, with its errors, caching, plans and missing parts. - [Brandfetch Brand API](https://brandcontextapi.com/responses/brandfetch-brand-api.md): The request and full response of Brandfetch's Brand API for linear.app: logos by theme and format, two colors, a custom font name, errors and plans. - [Context.dev Brand](https://brandcontextapi.com/responses/context-dev-brand.md): The request and full response of Context.dev's Brand endpoint for linear.app: named colors, logos tagged by background, backdrops, cache age and plans. - [Context.dev Styleguide](https://brandcontextapi.com/responses/context-dev-styleguide.md): The request and response of Context.dev's Styleguide for linear.app: color roles, type per heading, spacing, button and card styles, and font files. - [Firecrawl branding format](https://brandcontextapi.com/responses/firecrawl-branding.md): The request and response of Firecrawl's branding format for linear.app: colors, fonts, sizes, components, an inline logo, personality and confidence. - [Logo.dev Brand API](https://brandcontextapi.com/responses/logo-dev-brand-api.md): The request and full response of Logo.dev's Brand API for linear.app: a logo and brandmark on links that expire, colors in hex and OKLCH, and billing. - [Rainbrand Brief](https://brandcontextapi.com/responses/rainbrand-brief.md): The request and response of a Rainbrand Brief for a Linear task: guidance written for the task, the assets selected, the version used, failures, plans. - [Rainbrand Brand Skill](https://brandcontextapi.com/responses/rainbrand-brand-skill.md): What a read of a whole Brand Skill from Rainbrand returns for Linear: a grouped palette, type roles, a logo catalog, guidance files and a version ID. ## Start here - [What is a brand context API?](https://brandcontextapi.com/what-is-a-brand-context-api.md): 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. - [Which brand context API do you need?](https://brandcontextapi.com/which-brand-context-api.md): One pick per job: prospect research, logos for a list, a site's CSS, work under your own brand, a product serving customers' brands, an agency's clients. - [Observed or maintained: where does brand context come from?](https://brandcontextapi.com/observed-or-maintained-context.md): Brand context is either read from a company's public website or prepared from sources added for a brand. What each kind returned for Linear, and when to use it. - [Brandfetch Brand Context API alternatives](https://brandcontextapi.com/brandfetch-brand-context-api-alternatives.md): What else returns brand context like Brandfetch's Brand Context API: Context.dev, Firecrawl, Logo.dev and Rainbrand, compared for one company, field by field. ## Templates - [Templates](https://brandcontextapi.com/templates.md): Text to copy into your own code: one JSON Schema for brand context from any endpoint, a system prompt that takes it, and adapters from each vendor's response. - [A brand context JSON Schema](https://brandcontextapi.com/templates/brand-context-json-schema.md): A JSON Schema for brand context from any vendor: name, voice, positioning, colors with roles, type, logos, rules, files, and where and when it was read. - [A system prompt that takes brand context](https://brandcontextapi.com/templates/system-prompt.md): A system prompt template for brand context, with sections for the brand, voice, look, rules and files, filled in from two real Linear responses. - [Adapters from each response to the schema](https://brandcontextapi.com/templates/adapters.md): TypeScript functions that map each brand context endpoint's response onto one BrandContext shape: Brandfetch, Context.dev, Firecrawl, Logo.dev and Rainbrand. ## Data and full text - [Data snapshot](https://brandcontextapi.com/data.json): the facts behind the pages, each with its source and the date it was checked. - [Whole site in one file](https://brandcontextapi.com/llms-full.txt): every page as Markdown. - [Sitemap](https://brandcontextapi.com/sitemap.xml) ## Who runs this site The Brand Object is run by Rainbrand, which makes two of the endpoints described here. Their pages follow the same rules as the others.