# LoadLogo API Documentation

> The comprehensive logo API for developers. Fetch logos, brand profiles, stock tickers, and crypto tokens via simple URLs. No SDK required.

## Base URLs

| Server | URL | Returns |
|--------|-----|---------|
| Image CDN | https://img.loadlogo.com | Image binaries |
| API | https://api.loadlogo.com | JSON data |
| Docs | https://loadlogo.com/docs | Interactive docs |
| OpenAPI | https://loadlogo.com/openapi.json | OpenAPI 3.0 spec |
| LLM Reference | https://loadlogo.com/llms-full.txt | Full plain-text reference |

## Getting Started

No SDK needed. Just use image URLs directly:

```html
<img src="https://img.loadlogo.com/spotify.com" alt="Spotify" />
```

Get brand data:

```javascript
const res = await fetch("https://api.loadlogo.com/describe/spotify.com");
const brand = await res.json();
// { name: "Spotify", colors: [{hex: "#1DB954"}], socials: {...} }
```

## Authentication

No API key required for the free tier (1,000 requests/day).

Pro tier (50,000 requests/day): include `Authorization: Bearer YOUR_API_KEY` header.

---

## Image Endpoints

All image endpoints return binary image data with appropriate Content-Type headers.

### GET img.loadlogo.com/{domain}

Fetch a logo by domain name. Returns the highest quality logo available.

```bash
curl https://img.loadlogo.com/spotify.com?size=256&format=webp -o spotify.webp
```

**Query Parameters:**

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| size | number | 128 | Image size in pixels (1-2000). Maps to width. |
| width | number | — | Explicit width in pixels (1-2000). Overrides size. |
| height | number | — | Explicit height in pixels (1-2000) |
| fit | string | scale-down | Resize mode: scale-down, contain, cover, crop, pad |
| quality | number | 85 | Compression quality (1-100) |
| format | string | png | Output format: png, jpg, webp, avif, or svg |
| blur | number | 0 | Gaussian blur radius (0-250) |
| sharpen | number | 0 | Sharpen strength (0-10) |
| brightness | number | 1 | Brightness multiplier (0-2) |
| contrast | number | 1 | Contrast multiplier (0-2) |
| rotate | number | 0 | Rotation angle: 0, 90, 180, or 270 |
| background | string | — | Background CSS color (used with fit=pad) |
| dpr | number | 1 | Device pixel ratio (1-3) |
| greyscale | boolean | false | Convert logo to greyscale |
| style | string | none | AI style variant: flat, pixel-art, monochrome, glossy, dot-grid, vectorize |
| theme | string | light | SVG color theme: light (black fills) or dark (white fills) |
| fallback | string | monogram | Fallback behavior: monogram (default) or 404 |

### GET img.loadlogo.com/ticker/{symbol}

Stock ticker logo by exchange symbol. Supports NYSE, NASDAQ, LSE, TSX, and more.

```bash
curl https://img.loadlogo.com/ticker/AAPL -o apple.png
```

### GET img.loadlogo.com/crypto/{symbol}

Crypto token logo by symbol. Supports 20,000+ tokens via CoinGecko.

```bash
curl https://img.loadlogo.com/crypto/btc -o bitcoin.png
```

### GET img.loadlogo.com/name/{name}

Logo by company name. AI resolves the brand name to a domain.

```bash
curl https://img.loadlogo.com/name/spotify -o spotify.png
```

### GET img.loadlogo.com/crypto/{chainId}/{address}

On-chain token logo by chain ID and contract address. Supports all EVM chains.

```bash
curl https://img.loadlogo.com/crypto/8453/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 -o usdc.png
```

### GET img.loadlogo.com/blockchain/{idOrName}

Blockchain chain logo by chain ID or name.

```bash
curl https://img.loadlogo.com/blockchain/8453 -o base.png
```

### GET img.loadlogo.com/ens/{name}

ENS avatar image.

```bash
curl https://img.loadlogo.com/ens/vitalik.eth -o vitalik.png
```

### GET img.loadlogo.com/github/{username}

GitHub avatar for any user or organization.

```bash
curl https://img.loadlogo.com/github/octocat -o octocat.png
```

### GET img.loadlogo.com/gravatar/{email}

Gravatar avatar by email address.

```bash
curl https://img.loadlogo.com/gravatar/user@example.com -o avatar.jpg
```

### GET img.loadlogo.com/wallet/{address}

Wallet avatar via ENS reverse lookup. Falls back to a deterministic monogram.

```bash
curl https://img.loadlogo.com/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 -o wallet.png
```

### GET img.loadlogo.com/flag/{code}

Country flag by ISO 3166-1 alpha-2 code. Returns SVG by default.

```bash
curl https://img.loadlogo.com/flag/us -o us.svg
```

### GET img.loadlogo.com/favicon/{domain}

Website favicon. Tries apple-touch-icon, high-res favicons, then Google fallback.

```bash
curl https://img.loadlogo.com/favicon/spotify.com -o favicon.png
```

---

## API Endpoints

All API endpoints return JSON.

### GET api.loadlogo.com/search?q={query}

Search brands by name. FTS5 full-text search with AI-powered fallback.

```bash
curl "https://api.loadlogo.com/search?q=spotify" | jq
```

**Response:**
```json
[{"name": "Spotify", "domain": "spotify.com", "logo": "https://img.loadlogo.com/spotify.com"}]
```

