Company Logo API
Fetch normalized company brand assets (primary logo, icon, wordmark, and favicon) using a domain — with structured quality fields for reliable rendering.
What you get
A consistent logos[] array with asset URLs and metadata
so your UI can pick the right variant.
Why it matters
Websites expose multiple assets inconsistently. Fivicon normalizes formats and dimensions so your app stays stable.
Designed for change
When logos change, structured updates can be sent to your system via webhooks — so caches don’t go stale.
How to call the API
Use the Discover endpoint to retrieve the best available assets for a company.
$ curl -sS "https://api.fivicon.com/api/v1/discover" \ -H "Content-Type: application/json" \ -d '{"domain":"fivicon.com"}'
You can send either domain or url; both
inputs are supported by the same Discover endpoint.
$ curl -sS "https://api.fivicon.com/api/v1/discover" \ -H "Content-Type: application/json" \ -d '{"url":"https://fivicon.com"}'
Response shape (what to parse)
A typical response includes the target domain and a normalized
list of assets under logos[].
{
"domain": "fivicon.com",
"logos": [
{
"type": "primary",
"url": "https://cdn.fivicon.com/fivicon/primary.svg",
"width": 512,
"height": 512,
"format": "svg",
"score": 94,
"score_details": {
"format_points": 35,
"resolution_points": 30,
"asset_type_points": 20,
"file_size_points": 15,
"penalty_points": 0
}
},
{
"type": "favicon",
"url": "https://cdn.fivicon.com/fivicon/favicon.png",
"width": 32,
"height": 32,
"format": "png",
"score": 88
}
]
}
Why this score breakdown exists
The score is not arbitrary. It helps your app pick a reliable asset by weighting five practical factors:
format_points: vector-friendly formats score higher for scalable rendering.resolution_points: higher dimensions reduce blurry logos in real UIs.asset_type_points: primary/icon/wordmark intent affects confidence.file_size_points: balances quality with practical delivery.penalty_points: removes confidence for weak or suspicious candidates.
FAQ
Is this the same as a favicon-only API?
No. Favicons are returned as one of the normalized asset types, but Fivicon also returns higher-quality logo variants (primary/icon/wordmark) when available.
How do I choose which logo variant to show?
Use the type field to select a layout (primary vs icon),
and the score/width/height fields
to pick the best option.
Does the API support domain input?
Yes. The Discover endpoint accepts domain (and supports URL input too).