ParametersDefaults

Defaults

Understand BrandQL’s default behavior when you omit parameters.

Defaults

If you don’t pass any parameters, BrandQL returns the best available logo with safe defaults.

Quick take: no params means “give me the best logo you have.”

Defaults are optimized for speed and compatibility.

Start with defaults

Call the endpoint with just a domain and let BrandQL choose the best logo.

Add a single override

Set a primary override such as variant or format.

Lock it down

If you need strict behavior, add fallback=false.

Default behavior

  • Variant: default
  • Format: png
  • Size: 180x180 (raster only)
  • Fallback: true
curl "https://api.brandql.com/logo/stripe.com"

What “best available” means

We score candidate logos from multiple sources (favicons, Open Graph images, manifest icons) and return the highest‑quality match.

If a parameter is missing

  • Missing variant uses the default logo.
  • Missing format returns png.
  • Missing size returns a crisp 180x180 raster.
  • Missing fallback means true.

Common custom defaults

If you want a different default in your app, set it explicitly.

Notes

  • SVG ignores size because it is resolution independent.
  • If you want strict behavior, add fallback=false to get a 404 when a requested variant or format isn’t available.
Was this page helpful?