Parameters - Logoo by Ora

All logo serving endpoints (GET /v1/:domain, GET /v1/name/:brand) accept these query parameters for on-the-fly image processing.

Reference

Parameter	Type	Default	Description
`size`	`number`	`128`	Output size in pixels (16—1024). Images are resized to fit within this square
`format`	`string`	`webp`	Output format: `png`, `jpg`, `webp`, `avif`, `svg`
`variant`	`string`	`icon`	Logo variant: `icon`, `logo`, `symbol`
`greyscale`	`boolean`	`false`	Convert to greyscale
`theme`	`string`	`auto`	Theme: `auto`, `light`, `dark`
`retina`	`boolean`	`false`	Double resolution for retina displays
`fallback`	`string`	`monogram`	Behavior when no logo is found: `monogram` or `404`
`v`	`string`	—	Cache-buster. Accepted and ignored by the handler — safe for versioning asset URLs

Examples

# 256px WebP icon
curl "https://api.logoo.useora.co/v1/stripe.com?size=256"

# 64px PNG icon
curl "https://api.logoo.useora.co/v1/stripe.com?size=64&format=png"

# Retina (size=128 outputs 256px actual)
curl "https://api.logoo.useora.co/v1/stripe.com?size=128&retina=true"

# PNG with transparency
curl "https://api.logoo.useora.co/v1/stripe.com?format=png"

# JPEG (smaller, no transparency)
curl "https://api.logoo.useora.co/v1/stripe.com?format=jpg"

# AVIF (modern, excellent compression)
curl "https://api.logoo.useora.co/v1/stripe.com?format=avif"

# Greyscale for disabled states
curl "https://api.logoo.useora.co/v1/stripe.com?greyscale=true"

# Return 404 instead of monogram
curl "https://api.logoo.useora.co/v1/unknown.com?fallback=404"

# Combine everything
curl "https://api.logoo.useora.co/v1/stripe.com?size=512&format=png&retina=true&greyscale=true"

# Explicit dark theme
curl "https://api.logoo.useora.co/v1/stripe.com?theme=dark"

# Explicit light theme
curl "https://api.logoo.useora.co/v1/stripe.com?theme=light"

# Auto (tries light, falls back to dark)
curl "https://api.logoo.useora.co/v1/stripe.com?theme=auto"

When retina=true, actual pixel dimensions are doubled. size=128 with retina=true outputs a 256px image.

ETag support

For unprocessed requests (default size, format, no greyscale/retina), Logoo supports conditional requests with If-None-Match / ETag:

# First request returns the image + ETag header
curl -D- https://api.logoo.useora.co/v1/stripe.com

# Subsequent request returns 304 if unchanged
curl -H 'If-None-Match: "abc123"' https://api.logoo.useora.co/v1/stripe.com