API Reference
Logo API
Logo API allows you to retrieve logos based on a domain, providing both high-quality images and fallback options when a logo is not available.
/{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:
<img src="https://img.BrandSearch.com/apple.com?token=<publishable-api-token>" alt="Apple logo (identification only, no affiliation)" />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
Retrieve logo for Nvidia
https://img.BrandSearch.com/nvidia.com?token=<publishable-api-token>Get 404 HTTP response for non-existent logo
https://img.BrandSearch.com/nonexistent-domain.com?token=<publishable-api-token>&fallback=404Get light monogram fallback for non-existent logo
https://img.BrandSearch.com/nonexistent-domain.com?token=<publishable-api-token>&fallback=monogram-lightParameters
Path Parameters
| Parameter | Type | Description |
|---|---|---|
domain | string (required) | The domain for which to retrieve the logo. Example: "apple.com" |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
token | string (required) | Publishable API token for authentication. You can find yours in account settings. |
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). |
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. |
Response
200 - Logo image found and returned as PNG
The response is of type file (image/png).