### GET api.loadlogo.com/describe/{domain}

Full brand profile: name, description, logo URL, brand colors, blurhash, social links, and fonts.

```bash
curl https://api.loadlogo.com/describe/spotify.com | jq
```

**Response:**
```json
{
  "name": "Spotify",
  "domain": "spotify.com",
  "description": "Digital music streaming service...",
  "logo": "https://img.loadlogo.com/spotify.com",
  "colors": [{"hex": "#1DB954", "name": "Green"}],
  "blurhash": "LEHV6nWB2yk8...",
  "socials": {"twitter": "https://twitter.com/spotify", "instagram": "https://instagram.com/spotify"},
  "fonts": ["Circular", "Helvetica Neue"]
}
```

### GET api.loadlogo.com/ticker/{symbol}

Stock ticker metadata: symbol, company name, domain, and exchange.

```bash
curl https://api.loadlogo.com/ticker/AAPL | jq
```

**Response:**
```json
{"symbol": "AAPL", "name": "Apple Inc.", "domain": "apple.com", "exchange": "NASDAQ", "logo": "https://img.loadlogo.com/apple.com"}
```

### GET api.loadlogo.com/crypto/{symbol}

Crypto token metadata: symbol, name, and logo URL via CoinGecko.

```bash
curl https://api.loadlogo.com/crypto/btc | jq
```

**Response:**
```json
{"symbol": "BTC", "name": "Bitcoin", "logo": "https://img.loadlogo.com/crypto/btc"}
```

### GET api.loadlogo.com/blockchain/{id}

Blockchain metadata: chain ID, name, native currency, explorers.

```bash
curl https://api.loadlogo.com/blockchain/8453 | jq
```

**Response:**
```json
{"chainId": 8453, "name": "Base", "shortName": "base", "nativeCurrency": {"name": "Ether", "symbol": "ETH"}, "explorers": [{"name": "basescan", "url": "https://basescan.org"}]}
```

### GET api.loadlogo.com/ens/{name}

ENS profile: resolved address, avatar URL, social accounts.

```bash
curl https://api.loadlogo.com/ens/vitalik.eth | jq
```

**Response:**
```json
{"name": "vitalik.eth", "address": "0xd8dA...", "avatar": "https://euc.li/vitalik.eth", "socials": {"github": "vbuterin", "twitter": "VitalikButerin"}}
```

### GET api.loadlogo.com/github/{username}

GitHub user profile: avatar, bio, company, repos, followers.

```bash
curl https://api.loadlogo.com/github/octocat | jq
```

**Response:**
```json
{"username": "octocat", "name": "The Octocat", "bio": null, "company": "@github", "repos": 8, "followers": 21790}
```

---

## Image Transforms

All image endpoints support server-side transforms via query parameters. Cached globally for fast repeat access.

```html
<!-- Resize & format convert -->
<img src="https://img.loadlogo.com/spotify.com?size=256&format=webp" />

<!-- Custom dimensions with cover fit -->
<img src="https://img.loadlogo.com/spotify.com?width=400&height=300&fit=cover" />

<!-- Greyscale + quality control -->
<img src="https://img.loadlogo.com/spotify.com?greyscale=true&quality=75&format=webp" />

<!-- High DPI devices -->
<img src="https://img.loadlogo.com/spotify.com?size=64&dpr=2" />

<!-- Dark mode monochrome -->
<img src="https://img.loadlogo.com/spotify.com?style=monochrome&theme=dark" />
```

## AI Style Variants

Transform any logo into different visual styles with `?style=`:

| Style | Parameter | Description |
|-------|-----------|-------------|
| Flat | `?style=flat` | Clean flat design |
| Pixel Art | `?style=pixel-art` | Retro pixel art |
| Monochrome | `?style=monochrome` | Single color (use `&theme=dark` for white) |
| Glossy | `?style=glossy` | Glossy/shiny effect |
| Dot Grid | `?style=dot-grid` | Halftone dot pattern |
| Vectorize | `?style=vectorize` | Clean vector trace |

## Error Codes

| Status | Code | Description |
|--------|------|-------------|
| 200 | OK | Logo or data returned successfully |
| 301 | Redirect | Domain redirected to canonical URL |
| 404 | Not Found | Logo or brand not found (when fallback=404) |
| 429 | Rate Limited | Daily rate limit exceeded |
| 500 | Server Error | Internal error -- please retry |

## Framework Examples

### Next.js / React
```jsx
function BrandLogo({ domain, size = 64 }) {
  return (
    <img
      src={`https://img.loadlogo.com/${domain}?size=${size}&format=webp`}
      alt={domain}
      width={size}
      height={size}
      loading="lazy"
    />
  );
}
```

### Python
```python
import requests

res = requests.get("https://img.loadlogo.com/spotify.com?size=256")
with open("spotify.png", "wb") as f:
    f.write(res.content)
```

### cURL
```bash
curl https://img.loadlogo.com/spotify.com -o spotify.png
curl https://api.loadlogo.com/describe/spotify.com | jq
curl "https://api.loadlogo.com/search?q=spotify" | jq
```

---

*Machine-readable formats: [OpenAPI JSON](https://loadlogo.com/openapi.json) | [llms.txt](https://loadlogo.com/llms.txt) | [llms-full.txt](https://loadlogo.com/llms-full.txt)*
