Logo endpoint
CDN and REST semantics for raster + SVG logos, query parameters, response headers, and legacy aliases.
Canonical surfaces:
GET https://img.logorouter.com/{domain}?size=128&format=webp
GET https://api.logorouter.com/api/{domain}?size=128
GET https://api.logorouter.com/v1/{domain} # Dashboard + SDK compat alias (same semantics)
GET https://api.logorouter.com/v1/logos/{domain}Prefer img.logorouter.com in <img> embeds whenever you rely on ?token= publishable keys — the API hostname is optimised for deterministic server fetches (Authorization / x-api-key).
Operation-level docs (parameters, responses, examples) live inline in openapi.json under the getLogoByDomain operation.
Query reference
Aligned with openapi.json component parameters (always re-fetch in CI):
| Parameter | Values / shape | Behaviour |
|---|---|---|
domain (path) | Public hostname (stripe.com) | Normalised apex; CDN path segment mirrors REST. |
size | 16 … 2048 (defaults 128) | Edge length clamp versus plan entitlement. |
format | png, webp, jpg, jpeg, svg | Raster vs vector selection; CDN may downgrade gracefully. |
retina | boolean (false) | Signals double-density exports when artefacts exist or can be synthesized. |
theme | light, dark — default light | Monochrome / monogram thematic variants tied to deterministic sprite rules. |
fallback | monogram (default), 404, placeholder | What to synthesize when authoritative artwork is unavailable. |
greyscale | boolean (false) | Final-step desaturate for subdued UI treatments. |
refresh | boolean (false) | Bypass warm layers when entitlement allows (secret tiers / feature flags only). |
Anonymous previews honour the CDN demo envelope (~≤128 px) with shared IP throttles. Attach any key (publishable acceptable for raster GET routes) once you graduate from prototypes.
Legacy Clearbit ergonomics survive under:
GET https://api.logorouter.com/api/clearbit/logo/{domain}?size=128Response headers worth logging
| Header | Meaning |
|---|---|
X-Cache, Cache-Control, CDN-Cache-Control | Hot/cold tiers + TTL hints tuned per response class. |
X-Source / x-lr-source lineage | Helps explain whether bytes came from cache, deterministic fallback generator, upstream fetch, etc. |
X-Fallback | Present when synthesized monograms or placeholder artwork satisfied the request path. |
X-RateLimit-*, Retry-After | Quota signalling on both success envelopes and RFC 9457 problem bodies. |
Rate limiting & failures
Exceeded quotas return application/problem+json with mirrored limit headers wherever possible. Honour Retry-After with jitter before hammering dashboards.
Operational deep dive: Fallbacks · Brand colors pairing.