Skip to main content
GET
Retrieve logo by domain

Basic Usage

The Logo API works through hotlinking company logos directly into your app or website. Simply use an image tag, and the logos will load directly from our global CDN. This approach ensures you always display the most current logo versions without managing logo files yourself. Since our service is designed for hotlinking, please note that caching or storing the logo images locally is not supported. This HTML snippet demonstrates how to retrieve a logo for apple.com:

Limitations

Our Free Logo API plan is limited to 64x64px logos and require an attribution link. Upgrade to a paid plan for high resolution logos, increased rate limits and no attribution.

Examples

Let’s say you want to retrieve the logo for the Nvidia. You can do this by using the following URL:
If you want to receive a 404 HTTP response when the logo is not available, you can use the fallback parameter in the URL and set it to 404. This is useful for handling cases where the logo is not found, and you want to handle it in your application.
Request
HTTP Response
If you want to receive a light variant of the monogram fallback when the logo is not available, you can use the fallback parameter in the URL and set it to monogram-light. This is useful for light-themed applications where you want a fallback with a light background.
Request
This will return a light monogram image generated from the first letter of the domain with a light background, perfect for light-themed interfaces.

Parameters

Path Parameters

domain
string
required

The domain for which to retrieve the logo.

Example:

"apple.com"

Query Parameters

token
string
default:YOUR-API-TOKEN
required

Publishable API token for authentication. You can find yours in account settings.

Example:

"<publishable-api-token>"

size
enum<number>

Size of the logo to return. Allowed values are 64, 128, or 256. Default is 64px for free users, 128px for paid users. Set to 256px for high-resolution logos (paid users only).

Available options:
64,
128,
256
fallback
enum<string>
default:monogram

Fallback behavior if the logo is not available. 'monogram': Returns a monogram image from the first letter of the domain (default). 'monogram-light': Returns a light variant of the monogram with light background. '404': Returns a 404 HTTP error.

Available options:
monogram,
monogram-light,
404

Response

Logo image found and returned as PNG.

The response is of type file.