One GET request with a domain returns a profile of the company, built from its public website. The profile tells you what the company does, who it sells to, and what it sells at which price. It also describes how the company sounds, how it looks in words, and who it competes with. This domain has the name of this endpoint. Logos, color values and font names come from the Brandfetch Brand API.
The request
curl https://api.brandfetch.io/v2/context/linear.app \
-H "Authorization: Bearer $BRANDFETCH_API_KEY" \
-H "Accept: application/json"
The path takes a domain, a page address or a work email. Brandfetch reduces a page address or an email to the domain. To get the same profile as a Markdown document, send Accept: text/markdown. To get a profile only if one is already stored, add ?cachedOnly=true. If nothing is stored, the answer is a 204. Requests for brandfetch.com are free, for tests.
The response
GET /v2/context/linear.appBrandfetch Brand Context API{"meta": {"domain": "linear.app","canonical_name": "Linear","resolved_at": "2026-10-16T11:40:11.383835+00:00"1When Brandfetch read the site. We asked on 11 November and got the stored copy.},"identity": {"tagline": "product development software for teams …","mission": "Linear builds a structured product …","tags": ["software issue tracking", …]},"positioning": {"value_proposition": "Linear brings product planning, …",2snake_case here. The rest of the Brandfetch API uses camelCase."target_audience": [{ "segment": "Product and …" }, …],"products_and_services": [{"name": "Linear", "type": "product","pricing": { "model": "per_user", "starting_price": 10, … }3From linear.app/pricing. Brandfetch says that it never estimates a price.}, …]},"brand": {"voice": {"summary": "… a composed, exacting register …","attributes": ["precise", "measured", "craft-focused", …],"avoid": ["breathless hype", "folksy banter"]4The only "do not" in the response.},"style": { "summary": "… restrained cool accents …" }5Visual style in words. No color values or font names.},"competition": {"competitors": [{ "name": "Atlassian Jira" }, …]6Four here: Jira, YouTrack, Asana, Shortcut.}}The full response is in /data.json under responses.brandfetch-brand-context-api.
What is not in it?
- Logos, color values, font names and images are not in it. For these, call the Brand API with the same domain.
- Rules that the company wrote are not in it, apart from the two tones to avoid. All of the content comes from the public site.
- A version is not in it.
resolved_atgives the date when Brandfetch read the site. Brandfetch does not publish how often it refreshes a stored profile.
Empty and failed responses
| Status | What it means | Charged |
|---|---|---|
| 204 | You asked for cachedOnly, and nothing is stored yet |
No |
| 400 | Brandfetch failed to read the domain, address or email | No |
| 402 | The request had no credential. The response is a challenge to pay for that one request | No |
| 403 | The API key is not valid | No |
| 404 | Brandfetch failed to build a profile, for example because the site has no usable content | No |
| 422 | The site blocks automated requests | No |
| 429 | The key used all of its quota | No |
| 503 | The profile is in progress (x-bf-error: generation_in_progress). Retry after Retry-After |
No |
Brandfetch meters only successful lookups. If Brandfetch did not see a domain before, the first build of its profile has a target of 10 to 12 seconds.
Plans
As of 11 November 2026, Brandfetch has a Free plan that needs no card. Its cheapest paid plan, Growth Starter, is $129 a month, or $99 a month billed yearly. The Brand Context API and the Brand API share one plan. Without an account, an agent can pay for single requests with x402 or MPP. Brandfetch meters only successful lookups. Brandfetch's pricing page shows what each plan includes. Over the Model Context Protocol (MCP), the tool is get_brand_context on mcp.brandfetch.io.
Before you pass it to a model
On 11 November 2026, the Brandfetch developer terms forbid "ingesting the Content into a machine learning or AI model" without the consent of Brandfetch. The docs of this endpoint describe its Markdown as "ready to drop directly into an LLM prompt". Read the terms or ask Brandfetch before you build on this endpoint.
Last updated 11 November 2026