# LoadLogo API

> Free logo API for developers. Fetch company logos, brand profiles, stock tickers, and crypto tokens via simple image URLs. No SDK, no API key required. A modern alternative to Clearbit Logo API, Logo.dev, and Brandfetch.

## Quick Start — Zero Setup

No installation, no SDK, no API key. Just use image URLs directly:

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

```jsx
// React / Next.js
<img src={`https://img.loadlogo.com/${domain}?size=64&format=webp`} alt={domain} />
```

```python
# Python
import requests
brand = requests.get(f"https://api.loadlogo.com/describe/{domain}").json()
logo = requests.get(f"https://img.loadlogo.com/{domain}?size=256").content
```

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

## Base URLs

- Image CDN: https://img.loadlogo.com (returns images)
- API: https://api.loadlogo.com (returns JSON)
- Docs: https://loadlogo.com/docs

## Image Endpoints (https://img.loadlogo.com)

- GET /{domain} — Company logo by domain (e.g. /spotify.com)
- GET /ticker/{symbol} — Stock ticker logo (e.g. /ticker/AAPL)
- GET /crypto/{symbol} — Crypto token logo (e.g. /crypto/btc), 20,000+ tokens
- GET /name/{name} — Logo by company name, AI-resolved (e.g. /name/spotify)
- GET /crypto/{chainId}/{address} — On-chain EVM token logo
- GET /blockchain/{idOrName} — Blockchain chain logo (e.g. /blockchain/8453)
- GET /ens/{name} — ENS avatar (e.g. /ens/vitalik.eth)
- GET /github/{username} — GitHub avatar (e.g. /github/octocat)
- GET /gravatar/{email} — Gravatar avatar
- GET /wallet/{address} — Wallet avatar (ENS reverse lookup)
- GET /flag/{code} — Country flag, ISO 3166-1 (e.g. /flag/us)
- GET /favicon/{domain} — Website favicon

## API Endpoints (https://api.loadlogo.com)

- GET /search?q={query} — Brand search (FTS5 + AI fallback)
- GET /describe/{domain} — Full brand profile (name, colors, fonts, social links, description)
- GET /ticker/{symbol} — Stock ticker metadata
- GET /crypto/{symbol} — Crypto token metadata
- GET /blockchain/{id} — Blockchain metadata
- GET /ens/{name} — ENS profile
- GET /github/{username} — GitHub user profile

## Image Query Parameters

- size (1-2000, default 128) — Image size in pixels
- format (png, jpg, webp, avif, svg) — Output format
- quality (1-100, default 85) — Compression quality
- style (flat, pixel-art, monochrome, glossy, dot-grid, vectorize) — AI style variant
- greyscale (boolean) — Convert to greyscale
- theme (light or dark) — SVG color theme for dark backgrounds
- fallback (monogram, 404, boring-marble) — What to return when logo is not found

## Authentication

No API key required for free tier (1,000 requests/day).
Pro tier: `Authorization: Bearer YOUR_API_KEY` header (50,000 requests/day).

## Claude Code Skill — AI-Powered Integration

Install the LoadLogo skill for Claude Code and Claude will automatically use LoadLogo whenever you need logos, brand assets, or company icons in your project:

```bash
curl -fsSL https://loadlogo.com/skill.md -o .claude/skills/loadlogo.md
```

Once installed, just tell Claude what you need:
- "add company logos to my dashboard" — uses img.loadlogo.com/{domain}
- "show stock ticker logos for AAPL, MSFT" — uses img.loadlogo.com/ticker/{symbol}
- "get brand colors from an email address" — uses api.loadlogo.com/describe/{domain}
- "add crypto logos for BTC, ETH, SOL" — uses img.loadlogo.com/crypto/{symbol}
- "show blockchain chain logos in my chain selector" — uses img.loadlogo.com/blockchain/{chainId}

Download: https://loadlogo.com/skill.md

## Why LoadLogo

- **Free** — 1,000 requests/day, no API key, no signup
- **Zero setup** — no SDK, no npm install, just URLs
- **12 image endpoints** — logos, tickers, crypto, ENS, GitHub, flags, favicons
- **7 JSON API endpoints** — brand profiles, search, metadata
- **AI style variants** — flat, pixel-art, monochrome, glossy, dot-grid, vectorize
- **Dark mode** — `?theme=dark` for SVG logos
- **Global CDN** — sub-100ms delivery worldwide
- **CORS enabled** — works from any origin
- **Drop-in replacement** for Clearbit Logo API, Logo.dev, and Brandfetch

## More Documentation

- [Full API docs (markdown)](https://loadlogo.com/docs.md)
- [Interactive docs](https://loadlogo.com/docs)
- [OpenAPI 3.0 spec](https://loadlogo.com/openapi.json)
- [All pages as markdown](https://loadlogo.com/index.md)
- [AI plugin manifest](https://loadlogo.com/.well-known/ai-plugin.json)
- [Claude Code skill](https://loadlogo.com/skill.md)