Introduction

Need to go from domain to brand name? Our Describe API allows you to access all the brand data we have for a given domain.

curl --header "Authorization: Bearer: YOUR_SECRET_KEY_HERE" "http://api.logo.dev/describe/domain"

All you need to provide is a query and your secret key, which can be found on the dashboard and is formatted like sk_....

​

In example, looking up “sweetgreen”

Using curl to test this from the command line, but obviously call the API anywhere that supports headers.

curl --header "Authorization: Bearer: YOUR_SECRET_KEY_HERE" "http://api.logo.dev/describe/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"
  },
  "logo": "https://img.logo.dev/sweetgreen.com?token=live_6a1a28fd-6420-4492-aeb0-b297461d9de2",
  "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" }
  ]
}

blurhash is the blurhash for the logo of the requested domain. A blurhash lets you have a placeholder image that gracefully loads in the logo.

colors is an array of prominate colors for the logo. They are roughly ordered by prominace in the image.

The currently supported social sites are:

• facebook
• github
• instagram
• linkedin
• pinterest
• reddit
• snapchat
• telegram
• tumblr
• twitter (aka X)
• wechat
• whatsapp
• youtube

​

Keep your secret a secret, keep it safe

Unlike the public key, it’s your responsibility to keep your secret key safe and away from public eyes. Even during testing, please never publish to Github or allow it to be seen from front-end code.

If you’re secret key is ever leaked, please get in touch immediately so we can regenerate a new one for you.