Brand

Retrieve a Brand profile using a domain, company name, work email, stock ticker, transaction descriptor, or page URL. All lookup types use POST /brand/retrieve and return the same profile shape.

Choose a lookup

You have	Lookup
Website domain	By domain
Company name	By name
Work email	By email
Stock symbol	By ticker
Bank or card descriptor	By transaction
Exact page to inspect	By page URL

Make a request

import ContextDev from "context.dev";

const client = new ContextDev({
  apiKey: process.env.CONTEXT_DEV_API_KEY,
});

const response = await client.brand.retrieve({
  type: "by_domain",
  domain: "stripe.com",
});

console.log(response.brand?.title);

import os
from context.dev import ContextDev

client = ContextDev(api_key=os.environ["CONTEXT_DEV_API_KEY"])

response = client.brand.retrieve(
    type="by_domain",
    domain="stripe.com",
)

print(response.brand.title if response.brand else None)

require "cgi/core"
require "context_dev"

client = ContextDev::Client.new(
  api_key: ENV.fetch("CONTEXT_DEV_API_KEY")
)

response = client.brand.retrieve(
  body: {
    type: :by_domain,
    domain: "stripe.com",
  }
)

puts response.brand&.title

package main

import (
    "context"
    "fmt"
    "os"

    contextdev "github.com/context-dot-dev/context-go-sdk/v2"
    "github.com/context-dot-dev/context-go-sdk/v2/option"
)

func main() {
    client := contextdev.NewClient(
        option.WithAPIKey(os.Getenv("CONTEXT_DEV_API_KEY")),
    )

    response, err := client.Brand.Get(
        context.Background(),
        contextdev.BrandGetParams{
            OfByDomain: &contextdev.BrandGetParamsBodyByDomain{
                Domain: "stripe.com",
            },
        },
    )
    if err != nil {
        panic(err)
    }

    fmt.Println(response.Brand.Title)
}

<?php

require __DIR__.'/vendor/autoload.php';

use ContextDev\Client;

$client = new Client(apiKey: getenv('CONTEXT_DEV_API_KEY'));

// The generated Brand helper requires fields from multiple lookup types, so send the request directly.
$raw = $client->request(
    method: 'post',
    path: 'brand/retrieve',
    body: [
        'type' => 'by_domain',
        'domain' => 'stripe.com',
    ],
);

$response = json_decode((string) $raw->getBody(), true, flags: JSON_THROW_ON_ERROR);
echo $response['brand']['title'] ?? 'No brand found', PHP_EOL;

curl https://api.context.dev/v1/brand/retrieve \
  --request POST \
  --header "Authorization: Bearer $CONTEXT_DEV_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "type": "by_domain",
    "domain": "stripe.com"
  }'

The request stays open until the lookup finishes. PHP-specific request details live on the PHP SDK page.

Read the profile

Abridged response:

{"status":"ok","code":200,"brand":{"domain":"stripe.com","title":"Stripe","colors":[{"hex":"#635BFF","source":"site"}],"logos":[],"socials":[],"industries":{"eic":[{"industry":"Finance","subindustry":"Payments & Money Movement"}]}}}

Collections can be empty. Choose a logo by type, mode, and resolution. Store the canonical brand.domain alongside your input, and let users correct uncertain company details. Treat discovered addresses and contact information as data to verify when accuracy matters.

Options

Field	Accepted by	Effect
`maxAgeMs`	Domain, name, email, ticker	Cache freshness; defaults to 3 months, clamped to 0–1 year. `0` refreshes.
`maxSpeed`	All except page URL	Skip slower enrichment for a less detailed response.
`force_language`	All except page URL	Return text in a supported language.
`timeoutOpts`, `tags`	All lookup types	Deadlines and usage labels.

Expected failures

No-match results can return 400 NOT_FOUND or 404 NOT_FOUND; inspect error_code. An inaccessible domain can return WEBSITE_NOT_FOUND, WEBSITE_ACCESS_ERROR, or WEBSITE_BLOCKED. Email rejection and short cold-domain deadlines return 422. See the lookup guides for recovery. When partial: true, unfinished fields are omitted; do not treat the result as a complete profile. The Brand reference lists every field. For visual tokens, use Styleguide; for a direct image embed, use Logo Link.

Get started

Web data

Company and people data

Automation

Account and billing

Production

Choose a lookup

Make a request

Read the profile

Options

Expected failures

​Choose a lookup

​Make a request

​Read the profile

​Options

​Expected failures

Choose a lookup

Make a request

Read the profile

Options

Expected failures