Brand API

​

🔍 Overview

Brand API provides programmatic access to any company’s brand assets through a single API call. This includes their latest logos, color schemes, fonts, images, and other firmographic information. For more details, refer to our API Reference.

Here are a few things to know about Brand API:

• Website as input: The primary input key to query Brand API is a website URL. If you don’t have URLs, use the Brand Search API to match brand names to the most likely URLs.
• Global coverage: Brand API works in real-time. If a brand is not part of our dataset, it will index the information live, providing data for brands of every size, geography, or sector.
• Keeping the data fresh: The cached data may not be provided or displayed to more than one user. If you’re looking to enrich large datasets, and be notified of any changes with Webhooks, please get in touch.

​

🔓 Create an account

Before getting started, you’ll need to create an account on our Developer Portal. Creating an account is quick and easy, and will give you access to your dashboard where you’ll find your API key.

​

📊 API quotas and usage

When you sign up for a free developer account, you get 250 free requests.

If you need to make more requests, please upgrade to a paid plan. When upgrading, you can confirm your quota by looking at the x-api-key-quota response header. To see your current month’s usage, look for the x-api-key-approximate-usage response header.

We will also send you an email warning you upon reaching 80% of your quota. The API will return an HTTP status code 429 when the quota has been reached.

In addition to a usage quota we also apply a request throughput limit to protect our service from error and abuse. By default, throughput is limited to 1000 requests/second with some flexibility to accommodate bursts. You’ll receive an HTTP status code 429 when you exceed this limit. Contact us if your use-case requires higher throughput limits.

​

📈 Overage billing

When you purchase a subscription plan, you are allotted a quota depending on the payment plan. When you make more API requests than your quota allows, rather than blocking requests which are over your quota, we apply overage billing. This means that you’ll never have any unexpected downtime. Requests over your quota are charged at an overage-fee rate. To set a spending limit, head to the Developer Dashboard and set a hard spending limit. Set this to $0 if you want to disable overage. Further details on the mechanics of overage are available here.

Overage billing is not available on the free plan. To start using overage, please upgrade first to one of the paid plans.

​

🔑 Authentication

Authentication is done by passing your API key as a Bearer Authentication. The Brand API can be accessed through the following structure:

Authorization: Bearer <API_Key>

​

🧪 Testing / Sandbox

While we don’t currently offer a complete sandbox of our APIs, all requests for the domain brandfetch.com are free and will not count towards your usage/quotas. You can make as many requests to the Brandfetch’s brand as you need while you iterate on and test your integration.

curl --request GET \
  --url https://api.brandfetch.io/v2/brands/brandfetch.com \
  --header 'Authorization: Bearer <API_Key>'

​

💳 Pricing

Our pricing is based on the number of API calls you make with each request giving you access to all attributes of a brand.

​

📚 API reference

Check out our API Reference for more details on the Brand API.