Implementation guide
Get your client ID
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 client ID.
Make your first API call
Implement or run the code below to make your first API request.Authentication is done by passing your client ID as a query parameter.
Test and deploy
The Brand Search API is a free product. Before you deploy your application to a live environment, be sure to consult our rate limits and review our usage guidelines to ensure a smooth launch.
Usage guidelines
Authentication
Authentication
To use Brand Search API, you must include your client ID with every request.Adding your client ID provides reliable access, supports fair usage, and keeps consistent performance across all requests.Create a free account and access your client ID from the Developer Portal.To use Brand Search API, include your client ID with every request as shown below:
Hotlinking
Hotlinking
We require Brand Search API to be directly embedded in your user-facing applications.The API should be used directly as is, with all data fetched live and not altered or persisted. Your users should make requests to the API directly from their browsers.The logo image URLs provided by the Brand Search API must be hotlinked. Other data, such as brand names, should not be cached and should be used exclusively for building an autocomplete experience. Image URLs expire after 24 hours and must be refetched.For more information on the API’s availability, see our uptime status. We can provide custom SLAs for enterprise customers.If your use case requires more flexibility, please contact us for a custom setup.
Replicating Brandfetch
Replicating Brandfetch
You cannot replicate the core user experience of Brandfetch.The best way to ensure that your application doesn’t violate this guideline is by integrating Brandfetch into an existing app that offers more value than just the Brandfetch integration.Some examples:
- ✅ The Pitch integration helps their users autocomplete brand names to streamline logo search within Pitch’s editor. Without this integration, the app still has a lot of value to its users.
- 🚫 An unofficial Brand Search API that allows users to autocomplete brands. Without the API, the app has no content and no value to users.