# Icon Horse

> Free logo and favicon API. Get any company's or product's logo as PNG, WebP, ICO or SVG (16 to 256px) from a domain (`https://icon.horse/icon/stripe.com`) or a product name (`https://icon.horse/name/microsoft-entra-id`). No API key. Headers say when an image is a placeholder.

Key facts for agents:

- `GET https://icon.horse/icon/<domain>[/<size>][/<format>]` returns an image. Sizes: 16, 32, 48, 64, 128, 256. Formats: png (default), webp, ico, svg.
- `GET https://icon.horse/name/<product-slug>` does the same for a product name. `https://icon.horse/icon?q=<name>` redirects there.
- `GET https://icon.horse/api/icons?q=<domain or name>` (repeat `q`, up to 20) returns JSON with `found`, `confidence`, `source` and ready-made `urls`. Also `POST {"q": [...]}`.
- Check `X-Icon-Fallback: true` (or `"found": false` in JSON): it means no real logo was found and the image is a letter tile. Add `?fallback=404` to get a 404 instead.
- For slides and documents, use a PNG URL with `?trim=1&pad=8&bg=white` so a row of logos lines up. Google Slides and Docs: Insert → Image → By URL.
- Unknown product names return not found. Icon Horse does not guess.

## Docs

- [API docs](https://icon.horse/docs.html): every endpoint, option and header, with examples
- [Full docs as markdown](https://icon.horse/llms-full.txt): the same content as one plain text file
- [OpenAPI 3.1 spec](https://icon.horse/openapi.json): machine-readable schema for /icon, /name, /site, /api/icons, /api/stack and /api/set

## Examples

- [Stripe icon, PNG](https://icon.horse/icon/stripe.com): default PNG, up to 256px
- [Stripe icon, 64px WebP](https://icon.horse/icon/stripe.com/64/webp): fixed size and format
- [Microsoft Entra ID by name](https://icon.horse/name/microsoft-entra-id): product without its own domain
- [Even logo for a slide](https://icon.horse/icon/stripe.com/256?trim=1&pad=8&bg=white): trimmed, padded, white background
- [Batch lookup](https://icon.horse/api/icons?q=stripe.com&q=Microsoft%20Entra%20ID): JSON for several domains or names
- [Icon page with downloads](https://icon.horse/site/stripe.com): human page with every size and format

## Agents

- [MCP server](https://icon.horse/mcp): Model Context Protocol server (Streamable HTTP) with tools `find_logos`, `get_logo_image`, `logo_set` and `company_stack`.
- [Company stack](https://icon.horse/docs.html#agents): `GET /api/stack?domain=<domain>` lists the tools a company uses, with evidence.
- [Logo set](https://icon.horse/docs.html#agents): `/api/set` returns a matched logo set for a background color and size, with contrast warnings.

## Optional

- [Blog: Icon Horse for agents and documents](https://icon.horse/blog/icon-horse-for-agents-and-documents.html)
- [Getting started](https://icon.horse/blog/getting-started-with-icon-horse.html)