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.

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

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 },
  },
});

from channel3_sdk import Channel3

client = Channel3()

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

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.

const results = await client.products.search({
  query: "office chair",
  filters: {
    price: { max_price: 200 },
  },
});

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.

const results = await client.products.search({
  query: "leather sofa",
  currency: "GBP",
  filters: {
    price: { max_price: 800 },
  },
});

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

const results = await client.products.search({
  query: "sneakers",
  filters: {
    price: { min_price: 80, max_price: 200 },
    brand_ids: ["brand_nike"],
    availability: ["InStock"],
  },
});

⌘I

Getting Started

Make a Search

Get Product Data

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ

Basic price range

Under a price ceiling

Currency

Combining with other filters

​Basic price range

​Under a price ceiling

​Currency

​Combining with other filters

Basic price range

Under a price ceiling

Currency

Combining with other filters