> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Company enrichment

> Get logos, colors, socials and company details from a domain, name, email or ticker

> [!TIP]
>
> Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

`POST /data/brand/retrieve` returns a company profile. Pick how you identify the company with the `type` field.

> [card] [Try it in the Console](https://console.notte.cc/data-apis/brands)
>
> Try this API in the playground, no code needed.

## Quick start

```bash theme={null}
curl -X POST https://api.notte.cc/data/brand/retrieve \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "by_domain", "domain": "stripe.com"}'
```

```json theme={null}
{
  "status": "ok",
  "code": 200,
  "brand": {
    "domain": "stripe.com",
    "title": "Stripe",
    "description": "Stripe is a financial services platform that helps all types of businesses accept payments...",
    "colors": [{ "hex": "#533afd", "source": "site" }],
    "logos": [{ "url": "https://images.stripeassets.com/.../favicon.svg", "type": "icon" }],
    "socials": [{ "type": "...", "url": "..." }],
    "links": { "careers": "...", "privacy": "...", "contact": "...", "blog": "...", "pricing": "..." },
    "primary_language": "english"
  },
  "cache_metadata": { "status": "miss", "age_ms": 0 },
  "request_id": "...",
  "partial": false
}
```

## Look up by

| `type` | Required field | Notes |
| - | - | - |
| `by_domain` | `domain` | `stripe.com` |
| `by_name` | `name` | Optional `country_gl` to narrow the match |
| `by_email` | `email` | `hello@stripe.com` |
| `by_ticker` | `ticker` | Optional `ticker_exchange`, default `NASDAQ` |
| `by_direct_url` | `direct_url` | A specific page to profile |

To resolve a card-statement line instead, see [Merchant resolution](https://docs.notte.cc/data-apis/merchants.md).

## Optional parameters

**maxAgeMs** `integer` (default: 7776000000)

Maximum age of a cached profile (default 90 days). Not available on `by_direct_url`.

**maxSpeed** `boolean` (default: false)

Prioritize speed. Not available on `by_direct_url`.

**force\_language** `string`

Return text fields in this language, for example `english` or `french`. Not available on `by_direct_url`.

**timeoutOpts** `object`

`milliseconds` and `behavior`: `fail` or `return-partial`.

**tags** `string[]`

Free-form labels attached to the request.

## Response fields

`brand` can contain: `domain`, `title`, `description`, `slogan`, `colors`, `logos`, `backdrops`, `socials`, `address`, `stock`, `employees`, `industries`, `links`, `email`, `phone`, `is_nsfw`, `primary_language`. Fields that weren't found are `null` or empty. `partial: true` means the profile is incomplete.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.