Retrieve brands by name - Context.dev

Use by_name when a company name is available but its domain is not. Name matching is less precise than a domain lookup, so verify the returned canonical domain before attaching the profile to an existing record.

Send a company name

export CONTEXT_DEV_API_KEY="ctxt_secret_..."

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_name",
    "name": "Airbnb"
  }'

import ContextDev from "context.dev";

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

const response = await client.brand.retrieve({
  type: "by_name",
  name: "Airbnb",
});

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

import os
from context.dev import ContextDev

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

response = client.brand.retrieve(type="by_name", name="Airbnb")
print(response.brand.domain 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_name,
    name: "Airbnb",
  }
)

puts response.brand&.domain

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{
            OfByName: &contextdev.BrandGetParamsBodyByName{
                Name: "Airbnb",
            },
        },
    )
    if err != nil {
        panic(err)
    }

    fmt.Println(response.Brand.Domain)
}

<?php

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

use ContextDev\Client;

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

// Use the SDK's low-level request method until the Brand helper is fixed.
$raw = $client->request(
    method: 'post',
    path: 'brand/retrieve',
    body: [
        'type' => 'by_name',
        'name' => 'Airbnb',
    ],
);

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

The PHP tab uses the SDK’s low-level request method because the 2.14.0 Brand helper requires conflicting lookup fields. See the PHP guide for details.

name must contain 3 to 30 characters. The endpoint costs 10 credits.

Disambiguate by country

Add country_gl when similarly named companies operate in different markets:

{
  "type": "by_name",
  "name": "Acme",
  "country_gl": "us"
}

The country value is a matching hint, not a guarantee. Check brand.domain, brand.title, and other returned evidence before writing over a known company identity.

Production behavior

Treat a no-match as a normal product outcome and keep the original name.
Do not merge companies solely because their returned titles are similar.
Persist both the submitted name and returned domain so a human can review uncertain matches.
maxSpeed, force_language, maxAgeMs, timeoutMS, and tags are available on this lookup.

Next steps

Retrieve brand data

Understand the shared brand response model.

Brand API reference

Review every supported request and response field.