Channel3 API Integration Guide

Channel3 is a universal product catalog API. Pick the endpoint(s) that match the developer's input.

Developer has...	Use
Free-text query, image URL, or both	`POST /v1/search`
Channel3 `product_id` and wants similar items	`POST /v1/similar`
Channel3 `product_id` and wants full details	`GET /v1/products/{id}`
A `product_id` and a variant choice (color/size/...) and wants the matching offers	`GET /v1/products/{id}` with `option_<name>=<label>` query params
A merchant URL and wants the canonical product	`POST /v1/lookup`
A `product_id` and wants price-change alerts	`POST /v0/price-tracking/start`
A free-text term and wants matching category slugs	`GET /v1/categories/search`
A color constraint (blue, navy, red, ...)	`filters.colors` on `POST /v1/search` or `POST /v1/similar` — map color names to sRGB hex; never `filters.attributes.color`
Non-color structured attributes (material, frame-color, ...)	`filters.attributes` on `POST /v1/search` or `POST /v1/similar` — discover handles/values via `Category.attributes` (skip the `color` handle)

channel3-api