---
title: "Get brand context by domain"
method: GET
path: "/v2/context/{domain}"
tags: ["context"]
---

# Get brand context by domain

`GET /v2/context/{domain}`

Get a structured, narrative-rich brand context for a domain — including identity, positioning, voice, and visual style.

## Path parameters

- `domain` string, required

## Query parameters

- `cachedOnly` boolean

## Response `200`

Successful request. The response format is determined by the `Accept` header: `application/json` returns a structured JSON object, while `text/markdown` returns the brand context as Markdown.

- BrandContextResponse — Full brand context returned by the Brand Context API. Note: unlike other endpoints in this API which use camelCase, the Brand Context endpoint intentionally returns field names in `snake_case` (e.g., `canonical_name`, `resolved_at`, `value_proposition`, `target_audience`, `products_and_services`) to align with conventions commonly used by LLM tooling that consumes this data.
  - `meta` BrandContextMeta — Metadata about the resolved brand context.
    - `domain` string, required — The resolved domain name.
    - `canonical_name` string, required — The canonical brand name.
    - `resolved_at` string, date-time, required — Timestamp (ISO 8601) at which the context was resolved.
  - `identity` BrandContextIdentity — Core identity of the brand.
    - `tagline` string, nullable — A short tagline summarizing the brand.
    - `mission` string, nullable — The brand's mission statement.
    - `description` string, nullable — A descriptive paragraph about the brand, its products, and how it differentiates.
    - `tags` string[], nullable — A list of tags that characterize the brand.
  - `positioning` BrandContextPositioning — How the brand positions itself in the market.
    - `value_proposition` string, nullable — The brand's value proposition.
    - `target_audience` BrandContextTargetAudience[], nullable — Target audience segments for the brand.
      - `segment` string — Short label describing the audience segment.
      - `description` string — What this segment needs from the brand and how the brand serves them.
    - `products_and_services` BrandContextProductOrService[], nullable — Products and services offered by the brand.
      - `name` string — Name of the product or service.
      - `type` 'product' | 'service' — Whether the offering is a `product` or a `service`.
      - `description` string — Description of the product or service.
  - `brand` BrandContextBrand — The brand's voice and visual style.
    - `voice` BrandContextVoice — The brand's voice — how it communicates.
      - `summary` string, nullable — A narrative summary of the brand's voice.
      - `attributes` string[], nullable — Short adjectives describing the voice (e.g., `confident`, `reassuring`).
      - `avoid` string[], nullable — Things the brand should avoid in its voice.
    - `style` BrandContextStyle — The brand's visual style.
      - `summary` string, nullable — A narrative summary of the brand's visual identity.
      - `attributes` string[], nullable — Short adjectives describing the visual style (e.g., `minimal`, `high-contrast`).

## Other responses

- `204` — Returned when `cachedOnly=true` and no brand context is currently cached for the domain. The response body is empty. Because crawling is disabled there is nothing to return. Retry without `cachedOnly` to resolve the domain live.
- `400` — Bad Request
- `401` — Unauthorized
- `404` — Returned when the brand context could not be resolved. This may mean the domain was not found or is invalid, or that we were unable to crawl the domain (e.g. due to DNS resolution issues, anti-botting protections, or because the request could not be processed in the allotted time).
- `429` — API key quota exceeded

---

[API](https://skmtc.dev/brandfetch/apis/brandfetch-api.md) · [All operations](https://skmtc.dev/brandfetch/apis/brandfetch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandfetch/brandfetch-api/revisions/09c15db0f2cd/schema)