> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brandfetch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Brand Search API

> Match brand names to their domain and logo

[Brand Search API](https://brandfetch.com/developers/brand-search-api) provides fast querying of brands. It lets you search by brand names and match them to their corresponding URLs, enabling you to create rich autocomplete experiences.

The Brand Search API is designed to work in tandem with our other services. Once a user selects a brand, you can use its unique identifier to retrieve detailed data using our other APIs.

## Implementation guide

<Steps>
  <Step title="Get your client ID">
    You’ll need to create an account on our [Developer Portal](https://developers.brandfetch.com/register). Creating an account is quick and easy, and will give you access to your dashboard where you’ll find your client ID.
  </Step>

  <Step title="Make your first API call">
    <Tip>
      Brand Search API is free to use and <u>we don't ask for any attribution</u>.
    </Tip>

    Implement or run the code below to make your first API request.

    <CodeGroup>
      ```curl curl theme={null}
      curl --request GET \
      --url "https://api.brandfetch.io/v2/search/:name?c=BRANDFETCH_CLIENT_ID"
      ```
    </CodeGroup>

    Authentication is done by passing your client ID as a query parameter.
  </Step>

  <Step title="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](#rate-limits) and review our [usage guidelines](#usage-guidelines) to ensure a smooth launch.
  </Step>
</Steps>

## Usage guidelines

<AccordionGroup>
  <Accordion title="Authentication" defaultOpen="true">
    **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](https://developers.brandfetch.com/register) and access your client ID from the Developer Portal.

    To use Brand Search API, include your client ID with every request as shown below:

    <CodeGroup>
      ```curl curl theme={null}
      curl --request GET \
      --url "https://api.brandfetch.io/v2/search/:name?c=BRANDFETCH_CLIENT_ID"
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="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.

    <b>The logo image URLs provided by the Brand Search API must be hotlinked</b>. 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](https://status.brandfetch.io/). We can provide custom SLAs for enterprise customers.

    If your use case requires more flexibility, please [contact us](https://brandfetch.com/developers/contact/sales) for a custom setup.
  </Accordion>

  <Accordion title="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](https://brandfetch.com/developers/customers/pitch) 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.

    If you're unsure about your use case, please [contact us](https://brandfetch.com/developers/contact).
  </Accordion>
</AccordionGroup>

## Rate limits

We offer a fair use base rate limit of <b>500,000 requests per month</b>, with <b>200 requests per 5 minutes per IP address</b>, which is designed to cover most small to medium applications. The rate limit should allow for roughly 30 search-sessions in a 5-minute period and is intended to discourage abuse. Use a [debounce strategy](https://developer.mozilla.org/en-US/docs/Glossary/Debounce) inbetween keystrokes to avoid hitting the rate limit.

If your usage approaches the monthly limit, we may reach out to discuss an upgrade to a paid, unlimited tier.

For enterprises, we provide custom solutions, including SLA agreements, custom terms, and flexible caching options to ensure optimal performance at scale. These plans are tailored to meet the needs of high-volume users.

Feel free to [contact us](https://brandfetch.com/developers/contact/sales) to discuss the right plan for your use case.

## API Reference

For more details, refer to our [API Reference](/reference/brand-search-api).