---
title: "Brand Search"
method: GET
path: "/brand/search"
tags: ["Brand Intelligence"]
---

# Brand Search

`GET /brand/search`

Search indexed brands by name or domain

## Query parameters

- `query` string, required — Search term, matched against the fields selected by queryBy (e.g. 'nike', 'nike.com', 'nik').
- `autocomplete` boolean — Whether the search term matches by prefix, so partial words match as they are typed (e.g. 'nik' matches Nike). Set to false to match whole words only.
- `queryBy` string[] — Fields to match the search term against, as a comma-separated list or repeated parameter: 'name', 'domain', or both. Defaults to both.
- `typoTolerance` integer — Maximum number of typos tolerated when matching, from 0 to 2. Defaults to 0 (no typo tolerance).
- `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

Successful response

- object
  - `results` object[], required — Up to 10 matching brands, name matches first, then domain matches, most popular first within each group. Empty when nothing matches.
    - `domain` string, required — The brand's domain.
    - `name` string, required — The brand's name. Empty string when unknown.
    - `logo` string, required — Logo link URL that serves the brand's logo, generated per request for the calling organization.
  - `key_metadata` KeyMetadata — Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
    - `credits_consumed` integer, required — The number of credits consumed by this request.
    - `credits_remaining` integer, required — The number of credits remaining for your organization after this request.

## Other responses

- `400` — Bad Request - Invalid or missing search query
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions or usage limit exceeded
- `408` — Request timeout
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/context/apis/context-dev.md) · [All operations](https://skmtc.net/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/context/context-dev/revisions/24d2b91f5275/schema)