> ## 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

> Search for brands by name, login to get a clientId

<Note>
  Read our [guidelines](/brand-search-api/overview#usage-guidelines) before
  using the Brand Search API.
</Note>


## OpenAPI

````yaml GET /v2/search/{name}?c={clientId}
openapi: 3.0.1
info:
  title: Brandfetch API
  description: >-
    Our APIs help you personalize your customer journey through unique branded
    experiences.
  license:
    name: MIT
  version: 1.0.0
  contact:
    name: Brandfetch Support
    url: https://brandfetch.com
    email: support@brandfetch.io
servers:
  - url: https://api.brandfetch.io
security: []
paths:
  /v2/search/{name}?c={clientId}:
    get:
      summary: Search brands
      description: Search for brands by name, login to get a clientId
      operationId: searchBrands
      parameters:
        - name: name
          in: path
          description: The name of the company you are searching for.
          required: true
          schema:
            type: string
        - name: c
          in: query
          description: >-
            A clientId is a unique identifier assigned to your application that
            allows it to authenticate and interact with our service. [Get your
            client ID here](https://developers.brandfetch.com)
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Returns brand data
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    icon:
                      type: string
                      description: Brand icon URL
                      nullable: true
                    name:
                      type: string
                      description: Brand name
                      nullable: true
                    domain:
                      type: string
                      description: Brand website URL
                      nullable: false
                    claimed:
                      type: boolean
                      description: >-
                        Set to true if the owner of the brand claimed its brand
                        profile on [Brandfetch](https://brandfetch.com)
                    brandId:
                      type: string
                      description: Unique identifier for the brand
        '429':
          description: >-
            Refused. The organization behind the client ID has searched far
            beyond its monthly Brand Search allowance, the client ID went over
            its throughput limit of 6,000 requests per 5 minutes, or the per-IP
            throughput limit of 200 requests per 5 minutes was exceeded. All
            three carry a JSON body with a `message`. The first two also carry
            `x-bf-error` naming the reason (`quota_exceeded` or `rate_limited`),
            the same code in `error`, and a `docs` link; the allowance refusal
            lifts when the allowance is raised or the billing period rolls over,
            the client ID throughput refusal once the rate falls back under the
            limit. The per-IP refusal carries neither the header nor `error`.
            See [rate limits](/brand-search-api/overview#rate-limits).
          headers:
            x-bf-error:
              description: >-
                Present when the edge refused the request for exceeding the
                monthly allowance or the client ID throughput limit. Absent on a
                per-IP throughput refusal.
              schema:
                type: string
                enum:
                  - quota_exceeded
                  - rate_limited
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  error:
                    type: string
                    description: >-
                      Present on the allowance and client ID throughput
                      refusals, matching the `x-bf-error` header.
                    enum:
                      - quota_exceeded
                      - rate_limited
                  message:
                    type: string
                    example: Slow down.
                  docs:
                    type: string
                    format: uri
                    description: >-
                      Present on the allowance and client ID throughput
                      refusals.
                    example: >-
                      https://docs.brandfetch.com/brand-search-api/overview#errors
        '503':
          description: >-
            The search could not be answered. Retry after about 10 seconds: an
            identical request made sooner can get the same response. A `503`
            does not count towards your Brand Search allowance. See
            [errors](/brand-search-api/overview#errors).
          headers:
            x-bf-error:
              description: '`temporarily_unavailable` when the search itself failed.'
              schema:
                type: string
                enum:
                  - temporarily_unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
                    example: Brand Search is temporarily unavailable. Please retry.
      security:
        - clientId: []
components:
  securitySchemes:
    clientId:
      type: apiKey
      in: query
      name: c
      description: >-
        Your Brand Search client ID, sent as the `c` query parameter. Get one at
        https://developers.brandfetch.com.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.