Configure Search Behavior

Pass a config object to set search mode and locale. mode: "keyword" skips semantic ranking and uses lexical matching only — lowest latency, best for exact product names or SKUs.

Mode	Behavior
`default`	Lexical + semantic. Recommended for most searches.
`keyword`	Lexical only. Use for real-time, low-latency needs.
`agentic`	LLM-planned sub-searches for complex queries. See Agentic search.

import Channel3 from "@channel3/sdk";

const client = new Channel3();

async function main() {
  const response = await client.products.search({
    query: "linen shirt",
    config: {
      mode: "keyword",
    },
  });
  console.log(response.products[0]?.title);
}

main();

from channel3_sdk import Channel3

client = Channel3()

def main():
    response = client.products.search(
        query="linen shirt",
        config={"mode": "keyword"},
    )
    print(response.products[0].title)

if __name__ == "__main__":
    main()

Locale overrides (country, currency, language) also go on config (or on the client default). See Localization and Locale. keyword_search_only is ignored. Use mode: "keyword" instead.

Getting Started

Make a Search

Get Product Data

Conversational Agent

Checkout

Pricing, Reporting, and Commissions

Build

Integrate

FAQ

Configure Search Behavior