Brands

Look up a brand

Returns a brand's profile from one identifier: a domain, ticker, ISIN, crypto symbol, or name. Send exactly one. A brand Logo.dev has not indexed yet returns 202 while it is fetched; retry after 30 seconds. Costs API credits at the rate in API credits. Billed once per brand domain per 24 hours, and only when the brand is ready. Merchant descriptors are not accepted yet.

get/v2/brands

Request

  • Base URL: https://api.logo.dev
  • URL: https://api.logo.dev/v2/brands
  • Auth: HTTP bearer

Query parameters

domainstring
Example:stripe.com

A company domain. Reduced to its registrable domain, so www.stripe.com looks up stripe.com. Send exactly one identifier.

tickerstring
Example:aapl

The stock or ETF symbol, in any case, with no exchange prefix: aapl and AAPL return the same brand. A bare symbol resolves against US exchanges. For a listing on another exchange, add the exchange suffix, such as 7203.T. Send exactly one identifier.

isinstring
Example:US0378331005

An ISIN. Case-insensitive. Send exactly one identifier.

cryptostring
Example:BTC

A crypto token symbol. Case-insensitive. Send exactly one identifier.

namestring
Example:Stripe

A brand name. Resolved to the top search match. Send exactly one identifier.

nosubscribe'true'

Send true to skip the automatic subscription to this brand. Only matters when webhooks are enabled on your account.

merchantstring
Example:SQ *BLUE BOTTLE COFFEE

A card-statement merchant descriptor. Announced but not yet enabled for any account, so it currently answers 403. Send exactly one identifier.

Response

The brand is ready.

Example response

{
  "data": {
    "id": "brand_4x0wr3g0000g00400000000004",
    "colors": [
      {
        "hex": "#635bff"
      }
    ]
  },
  "metadata": {
    "request_id": "request_01k6z8m2a4b5c6d7e8f9g0h1j2",
    "pending": {
      "retry_after_seconds": 30,
      "expires_in_seconds": 300
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.