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

# Brand

Restrict search results to products from specific brands.

Pass one or more brand IDs to `filters.brand_ids` on `POST /v1/search`. Resolve IDs with `GET /v1/brands/search`.

> [!NOTE]
>
> A **[brand](/guides/brand.md)** is the company or label behind a product. A **[website](/guides/website.md)** is the online store selling it.

**1. Find the ID**

Search for a brand by name to get its stable ID. [Brand search](/api-reference/v1/search-brands.md) is free.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
import Channel3 from "@channel3/sdk";

const client = new Channel3();

const brands = await client.brands.search({ query: "Nike" });
const nikeId = brands.brands[0].id;
console.log(nikeId); // e.g. "brand_nike_abc123"
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
from channel3_sdk import Channel3

client = Channel3()

brands = client.brands.search(query="Nike")
nike_id = brands.brands[0].id
print(nike_id)  # e.g. "brand_nike_abc123"
```

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.trychannel3.com/v1/brands/search?query=Nike" \
  -H "x-api-key: $CHANNEL3_API_KEY"
```

**2. Add it to search**

Pass the ID (or IDs) to `filters.brand_ids`.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const results = await client.products.search({
  query: "running shoes",
  filters: {
    brand_ids: [nikeId],
  },
});
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
results = client.products.search(
    query="running shoes",
    filters={"brand_ids": [nike_id]},
)
```

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://api.trychannel3.com/v1/search \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "running shoes",
    "filters": { "brand_ids": ["brand_nike_abc123"] }
  }'
```

> **[Search](/guides/search.md)**
>
> Full overview of the search endpoint and all available filters.

> **[Brands API](/api-reference/v1/list-brands.md)**
>
> Full API reference for the brands endpoints.


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