Product - Channel3

A product is a single canonical item in Channel3’s catalog — for example “Nike Air Force 1 ‘07”. Every product has a unique id, even when many retailers sell it. Those retailer listings are offers, not separate products.

Example product

{
  "id": "2yh8WH5", // Unique ID for this canonical product
  "title": "Nike Air Force 1 '07",
  ...
  "offers": [
    // One product can have offers from multiple retailers
    {
      "domain": "nike.com",
      "price": { "amount": 110, "currency": "USD" },
      "availability": "InStock",
      "url": "https://www.buy.trychannel3.com/..."
    },
    {
      "domain": "footlocker.com",
      "price": { "amount": 105, "currency": "USD" },
      "availability": "InStock",
      "url": "https://www.buy.trychannel3.com/..."
    }
  ]
}

See the full Product Object.

Get products

Search returns a products[] array. Each result is a canonical product, with its offers:

import Channel3 from "@channel3/sdk";

const client = new Channel3();
const results = await client.products.search({
  query: "Nike Air Force 1",
});

from channel3_sdk import Channel3

client = Channel3()
results = client.products.search(query="Nike Air Force 1")

curl -X POST https://api.trychannel3.com/v1/search -H "x-api-key: $CHANNEL3_API_KEY" -H "Content-Type: application/json" -d '{"query": "Nike Air Force 1"}'

Product detail

To fetch one product by its unique ID, use Product Detail (GET /v1/products/{product_id}):

const product = await client.products.retrieve("2yh8WH5");

product = client.products.retrieve("2yh8WH5")

curl https://api.trychannel3.com/v1/products/2yh8WH5 -H "x-api-key: $CHANNEL3_API_KEY"

⌘I