> ## Documentation Index
> Fetch the complete documentation index at: https://developers.debounce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logo API

> Free company logo lookup service

The Logo API provides instant access to company logos by domain name. This **completely free** service serves as a drop-in replacement for the deprecated Clearbit Logo API and delivers high-quality logos through our global CDN.

<Card title="Logo API Overview" icon="external-link" horizontal>
  You can see more logo demos in action by clicking <Link href="https://debounce.com/logo-api/" target="_blank">here</Link>.
</Card>

<Frame caption="Get instant access to high-quality company logos by domain name - completely free and production-ready.">
  <img src="https://mintcdn.com/debounce/_TtFFuvBzjl3qL4C/images/logo-api-featured-v1.jpg?fit=max&auto=format&n=_TtFFuvBzjl3qL4C&q=85&s=247ae367863e00f2b0d1049b6d4254c1" alt="Logo API Featured Image" width="1200" height="675" data-path="images/logo-api-featured-v1.jpg" />
</Frame>

## What this API Provides

* **High-quality PNG logos** for millions of companies
* **Automatic fallback** to clean monograms when logos aren't available
* **Daily updates** to reflect rebranding and domain changes
* **Production-ready** for high-traffic applications
* **No attribution required** - use logos freely in your applications

## Use Cases

* **Onboarding flows** - Display company logos during user registration
* **Job boards** - Show employer logos in listings
* **Financial dashboards** - Enhance account views with brand logos
* **Internal tools** - Add visual context to company data
* **CRM systems** - Enrich contact records with company branding

***

## API Endpoint

```
GET https://logo.debounce.com/{domain}
```

Replace `{domain}` with the company domain you want to retrieve a logo for.

### Example Requests

**Get Google's logo:**

```
GET https://logo.debounce.com/google.com
```

**Get Apple's logo:**

```
GET https://logo.debounce.com/apple.com
```

**Get Microsoft's logo:**

```
GET https://logo.debounce.com/microsoft.com
```

***

## Response Format

The API returns logo images directly in PNG format. If a logo is found, you'll receive the high-quality company logo. If no logo is available, a clean grey monogram placeholder will be returned instead.

### Successful Response

* **Content-Type:** `image/png`
* **Status Code:** `200 OK`
* **Image Size:** `128x128px` (square format)
* **Body:** PNG image data

### Visual Example

Here's what the Google logo looks like when fetched from the API:

<img src="https://logo.debounce.com/google.com" alt="Google Logo" width="128" height="128" />

### Example Usage in HTML

```html theme={null}
<img src="https://logo.debounce.com/google.com" alt="Google Logo" width="128" height="128">
```

### Example Usage in JavaScript

```javascript theme={null}
// Simple image loading
const img = new Image();
img.onload = () => console.log('Logo loaded successfully');
img.onerror = () => console.log('Logo failed to load');
img.src = 'https://logo.debounce.com/google.com';

// React component example
function CompanyLogo({ domain, size = 128 }) {
  return (
    <img
      src={`https://logo.debounce.com/${domain}`}
      alt={`${domain} logo`}
      width={size}
      height={size}
      onError={(e) => {
        // Optional: handle fallback locally
        e.target.style.display = 'none';
      }}
    />
  );
}
```

***

## Rate Limiting

<Warning>
  The free Logo API includes rate limits for fair usage:

  * **Request frequency** limits apply
  * **Daily usage** quotas may apply during peak usage

  These limits are designed to prevent abuse while allowing normal production usage. High-traffic applications should consider caching logos locally.
</Warning>

***

## Best Practices

<Tip>
  **Caching Recommendations:**

  Store logos locally or in your CDN to reduce API calls and improve performance. Logos are updated daily, so refresh your cache periodically.

  **Error Handling:**

  Always implement proper error handling. While the API provides fallbacks, network issues can still occur.

  **Image Optimization:**

  Consider resizing logos on your end for consistent display across your application.
</Tip>

***

## Migration from Clearbit

If you're migrating from Clearbit Logo API, the transition is simple:

**Before (Clearbit):**

```
https://logo.clearbit.com/{domain}
```

**After (DeBounce):**

```
https://logo.debounce.com/{domain}
```

No other changes to your implementation are required. The DeBounce Logo API maintains the same simple interface while being completely free and actively maintained.

***

## Supported Formats

* **PNG format** - High-quality, scalable logos
* **Automatic fallback** - Clean monograms for missing logos
* **Consistent sizing** - All logos delivered at 128x128px (square format)

The API automatically handles logo discovery, formatting, and delivery, making integration effortless for developers.
