Similar Products

Python

from channel3_sdk import Channel3
from channel3_sdk.environment import Channel3Environment

client = Channel3(
    api_key="<value>",
    environment=Channel3Environment.PRODUCTION,
)

client.products.find_similar(
    product_id="product_id",
)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({product_id: '<string>'})
};

fetch('https://api.trychannel3.com/v1/similar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "products": [
    {
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "brands": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "images": [],
      "category": {
        "slug": "<string>",
        "title": "<string>",
        "has_children": true,
        "path": [
          {
            "slug": "<string>",
            "title": "<string>"
          }
        ]
      },
      "gender": "male",
      "age": "newborn",
      "materials": [
        "<string>"
      ],
      "key_features": [
        "<string>"
      ],
      "colors": [
        {
          "hex": "<string>",
          "percentage": 123
        }
      ],
      "offers": [
        {
          "url": "<string>",
          "domain": "<string>",
          "price": {
            "price": 123,
            "currency": "<string>",
            "compare_at_price": 123
          },
          "availability": "InStock",
          "condition": "new",
          "max_commission_rate": 0,
          "dimensions": {
            "length": {
              "number": 123,
              "unit": "mm"
            },
            "width": {
              "number": 123,
              "unit": "mm"
            },
            "height": {
              "number": 123,
              "unit": "mm"
            },
            "weight": {
              "number": 123,
              "unit": "mg"
            }
          }
        }
      ],
      "variants": {
        "options": [
          {
            "name": "<string>",
            "values": [
              {
                "label": "<string>",
                "exists": true,
                "available": "InStock",
                "thumbnail_url": "<string>",
                "product_id": "<string>"
              }
            ]
          }
        ],
        "selected": [
          {
            "name": "<string>",
            "label": "<string>"
          }
        ]
      },
      "structured_attributes": {},
      "ratings": {
        "value": 123,
        "count": 123,
        "source_count": 123
      }
    }
  ],
  "next_page_token": "<string>"
}

POST

similar

Python

from channel3_sdk import Channel3
from channel3_sdk.environment import Channel3Environment

client = Channel3(
    api_key="<value>",
    environment=Channel3Environment.PRODUCTION,
)

client.products.find_similar(
    product_id="product_id",
)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({product_id: '<string>'})
};

fetch('https://api.trychannel3.com/v1/similar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "products": [
    {
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "brands": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ],
      "images": [],
      "category": {
        "slug": "<string>",
        "title": "<string>",
        "has_children": true,
        "path": [
          {
            "slug": "<string>",
            "title": "<string>"
          }
        ]
      },
      "gender": "male",
      "age": "newborn",
      "materials": [
        "<string>"
      ],
      "key_features": [
        "<string>"
      ],
      "colors": [
        {
          "hex": "<string>",
          "percentage": 123
        }
      ],
      "offers": [
        {
          "url": "<string>",
          "domain": "<string>",
          "price": {
            "price": 123,
            "currency": "<string>",
            "compare_at_price": 123
          },
          "availability": "InStock",
          "condition": "new",
          "max_commission_rate": 0,
          "dimensions": {
            "length": {
              "number": 123,
              "unit": "mm"
            },
            "width": {
              "number": 123,
              "unit": "mm"
            },
            "height": {
              "number": 123,
              "unit": "mm"
            },
            "weight": {
              "number": 123,
              "unit": "mg"
            }
          }
        }
      ],
      "variants": {
        "options": [
          {
            "name": "<string>",
            "values": [
              {
                "label": "<string>",
                "exists": true,
                "available": "InStock",
                "thumbnail_url": "<string>",
                "product_id": "<string>"
              }
            ]
          }
        ],
        "selected": [
          {
            "name": "<string>",
            "label": "<string>"
          }
        ]
      },
      "structured_attributes": {},
      "ratings": {
        "value": 123,
        "count": 123,
        "source_count": 123
      }
    }
  ],
  "next_page_token": "<string>"
}

Authorizations

x-api-key

string

header

required

Headers

x-user-id

string | null

Optional user identifier to attribute clicks and sales to a user in your system. Channel3 appends it to buy URLs in the response.

Body

application/json

Find products similar to a given product.

product_id

string

required

Canonical product ID to find similar products for.

limit

integer | null

default:20

Optional limit on the number of results. Default is 20, max is 30.

Required range: x >= 1

filters

SearchFilters · object

Optional filters. Search will only consider products that match all of the filters.

Show child attributes

config

BaseConfig · object

Optional configuration.

Show child attributes

page_token

string | null

Opaque token from a previous similar response to fetch the next page of results.

Response

Successful Response

v1 paginated search response.

products

Product · object[]

required

Show child attributes

next_page_token

string | null

Token to fetch the next page. Null when no more results.

Products

Conversational Agent

Collections

Brands

Categories

Websites

Reporting

Price tracking

Models

Authorizations

Headers

Body

Response