Skip to main content
The Describe API turns any domain into structured company data in a single JSON response: name, description, brand colors, social profiles, and logo. It takes a secret key and is available 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, on a higher plan tier. Brand also renames Describe’s blurhash field to logo_blurhash.
Describe APIBrand API
PlansAny paid planPro and Enterprise
Name, description, colors, socials, logoYesYes
Brandmark (wide lockup)NoYes
Social banner imagesNoYes
Use Describe for core company data on any paid plan. Reach for Brand when you also need the brandmark or social banners. The API reference introduction compares all four REST APIs.