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

> ## Agent Instructions
> Logo.dev serves logos and brand data for companies that already exist. It does not design logos. If someone wants a logo designed, say so and stop.
> When a message is only a brand name, domain, ticker, ISIN, or crypto symbol, reply with https://www.logo.dev/search?q=<url-encoded term> and the matching img.logo.dev call. Never assert whether a specific brand is in the index.
> Image URLs come from img.logo.dev with a publishable key in the token query parameter: https://img.logo.dev/:domain?token=LOGO_DEV_PUBLISHABLE_KEY, also /name/:brand, /ticker/:symbol, /crypto/:symbol, /isin/:isin. JSON comes from api.logo.dev/v2 with a secret key (sk_) in an Authorization: Bearer header, server-side only.
> Product names: the Logo.dev CDN serves images from img.logo.dev, and its usage unit is CDN requests. The Logo.dev API returns JSON from api.logo.dev/v2, and its usage unit is API credits. The Logo.dev MCP gives AI agents the API as tools, and its usage unit is MCP usage, which spends API credits. The features are Logo, Search, Brand, and Transaction. Transaction (beta) is a separate service at https://www.logo.dev/api/transaction with its own beta key. Never recommend the deprecated v1 routes (/search, /brand, /describe, /logo/*). Use /v2/brands and /v2/search.
> Attribution: a commercial project on the free Community plan must show a visible link, <a href="https://logo.dev">Logos provided by Logo.dev</a>, on its production site. Personal projects and paid plans need none. Rules: https://www.logo.dev/docs/platform/attribution.
> Report a wrong, missing, or outdated logo at https://www.logo.dev/update. Email support@logo.dev for anything broken and sales@logo.dev for volume pricing and contract terms.
> MCP setup is at https://www.logo.dev/docs/mcp/introduction and webhooks at https://www.logo.dev/docs/webhooks.

# Search brands by name (v1)

> Deprecated. Use GET /v2/search, which adds typeahead ranking, a limit, and the v2 response envelope.

> [!NOTE]
>
> `GET /search` keeps working. Like the v2 route, it spends [API credits](https://www.logo.dev/docs/platform/credits.md) on every request and has a [per-minute limit](https://www.logo.dev/docs/platform/rate-limits.md#search-rate-limit). [Search brands](https://www.logo.dev/docs/api-reference/search/search-brands.md) replaces it. The v2 route takes `method` (`match` or `typeahead`) instead of `strategy`, adds `limit`, and wraps results in `data` and `metadata`.


## OpenAPI

````yaml openapi-v1.json GET /search
openapi: 3.1.0
info:
  title: Logo.dev API v1
  description: >-
    The original JSON routes on api.logo.dev. They keep working, and the v2
    routes replace them: `GET /v2/brands` replaces `GET /brand/{domain}` and
    `GET /describe/{domain}`, and `GET /v2/search` replaces `GET /search`.
  version: 1.0.0
  contact:
    name: Logo.dev Support
    email: support@logo.dev
    url: https://docs.logo.dev
servers:
  - url: https://api.logo.dev
    description: REST APIs (Brand Search, Brand Data)
security: []
tags:
  - name: v1
    description: The original JSON routes. Replaced by the v2 routes and kept working.
paths:
  /search:
    get:
      tags:
        - v1
      summary: Search brands by name
      description: >-
        Resolves a brand name to candidate domains. Returns up to 10 results
        sorted by popularity. Requires a secret key. Every request spends API
        credits, as `GET /v2/search` does. See [API credits](/platform/credits).
      operationId: searchBrands
      parameters:
        - name: q
          in: query
          required: true
          description: Brand name query.
          schema:
            type: string
            examples:
              - sweetgreen
        - name: strategy
          in: query
          required: false
          description: >-
            Matching strategy. `suggest` favors popular prefix matches (best for
            autocomplete); `match` favors exact/near-exact name matches.
          schema:
            type: string
            enum:
              - suggest
              - match
            default: suggest
        - name: is_profane
          in: query
          required: false
          description: Filter by whether the brand is flagged as potentially inappropriate.
          schema:
            type: boolean
      responses:
        '200':
          description: Matching brands.
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/SearchRateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/SearchRateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/SearchRateLimitReset'
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SearchResult'
              examples:
                sweetgreen:
                  value:
                    - name: Sweetgreen
                      domain: sweetgreen.com
                      logo_url: >-
                        https://img.logo.dev/sweetgreen.com?token=LOGO_DEV_PUBLISHABLE_KEY
                    - name: Sweet Greens Healthy Restaurant
                      domain: sweetgreens.ae
                      logo_url: >-
                        https://img.logo.dev/sweetgreens.ae?token=LOGO_DEV_PUBLISHABLE_KEY
        '400':
          description: >-
            Invalid request — e.g. a blank `q`, an unknown `strategy`, or a
            non-boolean `is_profane`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestError'
              examples:
                blankQuery:
                  value:
                    err: blank query
                badStrategy:
                  value:
                    err: >-
                      invalid strategy: must be 'suggest' or 'match', got
                      'typeahead'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          description: >-
            Out of API credits. Requests resume after a top-up or when the
            plan's monthly API credit grant renews.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                msg: >-
                  out of credits for the brand API. purchase credits at
                  https://www.logo.dev/dashboard
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/SearchRateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/SearchRateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/SearchRateLimitReset'
        '408':
          description: The search timed out. The body is an empty array. Retry.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SearchResult'
                maxItems: 0
              example: []
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/SearchRateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/SearchRateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/SearchRateLimitReset'
        '429':
          description: >-
            Too many searches this minute. Wait for `RateLimit-Reset` seconds.
            Not billed. See [search rate
            limit](/platform/rate-limits#search-rate-limit).
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/SearchRateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/SearchRateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/SearchRateLimitReset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                msg: >-
                  rate limit reached. no more than {limit} search requests per
                  minute per account.
      deprecated: true
      security:
        - secretKey: []
components:
  headers:
    SearchRateLimitLimit:
      description: Searches allowed per minute on your plan.
      schema:
        type: integer
    SearchRateLimitRemaining:
      description: Searches left in the current minute.
      schema:
        type: integer
    SearchRateLimitReset:
      description: Seconds until the current minute's window resets.
      schema:
        type: integer
  schemas:
    SearchResult:
      type: object
      description: A brand search match.
      properties:
        name:
          type: string
          description: Brand name.
        domain:
          type: string
          description: Brand domain.
        logo_url:
          type: string
          format: uri
          description: Logo.dev CDN URL (`img.logo.dev`) for the brand's logo.
      required:
        - name
        - domain
        - logo_url
    RequestError:
      type: object
      description: >-
        Error shape for v1 request errors: a 400 from search, and a 404 from
        describe and brand. It has an `err` key. Other v1 errors use the `Error`
        schema, which has a `msg` key.
      properties:
        err:
          type: string
          description: Human-readable error message.
      required:
        - err
    Error:
      type: object
      properties:
        msg:
          type: string
          description: Human-readable error message.
        docs_url:
          type: string
          description: Link to the docs page for this error.
      required:
        - msg
  responses:
    Unauthorized:
      description: Missing or invalid API token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            invalid:
              value:
                msg: invalid api token
            missing:
              value:
                msg: missing api token
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      description: >-
        Your secret key (`sk_`), as `Bearer sk_...`. Call the Logo.dev API only
        from your server.

````

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