Product Model | Channel3

Every product returned by the Channel3 API follows a consistent data model. This guide explains the key fields and how to use them.

Product

A Product represents a canonical product in the Channel3 catalog. Key fields include:

Field	Type	Description
`id`	string	Unique product identifier
`name`	string	Product name
`description`	string	Product description
`brand`	object	Brand information (`id`, `name`)
`category`	object	Category information (`slug`, `name`)
`images`	array	Product images
`offers`	array	Purchase offers from different retailers
`variants`	array	Product variants (sizes, colors, etc.)

Each product may have multiple offers from different retailers:

Field	Type	Description
`price`	object	Current price (`amount`, `currency`)
`availability`	string	`InStock`, `OutOfStock`, or `LimitedAvailability`
`url`	string	Purchase URL (short-lived — always fetch fresh)
`website_id`	string	Retailer website identifier

Product images include quality and type metadata:

Field	Type	Description
`url`	string	Image URL
`type`	string	Image type (e.g. `product`, `lifestyle`)
`quality`	string	Image quality rating

Products can have variants for different sizes, colors, and other options:

Field	Type	Description
`options`	array	Available variant options
`selected_options`	array	Currently selected variant combination