Taste Profile

Taste Profile is available for enterprise customers; contact support@channel3.ai for access.

A taste profile is a saved ranking configuration that tunes which products rise to the top for your shoppers. You pass it as config.taste_profile_id, the same way you pass config.collection_id.

Pass a taste profile

const results = await client.products.search({
  query: "table lamp",
  config: {
    taste_profile_id: "TASTE_PROFILE_ID",
    collection_id: "COLLECTION_ID", // optional
  },
});

results = client.products.search(
    query="table lamp",
    config={
        "taste_profile_id": "TASTE_PROFILE_ID",
        "collection_id": "COLLECTION_ID",  # optional
    },
)

It works on search, in both the default and agentic modes, and on conversations. The Channel3 team sets up each profile with you. The sections below show what a profile can hold.

Brand and website boosts

Boost (positive weight) or bury (negative weight, down to -1) products from listed brands or websites.

{
  "boosts": [
    { "brand_ids": ["brand_abc123"], "weight": 0.5 },
    { "website_ids": ["web_def456"], "weight": -0.8 }
  ]
}

Boosted brands also get an extra retrieval pass, so they can appear even when the query alone would miss them. Brand boosts don’t apply to searches for a specific product or queries that name a brand, so the shopper’s intent wins.

Price tier preference

Prefer brands by where they sit on price: low, medium, high or xhigh.

{
  "boosts": [{ "price_tiers": ["high", "xhigh"], "weight": 0.4 }]
}

Channel3 places each brand from where its products fall in each category’s price distribution, so high means roughly the top 40% of brands by price.

Conditions

Attach a condition to any rule so it only applies to some queries, categories or dates.

{
  "brand_ids": ["brand_abc123"],
  "weight": 0.6,
  "condition": {
    "query_terms": [{ "value": "candle", "full_match": false }],
    "category_ids": ["home-decor"],
    "active_ranges": [{ "start": "2026-11-20", "end": "2026-12-31" }]
  }
}

query_terms: with full_match: true the whole query must equal the term; otherwise the query must contain all its words.
category_ids: the rule applies when the query maps to one of these categories.
active_ranges: the rule applies only between start and end, for example a holiday season.

Pins

Put a specific product at a fixed position (1–20) when a condition matches.

{
  "pins": [
    {
      "product_id": "prod_xyz789",
      "position": 1,
      "condition": { "query_terms": [{ "value": "throw blanket", "full_match": true }] }
    }
  ]
}

A profile can hold up to 10 pins, and each pin needs a condition with query_terms or category_ids.

Diversity

Cap how many results from one brand or one merchant show on a page.

{
  "diversity": { "max_per_brand": 3, "max_per_merchant": 5 }
}

Query rewrites

Rewrite the shopper’s query before Channel3 searches.

{
  "query_rewrites": {
    "replacements": [{ "term": "lamp shade", "replacement": "lampshade" }],
    "ignore_terms": [{ "term": "cheap" }],
    "one_way_synonyms": [{ "term": "dinnerware", "synonyms": ["plates"] }],
    "two_way_synonyms": [{ "terms": ["sofa", "couch"] }],
    "do_not_associate": [{ "term": "vase", "terms": ["vinyl", "record"] }]
  }
}

replacements: swap one term for another.
ignore_terms: drop words that don’t help, like “cheap”.
one_way_synonyms: “dinnerware” also searches “plates”, but not the reverse.
two_way_synonyms: “sofa” and “couch” search for each other.
do_not_associate: when the query has the term, drop results whose titles contain the listed terms, so “vase” never returns vinyl records.

Example profile

A home-decor retailer that favours its premium brands, promotes candles for the holidays and keeps results varied:

{
  "boosts": [
    { "brand_ids": ["brand_abc123", "brand_ghi789"], "weight": 0.5 },
    { "website_ids": ["web_def456"], "weight": -0.6 },
    { "price_tiers": ["high"], "weight": 0.3 },
    {
      "brand_ids": ["brand_jkl012"],
      "weight": 0.8,
      "condition": {
        "query_terms": [{ "value": "candle", "full_match": false }],
        "active_ranges": [{ "start": "2026-11-20", "end": "2026-12-31" }]
      }
    }
  ],
  "pins": [
    {
      "product_id": "prod_xyz789",
      "position": 1,
      "condition": { "query_terms": [{ "value": "throw blanket", "full_match": true }] }
    }
  ],
  "diversity": { "max_per_brand": 3 },
  "query_rewrites": {
    "replacements": [{ "term": "lamp shade", "replacement": "lampshade" }],
    "two_way_synonyms": [{ "terms": ["sofa", "couch"] }],
    "do_not_associate": [{ "term": "vase", "terms": ["vinyl", "record"] }]
  }
}

Before and after

An illustration of the top five results for throw blanket, without and with the profile above. Brand A is brand_abc123, Brand B is brand_ghi789, and Store D is the buried website web_def456.

Position	Without a taste profile	With the example profile	Why it moved
1	Chunky knit throw (Store D)	Wool herringbone throw (`prod_xyz789`)	Pinned to position 1
2	Fleece throw (Brand C)	Linen throw (Brand A)	Brand A boosted
3	Sherpa throw (Store D)	Cashmere throw (Brand B)	Brand B boosted
4	Linen throw (Brand A)	Fleece throw (Brand C)	Unchanged, moved down by the boosts
5	Cotton waffle throw (Store D)	Velvet throw (Brand A)	Brand A boosted

Store D’s throws drop below the top five because its website is buried. They still appear further down: burying moves results, it doesn’t remove them.

How it applies

A taste profile adjusts ranking and recall on top of normal relevance; it doesn’t filter the catalog. To limit which products can appear, use a collection. A request can pass both.

Getting Started

Make a Search

Get Product Data

Webhooks

Conversational Agent

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ

Pass a taste profile

Brand and website boosts

Price tier preference

Conditions

Pins

Diversity

Query rewrites

Example profile

Before and after

How it applies

​Pass a taste profile

​Brand and website boosts

​Price tier preference

​Conditions

​Pins

​Diversity

​Query rewrites

​Example profile

​Before and after

​How it applies

Pass a taste profile

Brand and website boosts

Price tier preference

Conditions

Pins

Diversity

Query rewrites

Example profile

Before and after

How it applies