Skip to main content
Every brand response carries fonts: the fonts that the brand’s website uses, one for each role. Brandfetch measures the fonts on the rendered page. The type of a font is its role:
  • title: headings.
  • body: paragraph text.
  • label: buttons, links and small text. You get label fonts only with typography=true.
  • code: code samples.
  • display: large hero text, when its font is not the title font.
The order of the fonts is title, body, label, code, display, so the first font is the heading font. One family can fill more than one role. A role that the brand does not use has no font.
Font
Each font has these fields:
  • origin: where the font comes from: google, adobe, bunny, fontshare, system or custom.
  • originId: the ID of the font at its origin. For a Google Fonts or Fontshare font, originId and weights are enough to build the stylesheet URL.
  • weights: the CSS font-weight values that the brand uses.
  • category: sans-serif, serif, monospace, display or handwriting.
  • fallbacks: the families that the brand’s font-family list gives after name. Together, name and fallbacks make a font-family value that you can use.
  • license: open, free, commercial, proprietary, system or unknown. It tells you if you can load the font in your own product.

Type scale

Add typography=true to a Brand API request to get the brand’s type scale. typography=1 does the same:
Type scale
Each font gains two keys, foundry and styles, and the label fonts are added. styles lists the text styles that the brand shows in the font. Each style has a name, such as heading-xl or body-md, and the HTML element that it was measured on. It also has fontWeight, fontSize, lineHeight, letterSpacing and textTransform. lineHeight is a multiple of the font size, and letterSpacing is in em.
Font with typography=true
For a batch lookup, send "typography": true in the body.