> ## 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.

# Describe API

> Reference for the Describe API: request format, response fields, and status codes for GET /describe/{domain}.

The Describe API returns one JSON object for a domain: name, description, brand colors, social profiles, and logo. It takes a [secret key](/docs/platform/api-keys) and runs on any paid plan.

```bash theme={null}
curl --header "Authorization: Bearer LOGO_DEV_SECRET_KEY" "https://api.logo.dev/describe/sweetgreen.com"
```

The response is a single JSON object:

```json theme={null}
{
  "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](/docs/platform/errors#not-found-vs-still-indexing-202).

See the full request and response in the [Describe a domain](/docs/api-reference/rest-api/describe-a-domain) reference.

## Describe vs Brand

[Brand](/docs/brand/introduction) 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](/docs/brand/introduction).