Product Detail

Python

import os
from channel3_sdk import Channel3

client = Channel3(
    api_key=os.environ.get("CHANNEL3_API_KEY"),  # This is the default and can be omitted
)
product_detail = client.products.retrieve(
    product_id="product_id",
)
print(product_detail.id)

import Channel3 from '@channel3/sdk';

const client = new Channel3({
  apiKey: process.env['CHANNEL3_API_KEY'], // This is the default and can be omitted
});

const productDetail = await client.products.retrieve('product_id');

console.log(productDetail.id);

curl --request GET \
  --url https://api.trychannel3.com/v1/products/{product_id} \
  --header 'x-api-key: <api-key>'

{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "brands": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "images": [],
  "categories": [
    "<string>"
  ],
  "category": {
    "slug": "<string>",
    "title": "<string>",
    "has_children": true,
    "path": [
      {
        "slug": "<string>",
        "title": "<string>"
      }
    ]
  },
  "materials": [
    "<string>"
  ],
  "key_features": [
    "<string>"
  ],
  "offers": [
    {
      "url": "<string>",
      "domain": "<string>",
      "price": {
        "price": 123,
        "currency": "<string>",
        "compare_at_price": 123
      },
      "max_commission_rate": 0,
      "dimensions": {
        "length": {
          "number": 123
        },
        "width": {
          "number": 123
        },
        "height": {
          "number": 123
        },
        "weight": {
          "number": 123
        }
      }
    }
  ],
  "variants": {
    "options": [
      {
        "name": "<string>",
        "values": [
          {
            "label": "<string>",
            "exists": true,
            "thumbnail_url": "<string>",
            "product_id": "<string>"
          }
        ]
      }
    ],
    "selected": [
      {
        "name": "<string>",
        "label": "<string>"
      }
    ]
  },
  "structured_attributes": {}
}

GET

products

{product_id}

Python

import os
from channel3_sdk import Channel3

client = Channel3(
    api_key=os.environ.get("CHANNEL3_API_KEY"),  # This is the default and can be omitted
)
product_detail = client.products.retrieve(
    product_id="product_id",
)
print(product_detail.id)

import Channel3 from '@channel3/sdk';

const client = new Channel3({
  apiKey: process.env['CHANNEL3_API_KEY'], // This is the default and can be omitted
});

const productDetail = await client.products.retrieve('product_id');

console.log(productDetail.id);

curl --request GET \
  --url https://api.trychannel3.com/v1/products/{product_id} \
  --header 'x-api-key: <api-key>'

{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "brands": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "images": [],
  "categories": [
    "<string>"
  ],
  "category": {
    "slug": "<string>",
    "title": "<string>",
    "has_children": true,
    "path": [
      {
        "slug": "<string>",
        "title": "<string>"
      }
    ]
  },
  "materials": [
    "<string>"
  ],
  "key_features": [
    "<string>"
  ],
  "offers": [
    {
      "url": "<string>",
      "domain": "<string>",
      "price": {
        "price": 123,
        "currency": "<string>",
        "compare_at_price": 123
      },
      "max_commission_rate": 0,
      "dimensions": {
        "length": {
          "number": 123
        },
        "width": {
          "number": 123
        },
        "height": {
          "number": 123
        },
        "weight": {
          "number": 123
        }
      }
    }
  ],
  "variants": {
    "options": [
      {
        "name": "<string>",
        "values": [
          {
            "label": "<string>",
            "exists": true,
            "thumbnail_url": "<string>",
            "product_id": "<string>"
          }
        ]
      }
    ],
    "selected": [
      {
        "name": "<string>",
        "label": "<string>"
      }
    ]
  },
  "structured_attributes": {}
}

Authorizations

x-api-key

string

header

required

Path Parameters

product_id

string

required

Query Parameters

website_ids

string[] | null

Optional list of website IDs to constrain the buy URL to, relevant if multiple merchants exist. Accepts website IDs or domains (e.g. "nike.com").

language

enum<string> | null

ISO 639-1 language code. Matches any language when unset; defaults to 'en' only when country and currency are also unset.

Available options:

en,

de,

fr,

it,

es,

nl,

sv,

fi,

pt,

cs,

el,

ro

country

enum<string> | null

ISO 3166-1 alpha-2 country code. Matches any country when unset; defaults to 'US' only when language and currency are also unset.

Available options:

US,

GB,

EU,

AU,

CA,

IE,

DE,

AT,

FR,

BE,

IT,

ES,

NL,

SE,

FI,

PT,

CZ,

GR,

RO

currency

enum<string> | null

ISO 4217 currency code. When unset, inferred from country (e.g. GB -> GBP); falls back to 'USD' only when all three locale fields are unset.

Available options:

USD,

CAD,

AUD,

GBP,

EUR,

SEK,

CZK,

RON

length_unit

enum<string> | null

Preferred unit for length dimensions (length/width/height). When unset, dimensions are returned in the unit the merchant stated.

Available options:

mm,

cm,

m,

in,

ft

weight_unit

enum<string> | null

Preferred unit for weight dimensions. When unset, weight is returned in the unit the merchant stated.

Available options:

mg,

g,

kg,

oz,

lb

Response

Successful Response

Product with detailed information.

string

required

title

string

required

description

string | null

brands

ProductBrand · object[]

Ordered list of brands.

Show child attributes

images

ProductImage · object[]

Show child attributes

Models

Product

Brands

Categories

Websites

Price Tracking

Authorizations

Path Parameters

Query Parameters

Response