Skip to main content
Give the API a domain and get back the company in a form you can display. Not a favicon and a guessed colour: logos marked with the background they work on, colours ranked by how much the site uses them, fonts and social accounts. To show another company inside your product you need a mark that works on a dark background, a colour that is really theirs, and the right name. A favicon and the first colour in a stylesheet give you none of that.
  • Favicons are 32 pixels square, and often just a letter in a box.
  • The first colour in a stylesheet is usually a border, not the brand.
  • Nothing in a page’s markup says which logo was drawn for a dark background.

​
Look up a domain

  • To look up many domains in one call, POST a list to the same path.
  • To find a company by name, use GET /v1/web/brand/search?query=stripe. It searches brands we already hold, returns the domain, name, main logo and main colour for each, and is free.
  • To get just one logo, use Logo.

​
What comes back

​
string
How the company describes itself. Also legalName and a contact email when the site publishes them.
​
string
The site’s own meta description, word for word.
​
string, object, number
Contact details and founding year, only when the company’s own site publishes them. address has street, city, region, postalCode and country; any of them can be null.
​
array
Logos and images. Each has a kind (wordmark, symbol, favicon or backdrop), a variant (light, dark or mono) saying which background it works on, its format and resolution, the colours inside it, and a blurhash you can show as a placeholder while the image loads.
​
array
The palette. Each colour has a hex, the nearest CSS colour name, a weight for how much the site uses it, and sometimes a role: primary, accent, background or text. The weight is what tells you which one is the brand colour.
​
array
Font families with their weight, and a role of heading or body where we can tell.
​
array
Each account’s platform, url and handle without the @, so you can match it against other data you hold.
​
object
The company’s own pages when we find them: pricing, blog, careers, contact, privacy, terms and docs.
​
object
The company’s industry as a NAICS code and title, with a confidence.

​
Where each field came from

The sources object says, for each field, where its value came from. “The site says this” and “a model guessed this” are different claims, and they should not look the same in your database. A field can also have a confidence. Together they let you choose a fallback instead of showing something wrong: a low-confidence colour can give way to your own default, while a declared logo is safe to use.

​
Design systems

GET /v1/web/styleguide returns the design behind the brand: how the site combines its colours, type, spacing and components.
The design also comes back ready to paste:
  • css is a stylesheet with an @font-face rule for each web font and a :root block of CSS variables for colours, fonts, the type scale, corner radius, shadows and spacing.
  • tailwind holds the same variables as a Tailwind CSS v4 theme. After pasting it, classes such as bg-accent, font-heading, text-h1, rounded-button and shadow-md use the site’s design.
  • shadcn carries the colours, radius and fonts under shadcn/ui variable names, ready to replace the :root block in a shadcn project’s globals.css.
  • dark lists the site’s dark-theme colours when it has one, and every export then gains a matching dark block. When the site has no dark theme, dark is null.
Only plain colours, lengths, font names and https font files are included, so nothing else from the page can reach your stylesheet. Tokens alone rarely make a site recognisable, so components describes how its parts are drawn: the border, corners, padding and shadow most panels share, the top navigation bar, tabs, any full-width band in a contrasting colour, and where panel titles sit. button and secondaryButton cover the two main calls to action. Each comes with a css string you can paste into a rule as it is. To match a site closely, look at a screenshot of the page next to its styleguide. Pass url instead of domain to read one page, such as a pricing page styled differently from the homepage. A domain’s styleguide is kept for 30 days and a single page’s for 7. Pass maxAge in milliseconds to accept only a newer result, or 0 to read the page fresh.

​
What it costs

A domain we cannot resolve costs nothing. See Credits & billing for every price, and the API reference for every parameter.