> ## Documentation Index
> Fetch the complete documentation index at: https://docs.logokit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 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.
## 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`:
```html theme={null}
```
## Limitations
Our Free Logo API plan is limited to 64x64px logos and require an
[attribution](/attribution) link. [Upgrade ](https://logokit.com/pricing) 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:
```html theme={null}
```
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.
```md Request theme={null}
https://img.logokit.com/invalid.com?fallback=404&token=
```
```bash HTTP Response theme={null}
404 Not Found
```
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.
```md Request theme={null}
https://img.logokit.com/invalid.com?fallback=monogram-light&token=
```
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
## OpenAPI
````yaml GET /{domain}
openapi: 3.0.3
info:
title: LogoKit Logo API
version: 1.0.0
description: >-
The LogoKit Logo API allows you to retrieve company logos by domain,
providing high-quality PNG images via hotlinking. Supports fallback options
and attribution for free users.
servers: []
security: []
tags:
- name: Logo API
description: Operations for retrieving company logos by domain
- name: Stock Logo API
description: Operations for retrieving logos by stock ticker symbols
- name: Crypto Logo API
description: Operations for retrieving logos by cryptocurrency symbols
- name: Brand API
description: Operations for retrieving comprehensive brand information
externalDocs:
description: LogoKit Documentation
url: https://docs.logokit.com
paths:
/{domain}:
get:
tags:
- Logo API
summary: Retrieve logo by domain
description: >-
Returns the logo for the specified domain as a PNG image. Free users:
64x64px. Paid users: 128x128px. Caching or local storage of images is
not supported.
operationId: getLogoDomain
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: apple.com
description: The domain for which to retrieve the logo.
- name: token
in: query
required: true
schema:
type: string
example:
default: YOUR-API-TOKEN
description: >-
Publishable API token for authentication. You can find yours in
[account settings](https://logokit.com/account/api-tokens).
- name: size
in: query
required: false
schema:
type: number
enum:
- 64
- 128
- 256
default: null
description: >-
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).
- name: fallback
in: query
required: false
schema:
type: string
enum:
- monogram
- monogram-light
- '404'
default: monogram
example: monogram
description: >-
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.
responses:
'200':
description: Logo image found and returned as PNG.
content:
image/png:
schema:
type: string
format: binary
'401':
description: Invalid or missing API token.
'404':
description: Logo not found (only if `fallback=404` is used).
'429':
description: Rate limit exceeded.
servers:
- url: https://img.logokit.com
description: Image API server
````