> ## 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. # Brand Context API > Get a structured, narrative-rich brand context for a domain — including identity, positioning, voice, and visual style. ## OpenAPI ````yaml GET /v2/context/{domain} openapi: 3.0.1 info: title: Brandfetch API description: >- Our APIs help you personalize your customer journey through unique branded experiences. license: name: MIT version: 1.0.0 servers: - url: https://api.brandfetch.io security: [] paths: /v2/context/{domain}: get: tags: - context summary: Get brand context by domain description: >- Get a structured, narrative-rich brand context for a domain — including identity, positioning, voice, and visual style. operationId: getBrandContext parameters: - name: domain in: path description: Domain name (e.g., `brandfetch.com`) required: true schema: type: string examples: domain: summary: Domain value: brandfetch.com responses: '200': description: >- 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. content: application/json: schema: $ref: '#/components/schemas/BrandContextResponse' text/markdown: schema: type: string description: The brand context rendered as Markdown. '400': description: Bad Request content: application/json: schema: type: object properties: message: type: string enum: - Bad Request '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string enum: - Unauthorized '404': description: >- 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). content: application/json: schema: type: object properties: message: type: string enum: - or '429': description: API key quota exceeded content: application/json: schema: type: object properties: message: type: string enum: - API key quota exceeded security: - bearerAuth: [] components: schemas: BrandContextResponse: type: object description: >- 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. properties: meta: $ref: '#/components/schemas/BrandContextMeta' identity: $ref: '#/components/schemas/BrandContextIdentity' positioning: $ref: '#/components/schemas/BrandContextPositioning' brand: $ref: '#/components/schemas/BrandContextBrand' BrandContextMeta: type: object description: Metadata about the resolved brand context. required: - domain - canonical_name - resolved_at properties: domain: type: string description: The resolved domain name. example: brandfetch.com nullable: false canonical_name: type: string description: The canonical brand name. example: Brandfetch nullable: false resolved_at: type: string format: date-time description: Timestamp (ISO 8601) at which the context was resolved. example: '2026-05-25T08:48:36.843440+00:00' nullable: false BrandContextIdentity: type: object description: Core identity of the brand. properties: tagline: type: string description: A short tagline summarizing the brand. nullable: true mission: type: string description: The brand's mission statement. nullable: true description: type: string description: >- A descriptive paragraph about the brand, its products, and how it differentiates. nullable: true tags: type: array items: type: string description: A list of tags that characterize the brand. nullable: true BrandContextPositioning: type: object description: How the brand positions itself in the market. properties: value_proposition: type: string description: The brand's value proposition. nullable: true target_audience: type: array items: $ref: '#/components/schemas/BrandContextTargetAudience' description: Target audience segments for the brand. nullable: true products_and_services: type: array items: $ref: '#/components/schemas/BrandContextProductOrService' description: Products and services offered by the brand. nullable: true BrandContextBrand: type: object description: The brand's voice and visual style. properties: voice: $ref: '#/components/schemas/BrandContextVoice' style: $ref: '#/components/schemas/BrandContextStyle' BrandContextTargetAudience: type: object description: A single target audience segment for the brand. properties: segment: type: string description: Short label describing the audience segment. nullable: false description: type: string description: >- What this segment needs from the brand and how the brand serves them. nullable: false BrandContextProductOrService: type: object description: A product or service offered by the brand. properties: name: type: string description: Name of the product or service. nullable: false type: type: string description: Whether the offering is a `product` or a `service`. enum: - product - service example: product nullable: false description: type: string description: Description of the product or service. nullable: false BrandContextVoice: type: object description: The brand's voice — how it communicates. properties: summary: type: string description: A narrative summary of the brand's voice. nullable: true attributes: type: array items: type: string description: >- Short adjectives describing the voice (e.g., `confident`, `reassuring`). nullable: true avoid: type: array items: type: string description: Things the brand should avoid in its voice. nullable: true BrandContextStyle: type: object description: The brand's visual style. properties: summary: type: string description: A narrative summary of the brand's visual identity. nullable: true attributes: type: array items: type: string description: >- Short adjectives describing the visual style (e.g., `minimal`, `high-contrast`). nullable: true securitySchemes: bearerAuth: type: http scheme: bearer ````