2023
Follow along with updates across Brandfetch’s API.
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 withlongDescription
, 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
- Every user of the Brand API will now be notified via email if their usage goes beyond 80% of the allocated limit.
- 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 tox-api-key-approximate-usage
. - 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). 🌗