Skip to main content

​
2025 Updates

​
Query by ISIN & Stock Ticker: Now available in Brand API & Logo API

We’ve expanded the capabilities of our Brand API and Logo API endpoints. You can now query brand data directly using financial identifiers such as ISIN (e.g., US6541061031) or Stock Tickers (e.g., NKE). Previously, website URLs or Brand IDs were the primary ways to access brand information. With this update, simply input an ISIN or Stock Ticker to easily retrieve brand details and logos, further streamlining integrations for financial and investment platforms. Get started by reviewing the documentation.

​
Transaction API: Turn payment transactions into merchant data.

We’ve released a new endpoint called the Transaction API, enabling you to convert messy payment transactions into merchant data (e.g., logos, name, location, industry, etc.). The primary input for querying the Transaction API is a raw transaction descriptor (the line-item text on a bank or credit card statement). You provide this as the transactionLabel in the request body, along with a countryCode to narrow down the merchant’s locale. For example, a transaction label like STARBUCKS 1523 OMAHA NE with country code US can be resolved to starbucks.com. Get started by reading the documentation.

​
404 Fallback for Logo API

We have introduced a new fallback option to the Logo API, enabling you to choose whether you want to receive a 404 response if no logo is found. This complements our existing fallback options: transparent, lettermark, and brandfetch. You can access the 404 fallback in the same way as the other fallback options by specifying 404 in the link: https://cdn.brandfetch.io/randomInvalidDomain.com/fallback/404/icon

​
2024 Updates

​
Logo API

Logo API is a simple CDN link that gives you access to any brand’s latest logos. Logos by Brandfetch https://cdn.brandfetch.io/brandfetch.com?c={your-client-id-here} It’s customizable with powerful transformation capabilities and is meant to be directly embedded in your HTML tags so the logo always remains up-to-date. Key features:
  • Rich taxonomy: Access not just logo icons, but also brand symbols and main horizontal logos.
  • Theme support: Access dark or light logos so you can display them on any background.
  • Customizable sizing: Adjust the logo’s height and width to fit your needs.
  • Smart fallbacks: Even when a logo isn’t available, you’ll get fallbacks.
  • Stay on-brand: Logos automatically updates to the latest brand logo, so you’re always on-brand.
Best of all? It’s free without attribution. Get started by trying the query builder and reading the documentation.

​
Brand Quality Score

We now score brands on quality and make the score available via the Brands API. The quality score is a float between 0-1 which indicates the quality of the data for the given brand. The score is useful for when you don’t want to show lower quality brands to your users. Each brand now has a new qualityScore attribute with it’s respective score: 
{
  "name": "Brandfetch",
  "domain": "brandfetch.com",

  "qualityScore": 0.7599741515319993,

  ...

}
The score is engineered to divide into thirds: Lower 3rd is poor quality, middle 3rd is OK quality, upper 3rd is high quality. Lower scores indicate that a brand is less likely to be a “real” brand. For example, where google.com will score high, my-random-blog.com will score between 0.3-0.4. The score factors in things like data-recency, whether the brand has been claimed, if it has been manually verified by our team, the brand’s domain ranking on the web, as well as other factors. The score can be used to sort multiple brands in a list to determine which brand may be the best option to show to a user. The way we calculate this score may change over time such that a score for a given brand may change, but will remain aligned such that it divides quality into thirds: low, medium, high.

​
Brand Firmographics

We’ve added a few firmographic attributes to brands on the Brands API. The new attributes: number of employees, year founded, industry categorization, company kind, and geographic information about the brand’s company headquarters. 
{
  "name": "Stripe",
  "domain": "stripe.com",
  "company": {
    "employees": 1001,
    "foundedYear": 2010,
    "industries": [
      {
        "score": 1,
        "id": "37",
        "name": "Programming and Developer Software",
        "emoji": "🖥",
        "parent": {
          "emoji": "🖥",
          "id": "28",
          "name": "Computers Electronics and Technology",
          "slug": "computers-electronics-and-technology"
        },
        "slug": "programming-and-developer-software"
      },
      {
        "score": 1,
        "id": "28",
        "name": "Computers Electronics and Technology",
        "emoji": "🖥",
        "parent": null,
        "slug": "computers-electronics-and-technology"
      }
    ],
    "kind": "PRIVATELY_HELD",
    "location": {
      "city": "South San Francisco",
      "country": "United States",
      "countryCode": "US",
      "region": "Americas",
      "state": "California",
      "subregion": "Northern America"
    },
  },

  ...
}
More details on the available attributes can be found in the API documentation here.

