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

# Similar Products

Given a `product_id`, find its closest neighbors. Add `filters` to narrow results by gender, brand, category, or price.

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

const client = new Channel3();

const similar = await client.products.find_similar({
  product_id: "2yh8WH5",
  limit: 10,
  filters: {
    gender: "female",
    price: { max_price: 200 },
  },
});

console.log(similar.products.map((p) => p.title));
```

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

client = Channel3()

similar = client.products.find_similar(
    product_id="2yh8WH5",
    limit=10,
    filters={
        "gender": "female",
        "price": {"max_price": 200},
    },
)
print([p.title for p in similar.products])
```

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://api.trychannel3.com/v1/similar \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": "2yh8WH5", "limit": 10, "filters": {"gender": "female", "price": {"max_price": 200}}}'
```

## Creative uses of `/similar`

* **"Shop the look"** — for a shirt result, filter the similar call to `pants` and `shoes` categories to suggest a full outfit.
* **Couple's shopping** — exclude the source product's gender to surface his-and-hers alternatives.
* **Budget finder** — set a price ceiling based on the source product's price to surface similar but cheaper items.
* **Shop for the whole family** — add an `age` filter (`kids`, `toddler`) to find children's versions of an item.

> **[Image Search](/guides/image-search)**
>
> Search by image URL or base64 upload to find visually matching products.

> **[Advanced Search](/guides/advanced-search)**
>
> Combine similar-product results with structured attribute filters.


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