// get logo.tomba.io/{domain}
Any company logo, by domain
Fetch a company's logo from its domain with a single URL. No API key and no credits: put it straight into an img tag.
No API keyNo credits1 to 512 pxPNG when sized
size128px
GET
https://logo.tomba.io/piedpiper.com?size=128// 01 · request
One URL, four parameters
GET https://logo.tomba.io/{domain}. No headers, no key; the response is the image itself.
domainpath- The company's domain, such as piedpiper.com. A subdomain returns the logo of its registrable domain.
s · sizequery- Width and height in pixels, 1 to 512: a square PNG of that size. Without it, the logo comes back as stored.
greyscalequery- true returns the logo as a greyscale PNG.
d · defaultquery- URL-encoded http or https image to return when Tomba has no logo for the domain.
<img
src="https://logo.tomba.io/piedpiper.com?s=128"
alt="Pied Piper logo"
width="128"
height="128"
/>curl -o piedpiper.png "https://logo.tomba.io/piedpiper.com?s=200&greyscale=true"import requests
res = requests.get("https://logo.tomba.io/piedpiper.com", params={"s": 200})
with open("piedpiper.png", "wb") as file:
file.write(res.content)// 02 · response
The image, or a clear error
A missing logo still answers 200 with a placeholder, so an img tag never breaks; the Content-Disposition filename tells you which you got.
200The image. image/png with s or greyscale; otherwise the stored format (PNG, JPEG, WebP, AVIF or SVG).200No logo for the domain: a placeholder PNG (filename default.png), or your d image unchanged.400Not a valid domain, s outside 1 to 512, or d not an http or https URL on a public host.502Tomba couldn't fetch the image at d, or it didn't return 200.
// 03 · live
A few logos, straight from the API
Yes. It needs no API key and uses no credits. Request
https://logo.tomba.io/{domain} and you get the logo back.No. Unlike the rest of the Tomba API, the Logo endpoint needs no authentication, so its URL goes straight into an
<img> tag.With
s (or size) from 1 to 512, or with greyscale, you get a square PNG of that size. Without them, the logo comes back as stored: PNG, JPEG, WebP, AVIF or SVG.The API still answers 200 with a placeholder PNG named
default.png, so your layout never breaks. Pass your own fallback image, URL-encoded, in d (or default).Yes. The URL has the same shape, the host followed by the domain: swap
logo.clearbit.com for logo.tomba.io, and use s for the size.Company logos are trademarks of their respective owners. Tomba serves the imagery, but you are responsible for using each logo in a way that respects the trademark holder’s rights.