v2

latestOpenAPI 3.0.1MIT2026-07-3191762.1 KB
context

Get brand context by domain

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

get/v2/context/{domain}

Path parameters

domainstring required

Domain name (e.g., brandfetch.com)

Query parameters

cachedOnlyboolean

When true, return a brand context only if one is already cached, responding instantly without crawling the domain. If no cached context exists, the API responds with 204 No Content instead of resolving the domain live (which can take several seconds). Useful for latency-sensitive use cases. Any value other than true (including omitting the parameter) keeps the default behaviour of resolving the domain live on a cache miss. Defaults to false.

Response

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.

Example response

{
  "meta": {
    "domain": "brandfetch.com",
    "canonical_name": "Brandfetch",
    "resolved_at": "2026-05-25T08:48:36.843440+00:00"
  },
  "positioning": {
    "products_and_services": [
      {
        "type": "product"
      }
    ]
  }
}