Dimension

Find products that fit within a size or weight range. This is useful for carry-on luggage limits, furniture that fits a space, or shipping weight restrictions.

Dimension filters apply at the offer level. A product passes if any of its offers falls within the ranges you set.

Basic dimension filter

Set min, max, or both on length, width, height, and weight. Each field needs a unit. Pass only the fields you care about.

import Channel3 from "@channel3/sdk";

const client = new Channel3();

const results = await client.products.search({
  query: "carry-on suitcase",
  filters: {
    dimensions: {
      height: { max: 22, unit: "in" },
      width: { max: 14, unit: "in" },
      weight: { max: 8, unit: "lb" },
    },
  },
});

from channel3_sdk import Channel3

client = Channel3()

results = client.products.search(
    query="carry-on suitcase",
    filters={
        "dimensions": {
            "height": {"max": 22, "unit": "in"},
            "width":  {"max": 14, "unit": "in"},
            "weight": {"max": 8,  "unit": "lb"},
        },
    },
)

curl -X POST https://api.trychannel3.com/v1/search \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "carry-on suitcase",
    "filters": {
      "dimensions": {
        "height": { "max": 22, "unit": "in" },
        "width":  { "max": 14, "unit": "in" },
        "weight": { "max": 8,  "unit": "lb" }
      }
    }
  }'

Units

Length units: mm, cm, m, in, ft. Weight units: mg, g, kg, oz, lb. You can mix units in one request — filter height in inches and weight in pounds, for example.

Filter one dimension

Set only the fields you need. Here, find suitcases under 8 pounds:

TypeScript

const results = await client.products.search({
  query: "carry-on suitcase",
  filters: {
    dimensions: {
      weight: { max: 8, unit: "lb" },
    },
  },
});

⌘I

Getting Started

Make a Search

Get Product Data

Conversational Agent

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ

Basic dimension filter

Units

Filter one dimension

​Basic dimension filter

​Units

​Filter one dimension

Basic dimension filter

Units

Filter one dimension