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

# Price

Add a price filter to find products with offers greater than `min_price` and less than `max_price`. Either bound is optional; set only one to create an open-ended range.

> [!NOTE]
>
> Price filters apply at the **offer** level, not the product level. A product
> passes the price filter if **any** of its offers falls within the range.

## Basic price range

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

const client = new Channel3();

const results = await client.products.search({
  query: "running shoes",
  filters: {
    price: { min_price: 50, max_price: 150 },
  },
});
```

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

client = Channel3()

results = client.products.search(
    query="running shoes",
    filters={
        "price": {"min_price": 50, "max_price": 150},
    },
)
```

```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": { "price": { "min_price": 50, "max_price": 150 } }
  }'
```

## Under a price ceiling

Set only `max_price` to find products below a given price.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const results = await client.products.search({
  query: "office chair",
  filters: {
    price: { max_price: 200 },
  },
});
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
results = client.products.search(
    query="office chair",
    filters={"price": {"max_price": 200}},
)
```

## Currency

Pass a `currency` parameter alongside the price filter to search in a non-USD currency.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const results = await client.products.search({
  query: "leather sofa",
  currency: "GBP",
  filters: {
    price: { max_price: 800 },
  },
});
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
results = client.products.search(
    query="leather sofa",
    currency="GBP",
    filters={"price": {"max_price": 800}},
)
```

## Combining with other filters

Price filters compose freely with all other filters.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const results = await client.products.search({
  query: "sneakers",
  filters: {
    price: { min_price: 80, max_price: 200 },
    brand_ids: ["brand_nike"],
    availability: ["InStock"],
  },
});
```

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

> **[Brand Search](/guides/brand-search)**
>
> Resolve brand IDs to use with the brand\_ids filter.


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