Variant Parameter
Request specific logo variants with ?variant= and understand fallback behavior.
Variant
Use variant to request a specific version of a logo.
Quick take: ?variant=dark for dark mode, ?variant=light for light mode, ?variant=transparent for transparent backgrounds, ?variant=svg for vector.
Requested logo variant. Use dark, light, transparent, or svg.
Not every domain has every variant. Use fallback=false if you need a hard 404.
curl "https://api.brandql.com/logo/stripe.com?variant=dark"
curl "https://api.brandql.com/logo/stripe.com?variant=dark&fallback=false"
curl "https://api.brandql.com/logo/stripe.com?variant=svg&fallback=false"
curl "https://api.brandql.com/logo/stripe.com?variant=dark&size=128"
Supported variants
| Variant | Description |
|---|---|
default | Primary logo (no param needed) |
dark | Works on dark backgrounds |
light | Works on light backgrounds |
transparent | Transparent background |
svg | Vector format |
If the requested variant doesn’t exist, we return the default logo unless you set fallback=false. See Fallback Parameter.
Variant and format
variant=svg returns the SVG logo if it exists. You can also request SVG via format=svg. The difference:
variant=svgrequests the SVG variant specifically.format=svgrequests SVG output for the best available logo.
If you need to ensure you’re getting a true SVG asset, use variant=svg&fallback=false. See Format Parameter.
Variant and size
Size works with raster variants (default, dark, light, transparent). SVG ignores size. See Size Parameter.
Notes
- Not every domain has every variant.
- If you want strict behavior, set
fallback=false.