Implementation guide
For more details, refer to our API Reference.1
Get your API key
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.
2
Make your first API call
Implement or run the code below to make your first API request.Authentication is done by passing your API key as a Bearer Authentication. The Brand API can be accessed through the following structure:
To avoid potential naming collisions between identifier types (e.g., a Stock or ETF ticker that matches a domain), you can use explicit type routes:
/v2/brands/{type}/{identifier} where type can be domain, ticker, isin, or crypto.3
Test and deploy
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.Once you are ready to go live, simply replace brandfetch.com with the domain name, Stock/ETF ticker, ISIN, or Crypto symbol you want to look up.
Query by domain, Stock/ETF ticker, ISIN, or Crypto symbol
The Brand API supports multiple identifier types to query brand data:- Domain:
nike.com(e.g.,https://api.brandfetch.io/v2/brands/nike.com) - Stock or ETF ticker:
NKE(e.g.,https://api.brandfetch.io/v2/brands/NKE) - ISIN:
US6541061031(e.g.,https://api.brandfetch.io/v2/brands/US6541061031) - Crypto symbol:
BTC,ETH(e.g.,https://api.brandfetch.io/v2/brands/BTC)
/v2/brands/{type}/{identifier}:
Auto-detection (legacy)
The original route/v2/brands/{identifier} still works and will auto-detect the identifier type. The detection order is: domain → Stock or ETF ticker → ISIN → Crypto symbol. However, we recommend using explicit type routes to prevent collisions and ensure accurate results.
If you only have company names, use the Brand Search API to match brand names to the most likely URLs.