Describe API

The Describe API returns one JSON object for a domain: name, description, brand colors, social profiles, and logo. It takes a secret key and runs on any paid plan.

curl --header "Authorization: Bearer LOGO_DEV_SECRET_KEY" "https://api.logo.dev/describe/sweetgreen.com"

The response is a single JSON object:

{
  "name": "sweetgreen",
  "domain": "sweetgreen.com",
  "description": "Simple, seasonal, healthy salads and grain bowls made in-house from scratch.",
  "indexed_at": "2025-03-10T11:36:23Z",
  "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=LOGO_DEV_PUBLISHABLE_KEY",
  "blurhash": "UJPanPxr?Vj[oxazj@od_FWDDoodxrodagWD",
  "colors": [
    { "hex": "#e4ff55", "r": 228, "g": 255, "b": 85 },
    { "hex": "#0a4b2b", "r": 10, "g": 75, "b": 43 }
  ],
  "is_profane": false
}

A domain that isn’t in the index yet returns 202 while Logo.dev fetches it. Retry in a few seconds. See errors and status codes. See the full request and response in the Describe a domain reference.

Describe vs Brand

Brand returns everything Describe does, plus the brandmark and social banners. Brand also renames Describe’s blurhash field to logo_blurhash.

	Describe API	Brand API
Plans	Any paid plan	Every plan
Name, description, colors, socials, logo	Yes	Yes
Brandmark (wide lockup)	No	Yes
Social banner images	No	Yes

The brandmark and the social banner images come from the Brand API.

API Reference

Products

Describe vs Brand

​Describe vs Brand

Describe vs Brand