Introduction

​

Parameters

​

Standard

<img src="https://img.logo.dev/shopify.com" />

Logos returned without any parameters will be 1:1 aspect ratio, 128px tall and wide, and jpg formatted.

​

Rate-limiting

Your API token is required when using the endpoint publicly.

<img src="https://img.logo.dev/shopify.com?token=YOUR-KEY-HERE" />

​

PNG instead of JPG

<img src="https://img.logo.dev/shopify.com?format=png" />

In some cases, PNGs with limited color palettes will result in smaller image files with less compression. Using PNGs allows for transparency, although not all logo images will be compatible.

​

Desaturated

<img src="https://img.logo.dev/shopify.com?greyscale=true&format=png" />

Desaturated logos are most useful for landing pages when you want to normalize colors across the set.

​

Resizing images

<img src="https://img.logo.dev/shopify.com?size=80" />

Our image CDN will resize to any valid integer, but we recommend staying under 600px when using raster images like jpg and png.

​

Retina images

<img
  src="https://img.logo.dev/shopify.com?size=80&retina=true"
  width="80"
  height="80"
/>

The retina=true parameter doubles the source image resolution (160px) while displaying at the specified size (80px), creating sharp images on high-density displays. Without this parameter, logos may appear blurry.

​

Fallback images

In the case where no image is found for a given domain, the API will return a black and white monogram of the first letter of the domain with HTTP Status Code 200 OK.

If you want to suppress these monograms use the parameter fallback=404 to recieve an empty response and HTTP Status Code 404 Not Found.