Product
Developers
Docs Pricing Blog Star on GitHub24

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

Star on GitHub24Found it useful? A star helps others find it.

5,124 brands ·

html
<img src="https://logoapi.sh/stripe.com.svg"
     alt="Stripe" height="32">
Live preview: Stripe logo
Ticker watchlist, ready to runOpen in StackBlitz

Pick your path

Each one has a step-by-step guide.

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.

prompt
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

Bare domain

GET/{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">
Response

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.

Errors

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.

Full guide: get a company logo by domain

Icon

GET/icon/{domain}.svg

The 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

GET/{domain}.png

Gmail 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">
Response

A PNG, 512 px on the longest side by default, with X-Logo-Format: png-render.

Errors

/dark/{domain}.png and the other colour versions return 404: they are SVG only. Too many requests return 429.

Full guide: PNG company logos for email

Favicon

GET/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

GET/{version}/{domain}.svg

These 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.

VersionURL
white/white/stripe.com.svg
black/black/stripe.com.svg
grey/grey/stripe.com.svg
dark/dark/stripe.com.svg
icon/white/icon/github.com.svg
<img src="https://logoapi.sh/white/stripe.com.svg" alt="Stripe" height="24">

Tags and filters

GET/search?tag={tag}

Filter by exactly one tag; a comma list returns 400. With tag, q is optional. A tag alone returns the first 48 results, with no total. A tag plus q returns up to 8. Asking for page=2 of a tag returns 403. Case does not matter.

curl "https://logoapi.sh/search?tag=finance"
curl "https://logoapi.sh/search?tag=finance&q=stripe"
Response
{
  "query": "stripe",
  "tag": ["finance"],
  "page": 1,
  "results": [ { "domain": "stripe.com", "name": "Stripe", "tags": ["finance"], ... } ]
}
TagWhat it covers
techSoftware, SaaS, hardware, AI, security, telecom
devtoolsDeveloper tools, languages, frameworks, databases, open source
financeBanks, payments, fintech, investors, insurance
retailConsumer brands, shops, food, travel, cars
mediaNews, TV, games, music, social, streaming
organizationsNonprofits, government, universities, standards bodies
healthPharma, hospitals, health tech
industryEnergy, manufacturing, logistics, real estate

An unknown tag returns 400 with the allowed list. For a browsable list, see /tag/finance or the Logo Finder.

Stock ticker lookup

GET/ticker/{TICKER}.svg

Get 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.svg

Lists 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.

JPMorgan Chase wordmark
/ticker/JPM.svg
JPMorgan Chase square tile
?shape=square
JPMorgan Chase square tile, dark
/dark/ ?shape=square
<img src="https://logoapi.sh/ticker/JPM.svg?shape=square" alt="JPMorgan Chase" width="32" height="32">
Response

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.

Errors

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.

Full guide: company logo by stock ticker

Behaviour

Errors

StatusWhen
404Brand page for an unknown domain, or a logo, icon or version (/dark/, /white/, /black/, /grey/) with ?fallback=404. Plain text not found, no placeholder image, so your own fallback runs. Cached for an hour. /favicon/{domain} returns a JSON body instead: {"error":"not_found", "message":..., "claim":...}.
400Bad search input: q too short or too long, an unknown tag, or a comma list of tags. JSON with an error message.
403page=2 or higher on a tag search. JSON with error: "page_limit".
429Too 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://logoapi.sh/contact.
503Search is briefly unavailable. JSON with error: "search_unavailable". Try again later.
404 body for /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

GET/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.com

Open the Stripe page

Finder 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