​
Brand is NSFW?

We’ve added a isNsfw convenience attribute to the root of the brand object on the Brands API response. When the value of isNsfw is true, we’re indicating that we believe the brand to be, contain, or relate to adult content such as pornography (both photographic and animated) as well as adult-related like online sex shops. 
{
  "name": "Example",
  "domain": "adult-content.xxx",

  "isNsfw": true,

  ...

}

​
Brand industry classifications

We now classify brands into one or more industry categories and make this data available through the Brands API. The industry is returned on brands’ company attribute: 
{
  "name":"Stripe",
  "domain": "stripe.com",

  "company": {
    "industries": [
      {
        "score": 1,
        "id": "37",
        "name": "Programming and Developer Software",
        "emoji": "🖥",
        "parent": {
          "emoji": "🖥",
          "id": "28",
          "name": "Computers Electronics and Technology",
          "slug": "computers-electronics-and-technology"
        },
        "slug": "programming-and-developer-software"
      },
      {
        "score": 1,
        "id": "28",
        "name": "Computers Electronics and Technology",
        "emoji": "🖥",
        "parent": null,
        "slug": "computers-electronics-and-technology"
      }
    ],

    ...

  },

  ...

}
More details on the available attributes can be found in the API Reference. In the coming weeks we will release a free Taxonomy API for retrieving our industry taxonomy. In the meantime view the complete industry list here.

​
2023 Updates

​
Refreshed Developer Dashboard

We’ve rolled out an updated developer dashboard. The new dashboard better communicates your API usage and makes it easier to monitor your API requests. Here’s what we’ve added:
  • Overage Budget Limit Control: You can now set your own overage budget limit. Don’t want to spend more than you planned? Set it up right in the dashboard.
  • API Usage: Keep an eye on your API usage. Simple and clear to help you track what you’re using.
  • Usage History: See your usage over the past months.

​
Overage billing budget hard limit controls

In November we released overage billing for paid customers which let’s customers make requests beyond their plan quotas. Via the developer dashboard, customers can now also set a spending hard limit to better control costs of overage fees. This makes it possible to go over quota, but not go being a certain dollar amount. The default monthly budget is set at $100 USD.

​
Pseudo-Sandbox

All requests for the brand brandfetch.com are now free and will not count towards your usage quota. For example, if you fetch the brandfetch.com brand via GET https://api.brandfetch.com/v2/brands/brandfetch.com, your request will not count towards your quota. You can make as many requests for the brandfetch.com brand as you need while you iterate on and test your integration.

​
”photographic” and “portrait” asset tags for logos and icons

To give you more insight into the assets you work with, we’ve introduced a powerful new tagging feature. Now, assets such as Logos and Icons come with descriptive tags that provide a quick understanding of their characteristics. For instance, you might see the “photographic” tag associated with an asset, indicating that the image has realistic elements, which might differ from the standard vector logos typically used by brands. Similarly, the “portrait” tag suggests that the asset includes a portrait-like image, offering a personal touch often used by sole proprietors or small brands. These tags are designed to streamline your search and selection process, allowing you to quickly identify the type of asset you need and want to use with your customers. Check our our API documentation for further details.

​
Overage Billing

