# logo-api

> Fetch company logos using Logo.dev API. Use when needing company/brand logos for slideshows, presentations, thumbnails, or visual content. Supports lookup by domain, stock ticker, or crypto symbol. Triggers on: get logo, company logo, brand logo, fetch logo, logo for [company], create slideshow with logos.

- Author: Ubuntu
- Repository: Jarvis-And-I/notsosecretagents
- Version: 20260126063233
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Jarvis-And-I/notsosecretagents
- Web: https://mule.run/skillshub/@@Jarvis-And-I/notsosecretagents~logo-api:20260126063233

---

---
name: logo-api
description: Fetch company logos using Logo.dev API. Use when needing company/brand logos for slideshows, presentations, thumbnails, or visual content. Supports lookup by domain, stock ticker, or crypto symbol. Triggers on: get logo, company logo, brand logo, fetch logo, logo for [company], create slideshow with logos.
---

# Logo.dev API Skill

Fetch high-quality company logos via the Logo.dev CDN.

## Quick Usage

Logo URL format:
```
https://img.logo.dev/{identifier}?token={API_KEY}&{params}
```

API key stored in `.credentials.json` under `logodev.publishableKey`.

## Lookup Methods

### By Domain (most reliable)
```
https://img.logo.dev/shopify.com?token=API_KEY
https://img.logo.dev/google.com?token=API_KEY
https://img.logo.dev/apple.com?token=API_KEY
```

### By Stock Ticker
```
https://img.logo.dev/ticker/AAPL?token=API_KEY
https://img.logo.dev/ticker/TSLA?token=API_KEY
https://img.logo.dev/ticker/MSFT?token=API_KEY
```

For non-US exchanges, append exchange code:
```
https://img.logo.dev/ticker/BMW.DE?token=API_KEY   # German
https://img.logo.dev/ticker/SHOP.TO?token=API_KEY  # Toronto
```

### By Crypto Symbol
```
https://img.logo.dev/crypto/BTC?token=API_KEY
https://img.logo.dev/crypto/ETH?token=API_KEY
```

## Parameters

| Param | Type | Default | Description |
|-------|------|---------|-------------|
| token | string | required | API key |
| size | int | 128 | Width/height in px (max 800) |
| format | string | jpg | jpg, png, webp, svg (enterprise) |
| greyscale | bool | false | Black & white version |
| theme | string | auto | auto, light, dark (for transparent logos) |
| retina | bool | false | 2x resolution for sharp displays |
| fallback | string | monogram | monogram or 404 |

## Examples

### Standard logo (128px JPG)
```
https://img.logo.dev/stripe.com?token=API_KEY
```

### Large PNG with transparency
```
https://img.logo.dev/apple.com?token=API_KEY&size=400&format=png
```

### Dark theme (for dark backgrounds)
```
https://img.logo.dev/apple.com?token=API_KEY&format=png&theme=dark
```

### Greyscale for uniform look
```
https://img.logo.dev/shopify.com?token=API_KEY&greyscale=true
```

### Retina-ready
```
https://img.logo.dev/google.com?token=API_KEY&size=200&retina=true
```

### Return 404 if not found (instead of monogram)
```
https://img.logo.dev/unknown-domain.xyz?token=API_KEY&fallback=404
```

## Download Script

Use `scripts/fetch_logo.sh` to download logos:

```bash
# By domain
./scripts/fetch_logo.sh shopify.com

# With options
./scripts/fetch_logo.sh apple.com --size 400 --format png

# By ticker
./scripts/fetch_logo.sh ticker/AAPL --size 200

# Output to specific path
./scripts/fetch_logo.sh google.com -o /data/media/google_logo.png
```

## Batch Download

```bash
# Download multiple logos
for domain in google.com apple.com amazon.com; do
  ./scripts/fetch_logo.sh $domain --size 400 -o /data/media/${domain%.com}.png
done
```

## Use in TikTok Slideshows

For slideshow creation:
1. Download logos to `/data/media/logos/`
2. Use consistent sizing (400-600px recommended)
3. Use `format=png` for transparency support
4. Use `greyscale=true` for uniform aesthetic
5. Use `theme=dark` or `theme=light` based on slideshow background