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

# Search Products

Use `channel3 products search` for keyword search. Add filters as JSON, or target an individual field with `--filters.<name>`.

```sh theme={null}
channel3 products search --query "organic cotton t-shirt"
```

## Filters

```sh theme={null}
channel3 products search \
  --query "running shoes" \
  --filters '{
    "price": { "min_price": 50, "max_price": 150 },
    "availability": ["InStock"],
    "gender": "male"
  }'
```

Or specify individual fields:

```sh theme={null}
channel3 products search \
  --query "sweater" \
  --filters.price '{"min_price":50,"max_price":200}' \
  --filters.availability '["InStock"]'
```

Use [brand](/cli/brands), [website](/cli/websites), and [category](/cli/categories) IDs or slugs with the corresponding filter fields.

## Pagination

```sh theme={null}
channel3 products search --query "running shoes" --limit 20
```

Pass the response's page token back with the pagination flag shown by `channel3 products search --help`.

## Locale

```sh theme={null}
channel3 products search \
  --query "trainers" \
  --config.country=GB \
  --config.language=en \
  --config.currency=GBP
```

For request semantics and filter behavior, see [What you request](/guides/request-overview).