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

## Basic price range

<CodeGroup>
  ```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 } }
    }'
  ```
</CodeGroup>

## Under a price ceiling

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

<CodeGroup>
  ```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}},
  )
  ```
</CodeGroup>

## Currency

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

<CodeGroup>
  ```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}},
  )
  ```
</CodeGroup>

## 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"],
  },
});
```

<Cards>
  <Card title="Search" icon="magnifying-glass" href="/guides/search" arrow="true">
    Full overview of the search endpoint and all available filters.
  </Card>

  <Card title="Brand Search" icon="tag" href="/guides/brand-search" arrow="true">
    Resolve brand IDs to use with the brand\_ids filter.
  </Card>
</Cards>


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