Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.logo.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Need to go from a domain to a company’s name, description, colors, social profiles, logo, and brandmark? The Brand API returns all the structured brand data we have for a given domain in a single JSON response.
The Brand API is available on Pro and Enterprise plans. See pricing to get started.Reach out to us at support@logo.dev if you see any gaps in coverage.
curl --header "Authorization: Bearer LOGO_DEV_SECRET_KEY" "https://api.logo.dev/brand/:domain"
All you need to provide is a domain and your secret key, which can be found on the dashboard and is formatted like sk_....

​
Example: looking up “sweetgreen”

We’re using curl to test this from the command line, but you can call the API anywhere that supports headers. 
curl --header "Authorization: Bearer LOGO_DEV_SECRET_KEY" "https://api.logo.dev/brand/sweetgreen.com"

​
Results

Expect a single object in the following format. The socials object will return a key-value pair if a social link is detected. 
{
  "name": "sweetgreen",
  "domain": "sweetgreen.com",
  "description": "Simple, seasonal, healthy salads and grain bowls made in-house from scratch, using whole produce delivered that morning.",
  "indexed_at": "2025-03-10T11:36:23.885238001Z",
  "socials": {
    "facebook": "http://facebook.com/sweetgreen",
    "instagram": "https://www.instagram.com/sweetgreen/",
    "twitter": "https://x.com/sweetgreen"
  },
  "social_banners": [
    "https://img.logo.dev/sweetgreen.com/banner.png?token=LOGO_DEV_PUBLISHABLE_KEY"
  ],
  "logo": "https://img.logo.dev/sweetgreen.com?token=LOGO_DEV_PUBLISHABLE_KEY",
  "brandmark": "https://img.logo.dev/sweetgreen.com/brandmark?token=LOGO_DEV_PUBLISHABLE_KEY",
  "logo_blurhash": "UJPanPxr?Vj[oxazj@od_FWDDoodxrodagWD",
  "colors": [
    { "r": 228, "g": 255, "b": 85, "hex": "#e4ff55" },
    { "r": 10, "g": 75, "b": 43, "hex": "#0a4b2b" },
    { "r": 125, "g": 173, "b": 80, "hex": "#7dad50" }
  ],
  "is_profane": false
}
logo is the renderable image URL for the brand’s logo. brandmark is the renderable URL for the brand’s wordmark/brandmark, and is omitted when none was selected. social_banners is an array of brand social/banner image URLs (for example, Twitter or Open Graph banners). logo_blurhash is the blurhash for the logo of the requested domain. A blurhash is a compact string representation that encodes a placeholder image, allowing you to show a blurred preview while the actual logo loads. colors is an array of prominent colors for the logo. They are roughly ordered by prominence in the image. is_profane is a boolean flag indicating whether the brand content was flagged as potentially inappropriate. The currently supported social sites are:
  • facebook
  • github
  • instagram
  • linkedin
  • pinterest
  • reddit
  • snapchat
  • telegram
  • tumblr
  • twitter (aka X)
  • wechat
  • whatsapp
  • youtube

​
Using the blurhash

The logo_blurhash field encodes a blurred placeholder of the logo as a compact string. Render it while the real logo loads, so there’s no blank space or layout shift. For implementation details and code examples, see the official blurhash documentation with decoders available for TypeScript, Swift, Kotlin, and more.

​
Keep your secret a secret, keep it safe

Unlike the publishable key, it’s your responsibility to keep your secret key safe and away from public eyes. Even during testing, never publish it to GitHub or expose it in front-end code. If your secret key is ever leaked, please get in touch immediately so we can regenerate a new one for you.