Logos

Get a brandmark

Returns the brand's brandmark, the wide logo lockup, as JSON with a temporary download url, the source dimensions, and a placeholder blurhash. It does not return image bytes. Send exactly one identifier. Costs API credits at the rate in API credits. Billed once per brand domain per 24 hours. A ready brand with no brandmark is still billed.

get/v2/brands/brandmark

Request

  • Base URL: https://api.logo.dev
  • URL: https://api.logo.dev/v2/brands/brandmark
  • 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.

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 and has a brandmark.

Example response

{
  "data": {
    "brand_id": "brand_4x0wr3g0000g00400000000004"
  },
  "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.