Brand Data API - Logos, Colors, Fonts and Company Info

Turn a list of domains, stock tickers, ISINs or crypto symbols into structured brand records: logo and icon URLs, brand colors, fonts, description, industry, employee count, founded year, headquarters and social links, one flat row per brand.

What this actor does

• Looks up brands by domain, the way you enrich a CRM export or a signup list.
• Looks up brands by stock ticker, ISIN or crypto symbol, using the provider's explicit typed routes rather than the auto-detecting legacy route that collides on ambiguous strings.
• Searches brands by name and returns candidate brands with their domains, which is how you resolve a company name you have into a domain you can enrich.
• Promotes the useful pieces into flat columns: logo, icon, symbol and banner URLs picked by theme and format, accent and brand colors, title and body fonts, firmographics and location. The untouched API record stays under raw.
• Records misses instead of hiding them. An identifier with no brand record becomes a row with matched: false, so a list with dead domains still finishes and you can see exactly which inputs resolved.
• Never charges for a miss. Only rows carrying an actual brand record are billed.

Input

Field	What it does
domains	Company domains to look up. A pasted URL is reduced to the bare hostname.
tickers	Listed stock ticker symbols, for example NKE.
isins	Twelve character securities identifiers, for example US0378331005.
cryptoSymbols	Cryptocurrency symbols, for example BTC.
brandNames	Brand names to run through brand search. Uses the client id, not the API key.
logoTheme	Which themed logo to promote into the logo columns: light or dark background.
includeContext	Also fetch the brand context record per domain: positioning, tone of voice, audience.
skipUnmatched	Leave unresolved identifiers out of the dataset.
maxResults	Hard cap on rows, and therefore on spend and run time.
apiKey	Your own API key, sent as a bearer token. Stored as a secret.
clientId	Your own client id for brand search. A separate credential from the API key. Stored as a secret.

Example output

{
  "recordType": "brand",
  "matched": true,
  "queryType": "domain",
  "query": "example.com",
  "name": "Example Labs",
  "domain": "example.com",
  "description": "Runtime security for containerised workloads.",
  "qualityScore": 0.94,
  "logoUrl": "https://cdn.example.com/example.com/logo.svg",
  "iconUrl": "https://cdn.example.com/example.com/icon.png",
  "colorAccent": "#3b5bdb",
  "colors": ["#3b5bdb", "#0a2540", "#ffffff"],
  "fontTitle": "Inter",
  "fontBody": "Inter",
  "employees": 320,
  "foundedYear": 2018,
  "industries": ["Software", "Security"],
  "city": "Berlin",
  "country": "Germany",
  "countryCode": "DE",
  "links": { "linkedin": "https://linkedin.com/company/example-labs", "twitter": "https://twitter.com/examplelabs" },
  "raw": { }
}

Frequently asked questions

What data does the Brand Data API return?

Each brand record carries the brand's name, domain and description, logo, icon, symbol and banner images in vector and raster formats, the brand color palette with each color's role, the title and body fonts, and firmographics: employee count, founded year, industry list, company kind and headquarters city, state, region and country. Social and web links are returned as a name to URL map.

Do I need my own API key?

Yes. This actor does not include data access. You use your own API key from Brandfetch, which is the provider whose API this actor calls, created on their developer portal. Your own plan, quota and terms apply. Paste the key into the apiKey field, where it is stored as an Apify secret and sent as a bearer header rather than a URL parameter, so it never appears in a log line or a redirect. Brand name search authenticates with a separate client id, which is why clientId is its own field.

What is the difference between brand lookup and brand search?

Lookup takes an identifier you already have (a domain, ticker, ISIN or crypto symbol) and returns one complete brand record. Search takes a brand name you do not have an identifier for and returns candidate brands with their domains and icons. The usual pipeline is search first to resolve names to domains, then look those domains up.

How do I get a logo for a dark background?

Set logoTheme to dark. The actor prefers a dark-theme logo entry when picking logoUrl, iconUrl, symbolUrl and bannerUrl, and falls back to whatever theme exists. Every logo variant the record carries is still available under raw.logos.

Which image format do the logo columns point at?

The highest quality usable format available, ranked vector first, then PNG, WebP and JPEG, and within a format the widest variant. A vector URL scales to any size downstream, which is why it wins.

What happens when a domain has no brand record?

The row is written with matched: false and an error explaining the miss, and the run continues to the next identifier. Misses are not charged for. Set skipUnmatched to true to leave them out of the dataset entirely.

How much does a run cost?

Pricing is pay per result: you are charged for each brand record returned to the dataset, and never for misses or duplicates. Apify platform usage is included in the per-result price. Your own API provider's quota is separate and billed by them.

How many requests does a run make?

One per identifier, because the provider has no bulk lookup endpoint. A 500 domain list is 500 requests. The actor paces itself well under the documented throughput limits and backs off on HTTP 429, so a large list finishes rather than tripping the limiter halfway through.

Keyword map

brand data API, logo API, brand logo lookup, company logo API, brand colors API, brand fonts API, domain to brand, ticker to brand, ISIN lookup, crypto symbol lookup, brand search API, company enrichment by domain, firmographic enrichment, brand assets API, brand identity data, CRM logo enrichment