# LoadLogo API — Full Reference

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

## Base URLs

- Image CDN: https://img.loadlogo.com
- API: https://api.loadlogo.com
- Docs: https://loadlogo.com/docs
- OpenAPI spec: https://loadlogo.com/openapi.json

---

## Authentication

No API key required for free tier.
Pro tier: `Authorization: Bearer YOUR_API_KEY` header.

Rate limits:
- Free: 1,000 requests/day
- Pro: 50,000 requests/day

---

## Image Endpoints

All image endpoints return binary image data with appropriate Content-Type headers.
All support these common query parameters:
- size (number, default 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, default scale-down): Resize mode: scale-down, contain, cover, crop, pad
- quality (number, default 85): Compression quality (1-100)
- format (string, default png): Output format: png, jpg, webp, avif, or svg
- blur (number, default 0): Gaussian blur radius (0-250)
- sharpen (number, default 0): Sharpen strength (0-10)
- brightness (number, default 1): Brightness multiplier (0-2)
- contrast (number, default 1): Contrast multiplier (0-2)
- rotate (string, default 0): Rotation angle: 0, 90, 180, or 270
- background (string): Background CSS color (used with fit=pad)
- dpr (number, default 1): Device pixel ratio (1-3)
- greyscale (boolean, default false): Convert logo to greyscale
- style (string): AI style variant: flat, pixel-art, monochrome, glossy, dot-grid, vectorize. Background is automatically removed for AI-generated styles.
- fallback (string, default monogram): Fallback behavior: monogram (default) or 404
- theme (string, default light): Color theme for SVG output: light (black fills) or dark (white fills). Useful for monochrome logos on dark backgrounds.

### GET img.loadlogo.com/{domain}
Logo by domain name. Returns highest quality logo available.
Example: `curl https://img.loadlogo.com/spotify.com?size=256&format=webp`

### GET img.loadlogo.com/ticker/{symbol}
Stock ticker logo by exchange symbol (NYSE, NASDAQ, LSE, TSX, etc.)
Example: `curl https://img.loadlogo.com/ticker/AAPL`

### GET img.loadlogo.com/crypto/{symbol}
Crypto token logo by symbol. 20,000+ tokens via CoinGecko.
Example: `curl https://img.loadlogo.com/crypto/btc`

### GET img.loadlogo.com/name/{name}
Logo by company name. AI resolves name to domain.
Example: `curl https://img.loadlogo.com/name/spotify`

### GET img.loadlogo.com/crypto/{chainId}/{address}
On-chain token logo by chain ID + contract address. All EVM chains.
Example: `curl https://img.loadlogo.com/crypto/8453/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`

### GET img.loadlogo.com/blockchain/{idOrName}
Blockchain chain logo by chain ID or name.
Example: `curl https://img.loadlogo.com/blockchain/8453`

### GET img.loadlogo.com/ens/{name}
ENS avatar image.
Example: `curl https://img.loadlogo.com/ens/vitalik.eth`

### GET img.loadlogo.com/github/{username}
GitHub avatar for user or organization.
Example: `curl https://img.loadlogo.com/github/octocat`

### GET img.loadlogo.com/gravatar/{email}
Gravatar avatar by email (MD5 hashed).
Example: `curl https://img.loadlogo.com/gravatar/user@example.com`

### GET img.loadlogo.com/wallet/{address}
Wallet avatar via ENS reverse lookup, monogram fallback.
Example: `curl https://img.loadlogo.com/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045`

### GET img.loadlogo.com/flag/{code}
Country flag by ISO 3166-1 alpha-2 code. SVG default.
Params: format (svg|png)
Example: `curl https://img.loadlogo.com/flag/us`

### GET img.loadlogo.com/favicon/{domain}
Website favicon. Tries apple-touch-icon, hi-res, then Google fallback.
Example: `curl https://img.loadlogo.com/favicon/spotify.com`

---

## API Endpoints

All API endpoints return JSON.

### GET api.loadlogo.com/search?q={query}
Search brands by name. FTS5 full-text search with AI fallback.
Params: q (string, required)
Response:
```json
[{"name": "Spotify", "domain": "spotify.com", "logo": "https://img.loadlogo.com/spotify.com"}]
```

### GET api.loadlogo.com/describe/{domain}
Full brand profile.
Params: fresh (boolean, force re-scrape)
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"},
  "fonts": ["Circular", "Helvetica Neue"]
}
```

### GET api.loadlogo.com/ticker/{symbol}
Stock ticker metadata.
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 via CoinGecko.
Response:
```json
{"symbol": "BTC", "name": "Bitcoin", "logo": "https://img.loadlogo.com/crypto/btc"}
```

### GET api.loadlogo.com/blockchain/{id}
Blockchain metadata.
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.
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.
Response:
```json
{"username": "octocat", "name": "The Octocat", "bio": null, "company": "@github", "repos": 8, "followers": 21790}
```

---

## Error Codes

- 200: Success
- 301: Domain redirected to canonical
- 404: Not found (when fallback=404)
- 429: Rate limited
- 500: Server error (retry)

---

## Machine-Readable Formats

- OpenAPI spec (JSON): https://loadlogo.com/openapi.json
- Full docs (markdown): https://loadlogo.com/docs.md
- All pages as markdown: https://loadlogo.com/index.md
- AI plugin manifest: https://loadlogo.com/.well-known/ai-plugin.json
- AI agent discovery: https://loadlogo.com/.well-known/ai-agents.json