> ## 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= 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 CDN serves images from img.logo.dev. The Logo API is the Brand API and the Search API, which return JSON from api.logo.dev/v2. The Transaction Enrichment API (beta) is a separate service at https://www.logo.dev/api/transaction with its own beta key. Credits is the Logo API billing unit. Never recommend the deprecated v1 routes (/search, /brand, /describe, /logo/*) or the Describe API. Use /v2/brands and /v2/search. > 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 > Search brands by name, with match or typeahead ranking, and get each candidate's domain and logo URL. Your dashboard has a publishable key for the Logo CDN and a secret key for the Logo API. Every plan includes both. ## OpenAPI ````yaml /openapi.json get /v2/search openapi: 3.1.0 info: title: Logo.dev API description: >- Logo.dev serves brand assets from two hosts, each with its own key: - **Logo CDN** (`img.logo.dev`) returns a logo image. Authenticate with a **publishable key** in the `token` query parameter. It is safe in client-side code. - **Logo API** (`api.logo.dev`) returns JSON. Authenticate with a **secret key** in the `Authorization: Bearer` header. Call it only from your server. Get your keys from the [dashboard](https://www.logo.dev/dashboard/api-keys). version: 2.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: Logo CDN description: >- Logo images served from img.logo.dev. Authenticate with a publishable key in the `token` query parameter. Metered in monthly impressions. - name: Brands description: >- Brand profiles, logos, and brandmarks as JSON from api.logo.dev. Metered in API credits. - name: Logos description: >- A brand's logo or brandmark as JSON, with a temporary download URL, dimensions, and a blurhash. - name: Search description: Find brands by name. - name: Subscriptions description: Choose which brands send you webhook events. - name: Webhook endpoints description: Manage the URLs that receive webhook events. - name: Transaction Enrichment API description: Turn a card transaction descriptor into a merchant identity. Private beta. paths: /v2/search: get: tags: - Search summary: Search brands description: >- Finds brands by name and returns candidates with their domain and logo URL. `match` searches full names and aliases; `typeahead` completes a prefix as someone types. Costs credits on every request, at the rate on the [API rate card](https://www.logo.dev/pricing#api-pricing). Follow up with [Look up a brand](/api-reference/brands/look-up-a-brand) for the full profile. operationId: v2SearchBrands parameters: - name: q in: query required: true description: The name to search for. schema: type: string examples: - sweetgreen - name: method in: query required: false description: '`match` for full names, `typeahead` for partial input.' schema: type: string enum: - match - typeahead default: match - name: limit in: query required: false description: Results to return. schema: type: integer minimum: 1 maximum: 25 default: 10 responses: '200': description: Matching brands, best first. An empty array when nothing matches. headers: Request-Id: $ref: '#/components/headers/V2RequestId' Credits-Charged: $ref: '#/components/headers/V2CreditsCharged' Credits-Remaining: $ref: '#/components/headers/V2CreditsRemaining' RateLimit-Limit: $ref: '#/components/headers/V2SearchRateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/V2SearchRateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/V2SearchRateLimitReset' content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/V2SearchResult' metadata: $ref: '#/components/schemas/V2Metadata' required: - data - metadata example: data: - object: search_result name: Sweetgreen domain: sweetgreen.com logo_url: >- https://img.logo.dev/sweetgreen.com?token=LOGO_DEV_PUBLISHABLE_KEY metadata: request_id: request_01k6z8m2a4b5c6d7e8f9g0h1j2 '400': description: '`q` is missing, or `method` or `limit` is invalid.' content: application/json: schema: $ref: '#/components/schemas/V2Error' example: error: code: invalid_request message: q is required target: q docs_url: https://www.logo.dev/docs/platform/errors '401': $ref: '#/components/responses/V2Unauthorized' '402': $ref: '#/components/responses/V2SearchPaymentRequired' '429': $ref: '#/components/responses/V2SearchRateLimited' '500': description: Search failed. Retry. content: application/json: schema: $ref: '#/components/schemas/V2Error' example: error: code: internal message: failed to search docs_url: https://www.logo.dev/docs/platform/errors headers: RateLimit-Limit: $ref: '#/components/headers/V2SearchRateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/V2SearchRateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/V2SearchRateLimitReset' security: - secretKey: [] components: headers: V2RequestId: description: Unique id for this request. Include it when you contact support. schema: type: string V2CreditsCharged: description: '`1` when this request was billed, `0` when it was not.' schema: type: integer enum: - 0 - 1 V2CreditsRemaining: description: Your remaining credit balance. Omitted when no balance is available. schema: type: string examples: - '18966.99' V2SearchRateLimitLimit: description: >- Search requests allowed per minute for your account. Search has its own pool, separate from brand lookups. schema: type: integer V2SearchRateLimitRemaining: description: Search requests left in the current minute. schema: type: integer V2SearchRateLimitReset: description: Seconds until the current search window resets. schema: type: integer schemas: V2SearchResult: type: object properties: object: type: string const: search_result name: type: string domain: type: string logo_url: type: string format: uri description: Logo URL signed with your account's publishable key. required: - object - name - domain - logo_url V2Metadata: type: object properties: request_id: type: string description: Unique id for this request. Also sent as the `Request-Id` header. examples: - request_01k6z8m2a4b5c6d7e8f9g0h1j2 resolution: allOf: - $ref: '#/components/schemas/V2Resolution' description: Brand and image lookups only. pending: allOf: - $ref: '#/components/schemas/V2Pending' description: '`202` responses only.' subscription: type: object description: >- Present when a brand lookup (`GET /v2/brands` or `GET /v2/brands/{id}`) ran the automatic subscribe: webhooks are on for the account, and `nosubscribe` is not `true`. See [automatic subscriptions](/brand/introduction#automatic-subscriptions). properties: status: type: string enum: - subscribed - quota_exceeded description: >- `subscribed`: the account is subscribed to the brand. `quota_exceeded`: the account is at its plan's subscription limit, so the brand was not subscribed. The lookup is answered and billed either way. message: type: string description: Why the subscribe was refused. Only with `quota_exceeded`. required: - status required: - request_id V2Error: type: object description: Error envelope for v2 routes. properties: error: type: object properties: code: type: string enum: - invalid_request - unauthorized - forbidden - resource_missing - insufficient_credits - rate_limited - limit_exceeded - internal message: type: string target: type: string description: The parameter at fault, when there is exactly one. required: - code - message docs_url: type: string format: uri description: Documentation for this class of error. required: - error V2Resolution: type: object description: How the request identified the brand. properties: type: type: string enum: - domain - ticker - isin - crypto - name - brand_id description: Which identifier the request used. value: type: string description: >- The identifier after normalization: the registrable domain, an upper-cased ticker, and so on. method: type: string enum: - direct - domain - security - crypto - search - '' description: >- How the identifier reached the brand. `direct` is a brand id or a domain that is its own brand; `domain` went through an alias or redirect; `security` is a ticker or ISIN; `crypto` is a crypto token symbol; `search` is a name lookup. Empty on a cached miss. context: type: object description: >- Reserved for brands involved in a merchant lookup. Always `{}` today. required: - type - value - method - context V2Pending: type: object description: Present only on a `202`. Tells you when to retry. properties: reason: type: string enum: - indexing - resolving description: >- `indexing` is a brand's first crawl; `resolving` means the identifier is still being matched to a brand. message: type: string retry_after_seconds: type: integer description: Wait this long before retrying. Matches the `Retry-After` header. examples: - 30 expires_in_seconds: type: integer description: Stop polling after this long. examples: - 300 webhook: type: boolean description: >- Whether a `brand.indexed` webhook event carrying this request's `request_id` will be sent when the lookup settles. doc_url: type: string format: uri required: - reason - message - retry_after_seconds - expires_in_seconds - webhook - doc_url V2AuthError: type: object description: >- Returned when the secret key is missing, malformed, unknown, or disabled, before the request reaches the v2 route. properties: msg: type: string docs_url: type: string format: uri required: - msg responses: V2Unauthorized: description: >- The secret key is missing, malformed, unknown, or disabled. A publishable key (`pk_`) is refused. content: application/json: schema: oneOf: - $ref: '#/components/schemas/V2AuthError' - $ref: '#/components/schemas/V2Error' example: msg: invalid api token. make sure to use your secret key. docs_url: https://www.logo.dev/docs/platform/api-keys V2SearchPaymentRequired: description: Your account is out of credits. content: application/json: schema: $ref: '#/components/schemas/V2Error' example: error: code: insufficient_credits message: >- out of credits for the brand API. purchase credits at https://www.logo.dev/dashboard docs_url: https://www.logo.dev/docs/platform/errors headers: RateLimit-Limit: $ref: '#/components/headers/V2SearchRateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/V2SearchRateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/V2SearchRateLimitReset' V2SearchRateLimited: description: >- Too many searches this minute. Search has its own per-minute limit, separate from lookups. Wait for `RateLimit-Reset` seconds. Not billed. See [search rate limit](/platform/rate-limits#search-rate-limit). headers: RateLimit-Limit: $ref: '#/components/headers/V2SearchRateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/V2SearchRateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/V2SearchRateLimitReset' content: application/json: schema: $ref: '#/components/schemas/V2Error' example: error: code: rate_limited message: >- rate limit reached. no more than {limit} search requests per minute per account. docs_url: https://www.logo.dev/docs/platform/rate-limits securitySchemes: secretKey: type: http scheme: bearer description: >- Your secret key (`sk_`), as `Bearer sk_...`. Call the Logo API only from your server. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.