Introduction

Need crisp company logos for partner grids, CRM avatars, or dashboards? With hellobrand.dev you can fetch a logo using only a domain. Below are copy-paste snippets for Node.js and cURL, plus smart fallbacks so your UI never shows a broken image.

Quick start

Replace {domain} with a website domain. The endpoint returns an image directly.

# Download a 128px PNG logo
curl -L '[https://api.hellobrand.dev/logo/github.com?size=128&format=png](https://api.hellobrand.dev/logo/github.com?size=128&format=png)' \n  --output github-128.png

Useful params:

size 64, 128, 256, 512
format png or svg when available
bg hex background when flattening PNG, e.g. ffffff

Node.js example

Works on Node 18+ using native fetch.

import { writeFile } from 'node:fs/promises';

const domain = 'github.com';
const url = `https://api.hellobrand.dev/logo/${domain}?size=128&format=png`;

async function main() {
  const res = await fetch(url, { headers: { Accept: 'image/png' }, signal: AbortSignal.timeout(8000) });
  if (res.status === 404) throw new Error('Logo not found');
  if (res.status === 429) throw new Error('Rate limited; retry later');
  if (!res.ok) throw new Error(`Unexpected ${res.status}`);
  const buf = Buffer.from(await res.arrayBuffer());
  await writeFile('logo-128.png', buf);
  console.log('Saved logo-128.png');
}

main().catch(err => { console.error(err); process.exit(1); });

Front-end usage

Render directly from the endpoint and provide a graceful fallback.

Smart fallbacks with enrich

If a polished logo is unavailable, fall back to favicon or OG image via the enrichment endpoint.

async function getBestLogoUrl(domain) {
  // try direct logo first
  const direct = `https://api.hellobrand.dev/logo/${domain}?size=128&format=png`;
  const ping = await fetch(direct, { method: 'HEAD' });
  if (ping.ok) return direct;

  // fallback: enrich to discover assets
  const metaRes = await fetch(`https://api.hellobrand.dev/enrich?domain=${encodeURIComponent(domain)}`);
  if (!metaRes.ok) return '/img/placeholders/company-128.png';
  const meta = await metaRes.json();
  return meta.logo || meta.favicon || meta.ogImage || '/img/placeholders/company-128.png';
}

Caching and performance

Respect Cache-Control and ETag headers to avoid duplicate downloads.
Use a CDN in front of your app and cache stable logos for 7–30 days.
Prefer svg for crisp scaling; use format=png&bg=ffffff when you need a flattened bitmap.

Error handling

404 not found use the enrich fallback or a neutral placeholder.
429 too many requests back off and honor retry headers.
Timeouts wrap calls with an 8s timeout and retry with jitter.

Accessibility and UI tips

Always set a meaningful alt, e.g., Company name + logo.
Reserve width and height to prevent layout shift.
Provide a neutral placeholder for unknown companies.

More cURL examples

# 256px PNG
curl -L '[https://api.hellobrand.dev/logo/openai.com?size=256&format=png](https://api.hellobrand.dev/logo/openai.com?size=256&format=png)' --output openai-256.png

# Prefer SVG if available
curl -L '[https://api.hellobrand.dev/logo/openai.com?format=svg](https://api.hellobrand.dev/logo/openai.com?format=svg)' --output openai.svg

# Discover fallbacks via enrich
curl -s '[https://api.hellobrand.dev/enrich?domain=openai.com](https://api.hellobrand.dev/enrich?domain=openai.com)' | jq

Conclusion

With a single request to /logo/{domain}, you can populate clean, on-brand avatars anywhere in your product. Add a small enrich fallback, cache aggressively, and your UI will stay fast and reliable.

Get Company Logo by Domain (Free API + Node.js snippet)

Ready to get started with HelloBrand API?