We are thrilled to announce a frequently requested update to our subscription payment plans that will provide you with greater flexibility over your usage. Starting this month, we’re saying goodbye to the hard limits on API requests that could disrupt your business. No more interruptions. Instead, we understand that your demand may sometimes exceed your quota, and we want to support your growth every step of the way. Here’s what’s changing:
  • No more hard stops: Once you hit your usage quota, you won’t face immediate cutoffs anymore. Our system will continue to seamlessly fulfill your API requests.
  • Transparent overage fees: Each additional request over your quota will now be billed at a $0.1 per request. Upgrade your billing plan at any time to take advantage of bucket discounts.
  • End-of-month overage billing: Any overages will be billed at the end of the month, allowing you to manage your budget without any mid-month surprises.
To disable or limit your overage fees, log into your developer dashboard and set a spending limit. Set the limit to $0 to completely disable overage. Overage billing is not available on the Free plan. To start using overage, please upgrade first to one of the paid plans.

​
longDescription property on brands

Introducing longDescription – In-depth brand narratives We’ve heard your feedback! Alongside our flexible API request limits, we’re excited to introduce an enhancement to our Brand API that will enrich the data you receive about each brand. While our description field provided a short blurb for brands, there was a growing need for more comprehensive descriptions—including for use with generative AI products to create content such as videos and other media. Here’s what’s new:
  • longDescription property: Dive deeper with longDescription, a new property in the Brand API’s response that offers an extensive description about each brand.
  • Richer brand stories: These longer descriptions encapsulate the essence of a brand, giving you more context and content to engage with your audience. By weaving in the brand’s history, industry standing, and product range, longDescription gives you the data to generate answers to question from your users and provides the context to derive further actions.
  • Seamless integration: The new property is available right now. You can start fetching more detailed brand narratives without any changes to your current setup. longDescription is already being returned in in your requests today.

​
The Brand Search API

We are pleased to announce that we’ve released the Brand Search API 🎉 The Brand Search API is a powerful tool designed to help users find a brand based on its name. Whether you’re looking to build a brand autocomplete feature or simply want to search for a specific brand, this API has you covered. Feel free to check out our documentation to learn more about it!

​
Usage & Quota Notification

  1. Every user of the Brand API will now be notified via email if their usage goes beyond 80% of the allocated limit.
  2. Users can view their quota by checking x-api-key-quota, and can also keep track of their usage for the current month by referring to x-api-key-approximate-usage.
  3. The API will return an HTTP status code 429 when the quota has been reached.

​
Dark & Light Logos

You can now retrieve both the dark and light versions of the logo, the symbol and the icon (see example below). 🌗 
"logos": [
    {
        "type": "logo",
        "theme": "light",
        "formats": [
            {
                "src": "https://asset.brandfetch.io/idL0iThUh6/id9WE9j86h.svg",
                "background": "transparent",
                "format": "svg",
                "size": 15555
            }
        ]
    },
    {
        "type": "logo",
        "theme": "dark",
        "formats": [
            {
                "src": "https://asset.brandfetch.io/idL0iThUh6/idWbsK1VCy.png",
                "background": "transparent",
                "format": "png",
                "height": 215,
                "width": 800,
                "size": 33937
            },
            {
                "src": "https://asset.brandfetch.io/idL0iThUh6/idtCMfbWO0.svg",
                "background": "transparent",
                "format": "svg",
                "height": null,
                "width": null,
                "size": 15567
            }
        ]
    },
    {
        "type": "symbol",
        "theme": null,
        "formats": [
            {
                "src": "https://asset.brandfetch.io/idL0iThUh6/iddCQ52AR5.svg",
                "background": "transparent",
                "format": "svg",
                "size": 2215
            }
        ]
    },
    {
        "type": "icon",
        "theme": "dark",
        "formats": [
            {
                "src": "https://asset.brandfetch.io/idL0iThUh6/idls3LaPPQ.png",
                "background": null,
                "format": "png",
                "height": 400,
                "width": 400,
                "size": 2565
            }
        ]
    },
    {
        "type": "other",
        "theme": null,
        "formats": [
            {
                "src": "https://asset.brandfetch.io/idL0iThUh6/idXGq6SIu2.svg",
                "background": "transparent",
                "format": "svg",
                "size": 2215
            }
        ]
    }
]