API Documentation

Search and download brand logos programmatically. Built for developers and AI agents.

Base URL

https://api.logo-grabber.com

Authentication

Pass your API key via the X-API-Key header. The free tier (20 logos/day) works without a key — just start making requests.

curl https://api.logo-grabber.com/api/search?q=nike \
  -H "X-API-Key: lg_your_key_here"

Endpoints

Search for a logo

GET /api/search?q={brand}

Parameter	Type	Description
q	string	Brand name to search for (min 2 chars)

Response:

{
  "query": "nike",
  "results": [
    {
      "filename": "nike.svg",
      "url": "https://api.logo-grabber.com/logo/nike.svg",
      "size": 1234,
      "format": "svg"
    }
  ],
  "count": 1,
  "tier": "free"
}

Download a logo

GET /logo/{filename}

Returns the logo file directly (PNG, SVG, etc). Use the url from search results.

curl -O https://api.logo-grabber.com/logo/nike.svg \
  -H "X-API-Key: lg_your_key_here"

Check usage

GET /api/usage

Returns your current usage and remaining quota.

{
  "tier": "developer",
  "usage": {
    "today": 42,
    "limit": 500,
    "remaining": 458,
    "perMinute": 3,
    "perMinuteLimit": 30
  }
}

API info

GET /api

Returns API metadata, available endpoints, and pricing info.

Pricing

Free

20 logos/day
No key required
Test and prototype

Developer

$9/mo

500 logos/day
30 req/min
Production apps

Get Developer key

Scale

$59/mo

1,000 logos/day included
60 req/min
$0.02/logo over 1,000

Get Scale key

Rate Limits

Rate limits are applied per API key (or per IP for unauthenticated requests). When you exceed a limit, the API returns 429 Too Many Requests with a JSON body describing the limit.

{
  "error": "Rate limit exceeded.",
  "tier": "free",
  "limit": 20,
  "upgrade": "https://www.logo-grabber.com/docs"
}

Response Headers

Header	Description
X-LG-Tier	Your current tier (free, developer, scale)
Content-Type	image/png, image/svg+xml, etc. for logo files
Cache-Control	Logos are cached for 24 hours

Errors

Status	Meaning
200	Success
400	Bad request — invalid query or filename
404	Logo not found
429	Rate limit exceeded
403	Forbidden — unauthorized referer or blocked

Quick Start

Search for a brand and download the logo in two calls:

# 1. Search for a brand
curl "https://api.logo-grabber.com/api/search?q=spotify"

# 2. Download the logo
curl -O "https://api.logo-grabber.com/logo/spotify-logo.png"

With Python:

import requests

# Search
r = requests.get("https://api.logo-grabber.com/api/search",
    params={"q": "spotify"},
    headers={"X-API-Key": "lg_your_key"})
results = r.json()["results"]

# Download
if results:
    logo = requests.get(results[0]["url"],
        headers={"X-API-Key": "lg_your_key"})
    with open("spotify-logo.png", "wb") as f:
        f.write(logo.content)

Coverage

The library includes 1,000+ brand logos across tech, finance, media, pharma, retail, gaming, and more. All logos have transparent backgrounds. New logos are added regularly based on user requests.

Terms

API usage is subject to the Logo Grabber Terms of Service. Logos are trademarks of their respective owners. Use for reference, presentations, and editorial purposes. Commercial use requires brand permission.