API reference
LogoAPI.sh API docs: logo, favicon, stock ticker and crypto, no key
LogoAPI.sh returns any company's logo from its domain: https://logoapi.sh/stripe.com. Free, no key.
Everything LogoAPI.sh does today, with real examples. Every route is a plain GET. Updated 2026-11-03
<img src="https://logoapi.sh/stripe.com.svg"
alt="Stripe" height="32">
Pick your path
Each one has a step-by-step guide.
-
Only have a name
Find logos by name
Search a brand name, even with a typo. Get the domain and logo URL as JSON.
Search API -
Newsletters and invoices
Email and PNG
Gmail and Outlook block SVG. Use the PNG, with a white background if you need it.
PNG guide -
Lovable, Cursor, Claude
AI builders and agents
Connect the MCP server, or paste one prompt into your builder.
MCP server AI app builders
- Stock ticker/ticker/MNDY.svg
- Favicon API/favicon/{domain}
- Replace Clearbitone host swap
- Colour versionswhite, black, grey, dark
Full reference
Get started
Quick start
No key, no signup, no attribution. Commercial use included. Copy this tag, swap the domain, done.
Every fallback says so in the X-Logo-Fallback response header, or add ?fallback=404 to get a 404 instead. Values: wordmark (ticker icon routes only: no catalog square icon, so the company wordmark stands in), favicon (the site's own favicon), tile (a name tile, no image found).
<img src="https://logoapi.sh/stripe.com.svg" alt="Stripe" height="24">
Link the logo and it stays up to date. Save a copy and it goes stale.
Coming from Clearbit? Read the Clearbit Logo API migration guide.
Tell your AI builder
Using Lovable, Bolt, Base44, v0 or Cursor? Paste this into your prompt. The tool writes the code.
For company logos, use an img tag with src https://logoapi.sh/{domain}, where {domain} is the company's website, for example https://logoapi.sh/stripe.com. It returns an SVG. No API key and no signup. Do not add a key or a token.AI agents
No setup needed. An agent that writes HTML can use the URL pattern directly: https://logoapi.sh/{domain}.svg. To find a domain from a name, call /search?q=. For a set, use /search?tag=.
To check that a logo exists without reading the SVG, call https://logoapi.sh/search?q=stripe.com (JSON with the logo URL). Chat previews block external images. To show logos inside Claude artifacts or ChatGPT canvas, fetch /{domain}.svg.txt (or /icon/{domain}.svg.txt) and inline the SVG or use a data URI. It is the same file as the .svg, served as plain text. There is no index.json or catalog download; use /search to look up a domain. No attribution required.
Machine-readable summary: /llms.txt. Full text for AI agents: this whole page, the terms and the Clearbit migration guide as one plain Markdown file. OpenAPI spec: /openapi.json. Plugin manifest: /.well-known/ai-plugin.json.
Prompt: "Add a row of customer logos for stripe.com, notion.so and linear.app.\nUse https://logoapi.sh/{domain}.svg for each."Endpoints
Logo
/{domain}.svgThe wordmark. Falls back to the square icon when a brand has no wordmark. Every valid domain returns an image. If the catalog misses, you get the site's live favicon, then a wordmark tile with the brand name (.svg URLs always return an SVG: a PNG favicon is wrapped in one).
curl -I https://logoapi.sh/stripe.com.svgHTTP/2 200
content-type: image/svg+xml
access-control-allow-origin: *
cache-control: public, max-age=86400, stale-while-revalidate=86400The X-Logo-Kind header says what the file is: wordmark when this route served a wordmark (a separate wordmark file, or a logo wider than 3:2), icon when it served an icon. Catalog logos only. It is sent on the bare /icon/{domain} route and on a bare PNG logo. The bare /{domain} route does not send it for an SVG logo, and the /{domain}.svg and /icon/{domain}.svg forms are plain static files that never did; use wordmark from search for those. A favicon or tile fallback has no such header.
Changed in November 2026: the bare route no longer sends X-Logo-Kind for SVG logos. Use wordmark from /search. PNG logos on the bare route and the bare /icon/ route still send it. A missing header does not mean icon.
This is on by default, and never a 404. .svg URLs always return an SVG: the logo, else the site's favicon wrapped in an SVG (a PNG of at least 32 px on its long side; an SVG favicon passes through), else a wordmark tile with the brand name. Versions get the tile in their colors: light text on a dark box for /dark/, plain text for /white/, /black/ and /grey/. Changed in November 2026: these version URLs used to return a 404 for an unknown domain. Add ?fallback=404 to keep that. Bare URLs (no .svg) and /icon/{domain} serve the site's favicon as it is (any type or size, fetched and cached), then a wordmark tile with the brand name. /{domain}.png serves the favicon as a real PNG, or a 404. Version URLs (/dark/, /white/, /black/, /grey/) get the tile only. The tile color is the same for the same domain every time. The X-Logo-Fallback: favicon or X-Logo-Fallback: tile header tells you which one you got. Add ?fallback=404 to get a 404 on a miss, so your own onerror fallback runs. ?fallback=none does the same. Changed in November 2026: .svg URLs now use the favicon too; before, they went straight to the tile.
<img src="https://logoapi.sh/example.com.svg?fallback=404" alt="Example" onerror="this.src='/img/generic-company.svg'">Never a 404 by default: a miss on a .svg URL returns the favicon wrapped in an SVG, else a wordmark tile with the brand name. Add ?fallback=404 to get a plain-text not found 404 instead. Too many requests return 429; wait for Retry-After.
Bare domain
/{domain}Same answer as /{domain}.svg, without the extension. A Clearbit-style URL works after a host swap.
SVG when the brand publishes one. Some brands have only a PNG; the bare URL serves it as image/png with X-Logo-Kind: raster.
<img src="https://logoapi.sh/stripe.com" alt="Stripe" height="24">The logo as SVG, or PNG when the brand has only a PNG. A PNG answer carries X-Logo-Kind (raster, or wordmark for a PNG wordmark next to an SVG icon). An SVG answer carries no such header; wordmark in search says whether this route serves a wordmark or an icon.
A miss returns the site's favicon as it is (fetched and cached), then a wordmark tile. The X-Logo-Fallback header says favicon or tile. Add ?fallback=404 to get a 404.
Icon
/icon/{domain}.svgThe square mark, for avatars and lists. The bare /icon/{domain} route sends X-Logo-Kind: icon (the .svg form is a static file without it), except for brands whose only logo is a wide wordmark (no square icon exists): there the icon route serves that wordmark and says X-Logo-Kind: wordmark.
<img src="https://logoapi.sh/icon/github.com.svg" width="32" height="32" alt="GitHub">PNG for email
/{domain}.pngGmail and Outlook block SVG, so every logo also has a PNG. Colour versions (/dark/, /white/, /black/) are SVG only; /dark/{domain}.png returns 404. The default is 512 px on the longest side, with a transparent background. ?size= snaps to 128, 256, 512 or 1024 (for example 300 gives 256). ?bg=white returns it on a white background. The icon is /icon/{domain}.png. PNG files are rendered from the SVG and carry X-Logo-Format: png-render. Brands with only a PNG logo serve that original file unchanged: no resize, no bg, no header.
<img src="https://logoapi.sh/stripe.com.png?size=256&bg=white" alt="Stripe" width="128">A PNG, 512 px on the longest side by default, with X-Logo-Format: png-render.
/dark/{domain}.png and the other colour versions return 404: they are SVG only. Too many requests return 429.
Favicon
/favicon/{domain}A favicon for a site, taken from the catalog icon. /favicon/{domain}.svg works too. The answer is SVG. An unknown domain returns a 404 with a JSON body. PNG is coming. Need a favicon for any site, including ones not in the catalog? Use /icon/{domain}: our icon, else the site’s own favicon, else a name tile, with X-Logo-Fallback saying which. See the Favicon API page for a live demo and a comparison with Google.
<link rel="icon" type="image/svg+xml" href="https://logoapi.sh/favicon/github.com">Colour versions
/{version}/{domain}.svgThese versions are generated by URL, not official brand files, except where the brand publishes its own (Notion today), which is served as is. Put white, black, grey or dark in front of any logo path. white and black repaint every colour to one flat colour, grey removes the colour. dark: a version for dark backgrounds. Black marks turn white; colourful logos stay as they are. The icon form is /{version}/icon/{domain}.svg. The .svg ending is optional.
| Version | URL |
|---|---|
| white | / |
| black | / |
| grey | / |
| dark | / |
| icon | / |
<img src="https://logoapi.sh/white/stripe.com.svg" alt="Stripe" height="24">Search
/search?q={text}Match an exact brand name, an exact domain or a close typo. Returns up to 8 results as JSON. q is 2 to 80 characters. A typo is tolerated (1 edit for 4 to 6 characters, 2 for 7 or more); those hits rank below exact matches and carry "fuzzy": true. An alias domain finds its main brand. Every result has wordmark: true when the bare logo route serves a wordmark (a separate wordmark file, or a logo wider than 3:2), false when it serves an icon. The /icon/{domain} route and bare PNG logos say what they served in X-Logo-Kind; the bare SVG route does not. Listed companies also carry ticker and exchange for their main listing (for example MNDY on NASDAQ). A company listed in the US and on another exchange shows its US listing. Both fields are absent when we do not know them.
curl "https://logoapi.sh/search?q=stripe"{
"query": "stripe",
"results": [
{
"domain": "stripe.com",
"name": "Stripe",
"logo": "https://logoapi.sh/stripe.com.svg",
"icon": "https://logoapi.sh/icon/stripe.com.svg",
"tags": ["finance"],
"source": "https://stripe.com/",
"wordmark": true,
"score": 90
}
]
}400 when q is too short or too long (and no tag is given). Too many requests return 429; wait for Retry-After. See Errors for every status.
Stock ticker lookup
/ticker/{TICKER}.svgGet the square icon of a listed company by its stock ticker. The URL answers 200 with the icon, the same image as /icon/{domain}.svg, on every form (no redirect, so fetchers that do not follow redirects work). Add ?variant=full for the full logo instead (the image of /{domain}.svg, also without a redirect). Use .svg or .png; the query string is kept. Tickers are not case sensitive. To pick an exchange, use /ticker/{EXCHANGE}:{TICKER}.svg, for example NASDAQ:MNDY (%3A also works). If a ticker is listed on several exchanges, the US listing is preferred. An unknown ticker returns a plain 404. Coverage: about 1,600 vector logos (the catalog icon, else the company wordmark), favicon or a name tile for the rest of the 6,609 tickers (X-Logo-Fallback says which); ?variant=full gives the full catalog logo where we have one. The ticker list in our public GitHub repo gives each ticker a kind for the square icon: vector, raster or fallback.
<img src="https://logoapi.sh/ticker/MNDY.svg" alt="monday.com" height="24">
https://logoapi.sh/ticker/NASDAQ:MNDY.svgLists and watchlists: add ?shape=square. On .svg the answer is always a 64 by 64 SVG, so a ticker with a wide wordmark, like JPM, still gets a readable tile in a row (its icon or favicon on a plate, else the wordmark). Dark version: /dark/ticker/JPM.svg?shape=square. Details in the ticker guide. Pages that cannot load outside images, such as sandboxed AI artifacts, can show ticker logos with one script: https://cdn.jsdelivr.net/npm/logoapi-script@0.1.4/logo.js and <span data-ticker="AAPL"></span>. Each logo is a finished square tile.
<img src="https://logoapi.sh/ticker/JPM.svg?shape=square" alt="JPMorgan Chase" width="32" height="32">200 with the square icon: SVG, or the PNG on .png. Lower case, an exchange prefix, listings outside the catalog and the coin routes answer 200 too. ?variant=full answers 200 with the full logo. Changed in November 2026: /ticker/ used to serve the full logo.
For dark backgrounds, /dark/ticker/{TICKER}.svg is the square icon recoloured like /dark/icon/{domain} (add ?variant=full for the full logo, recoloured like /dark/{domain}), and /dark/icon/ticker/{TICKER}.svg is always the icon. For coins, /dark/crypto/{SYMBOL}.svg is the dark version of /crypto/{SYMBOL}. An unknown coin symbol gives a plain 404 on the crypto routes, as an unknown ticker does. Colour versions are SVG only: .png answers a raster_only 404. X-Logo-Kind: icon is sent on the bare ticker form only, not on an explicit .svg. For chat canvases that block images, /ticker/{TICKER}.svg.txt returns the same SVG as plain text.
An unknown ticker returns a plain 404. A known ticker with no logo in the catalog yet serves the company's own favicon on the .svg URL, or a name tile when there is none; X-Logo-Fallback says which (wordmark, favicon or tile). Add ?fallback=none to get a 404 instead.
Behaviour
Errors
| Status | When |
|---|---|
404 | Brand page for an unknown domain, or a logo, icon or version (/, /, /, /) with ?fallback=404. Plain text not found, no placeholder image, so your own fallback runs. Cached for an hour. / returns a JSON body instead: {"error":"not_found", "message":..., "claim":...}. |
400 | Bad search input: q too short or too long, an unknown tag, or a comma list of tags. JSON with an error message. |
403 | page=2 or higher on a tag search. JSON with error: "page_limit". |
429 | Too many requests. Wait for Retry-After. A body with error: "guess_limit" means too many unknown names. It carries message, agents, retry_after_seconds, note and contact. The note says that requests for listed companies and tickers never count toward this limit; only unknown names do. The contact is https:/. |
503 | Search is briefly unavailable. JSON with error: "search_unavailable". Try again later. |
/favicon/{domain} and 400 body for a bad search{
"error": "not_found",
"message": "No favicon for acme.example yet. Owners can add one at https://logoapi.sh/startups.",
"claim": "https://logoapi.sh/startups"
}
{ "error": "q must be 2 to 80 characters (or give tag)" }
<img src="https://logoapi.sh/icon/acme.example.svg?fallback=404"
onerror="this.src='/img/generic-company.svg'" alt="Acme">Caching and CORS
Logo updates go live everywhere within a day. Logos, icons, favicons and colour versions send cache-control: public, max-age=86400, stale-while-revalidate=86400. Search results cache for 5 minutes. Brand pages and 404 answers cache for an hour. Error JSON is never cached. Every response sends Access-Control-Allow-Origin: *, so you can fetch from any site.
Limits
2M requests a month per site. Free. No key. No attribution required. Embed our logos and use the search API in your site or app. Don't copy the whole catalog. No surprise bills: we never charge unless you choose a paid plan. Need more volume? Enterprise has custom limits; contact us. Comparing free tiers? See the best free logo API.
Tag search returns the first 48 results. A tag plus q gives up to 8.
X-Partner-Key is a header for platform partners. Send it only on server-side requests, and never put it in browser code. Requests that carry a valid key never count toward the guess limit. To get a key, email hello@logoapi.sh.
Need more (aggregators, bulk, heavy apps)? Email hello@logoapi.sh.
Aliases
Some brands answer on several domains, for example aboutamazon.com and amazon.com both serve the Amazon logo. Search returns the main domain once, even when you search for an alias.
More
Brand pages
/brand/{domain}An HTML page for one brand: its logo, icon and official versions (only the ones the brand publishes), colours, URLs and embed code. White, black, grey and dark versions generated by URL are not shown on the page; see colour versions. Link to it from your docs or share it with a teammate. An unknown domain returns 404.
https://logoapi.sh/brand/stripe.comFinder links
The Logo Finder lets you search any brand or browse the top 48 logos of each category.
FAQ
Do I need an API key or an account?
No. There is no key and no signup. Logo requests set no cookies. Put the URL in an img tag.
Do I have to credit LogoAPI.sh?
No. No attribution is required.
Can I use the logos in a commercial product without a link back?
Yes. No attribution is required, for personal or commercial projects, on the free plan and on paid plans.
What happens when you don't have a logo?
.svg URLs always return an SVG: the logo, else the site's favicon wrapped in an SVG (a PNG of at least 32 px; an SVG favicon passes through), else a wordmark tile with the brand name. Bare URLs may return the site's favicon as it is (fetched and cached) before the tile. Add ?fallback=404 to get a 404, for example to run an onerror handler on the img.
How do I check that a logo exists?
Call /search?q=stripe.com. It returns JSON with the logo URL, so you do not need to read the SVG.
Can I cache the files?
Yes. Logos are sent with max-age=86400, so browsers and CDNs keep them for a day. Do not copy the whole catalog.
Can I rely on LogoAPI.sh long term?
Yes. The free tier stays free. We give 12 months' notice before the free tier is reduced or removed. We'll post it here, in the docs and in llms.txt, and email everyone on our updates list.
How do I claim, correct or remove a logo?
Trademark owners can claim or correct a logo at /claim and remove it at /remove, with one email from their domain.
Who runs LogoAPI.sh?
H. Tech Innovation LLC. Questions: hello@logoapi.sh.
Coming soon
Not live yet. We list them here so you know what is next.
- WebP, and PNG favicons
- Optional monogram fallback
- Free API keys
Ask AI about LogoAPI.sh