# geticon.dev

> A free favicon and SVG logo API. Fetch, cache, and serve any website's icon over HTTPS — no API key, no sign-up, no rate limits.

## What it does

geticon.dev lets you display any website's favicon or SVG logo using a single GET request. Icons are fetched from the source, cached at the edge, and served over HTTPS. The service is free forever.

## API

- **Endpoint:** `GET https://geticon.dev/api/icon?domain=<domain>`
- **Returns:** The site's icon — redirects to a CDN-hosted SVG when available, otherwise proxies a raster favicon.
- **JSON response:** Add `&format=json` to get metadata including `icon_url`, `proxy_url`, `type`, and `svg` flag.

### Example requests

```
GET https://geticon.dev/api/icon?domain=github.com
GET https://geticon.dev/api/icon?domain=stripe.com&format=json
```

### Example JSON response

```json
{
  "domain": "github.com",
  "icon_url": "https://geticon.dev/api/icon?domain=github.com",
  "type": "svg",
  "svg": true
}
```

## Integration options

**HTML img tag**
```html
<img src="https://geticon.dev/api/icon?domain=github.com" width="32" height="32" alt="GitHub" />
```

**Data attribute (auto-resolve with client.js)**
```html
<script src="https://geticon.dev/client.js"></script>
<img data-geticon="github.com" width="32" height="32" />
```

**JavaScript**
```js
const url = getIcon('github.com')
// → 'https://geticon.dev/api/icon?domain=github.com'
```

## Key facts

- Free forever
- No API key required
- No sign-up required
- No rate limits (fair-use)
- Always HTTPS
- 90-day cache TTL
- SVG logos preferred; raster favicons as fallback
- Icons are crowd-sourced: embedding `client.js` silently reports domains via `sendBeacon`, growing the shared SVG database

## Attribution

When using `client.js`, a small attribution link is requested: "Site Icons by geticon.dev".

## Links

- Homepage: https://geticon.dev
- API: https://geticon.dev/api/icon?domain=github.com
- Sitemap: https://geticon.dev/sitemap.xml