Get Brand
brandfetch.get_brand
ActionBusiness appsconnection required
Calls the Brandfetch API with the connection's credentials.
Look up a brand's logos, colours, fonts and company data by domain, ticker, ISIN or crypto symbol.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Brandfetch
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- client_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
3 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
identifier The brand to look up, in the form the identifier type below expects: a domain like nike.com, a ticker like NKE, an ISIN like US6541061031, a crypto symbol like BTC, or — with 'auto' — any of those, a brand id or an email address whose domain is used. | string | Yes | — | — | brandfetch.com |
identifier_type Which kind of identifier was given, so the request uses the route that says so. 'auto' uses Brandfetch's shorthand route, which detects the kind itself and is the only one that accepts an email address. | string | No | domain | one of "domain", "ticker", "isin", "crypto", "auto" | — |
allow_nsfw How to treat brands Brandfetch has flagged as not safe for work. 'default' returns the milder ones with isNsfw set and hides the rest, 'allow' returns them all, and 'exclude' answers 404 for every flagged brand. | string | No | default | one of "default", "allow", "exclude" | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"allow_nsfw": "default",
"identifier": "brandfetch.com",
"identifier_type": "domain"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id Brandfetch's unique id for the brand. | string | — |
name The brand's name, or null when Brandfetch has none. | string | — |
domain The brand's website domain. | string | — |
claimed True when the brand's owner has claimed the profile. | boolean | — |
description A short description of the brand. | string | — |
longDescription A longer description of the brand. | string | — |
links The brand's social profiles, each with a name and a url. | array | — |
logos Logos, symbols and icons, each with a theme and file formats. | array | — |
colors The brand palette, each entry with a hex, type and brightness. | array | — |
fonts The brand's fonts, each with a name, type, origin and weights. | array | — |
images Banner and other brand images, each with its file formats. | array | — |
company Firmographic data: employees, founded year, industries, location. | object | — |
qualityScore How confident Brandfetch is in this record, from 0 to 1. | number | — |
isNsfw True when the brand is flagged as not safe for work. | boolean | — |
urn The brand's uniform resource name. | string | — |
logo_url Derived: the primary logo's file URL, SVG when one exists. | string | — |
icon_url Derived: the icon's file URL, or null when the brand has none. | string | — |
accent_color Derived: the accent colour's hex code. | string | — |
title_font Derived: the name of the brand's title font. | string | — |
body_font Derived: the name of the brand's body font. | string | — |
{
"accent_color": "",
"body_font": "",
"claimed": false,
"colors": [],
"company": {},
"description": "",
"domain": "",
"fonts": [],
"icon_url": "",
"id": "",
"images": [],
"isNsfw": false,
"links": [],
"logo_url": "",
"logos": [],
"longDescription": "",
"name": "",
"qualityScore": 0,
"title_font": "",
"urn": ""
}Notes
- Lookups for the domain brandfetch.com are free and never count against the key's quota, which makes it the identifier to test a connection with.
- The first request for a brand nobody has asked for is crawled live and can take a few seconds.
Related Brandfetch nodes
See Get Brand run in a workflow.
In a technical demo we add the Brandfetch connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.