Skip to main content
Set country, language, and currency on search and product-detail requests to return offers priced and available for a specific market. Channel3 supports locales across Europe, the UK, Canada, Australia, and more.

​
Per-request locale

Pass locale fields on each search call: 
const results = await client.products.search({
  query: "trainers",
  country: "GB",
  language: "en",
  currency: "GBP",
});

​
Default locale on the client

Set a default once on the client and it applies to every search and product-detail call. Per-request values override the client default. 
import Channel3 from "@channel3/sdk";

const client = new Channel3({
  country: "GB",
  currency: "GBP",
});

// Uses GB / GBP
await client.products.search({ query: "raincoat" });

// Override per-call
await client.products.search({
  query: "raincoat",
  config: { country: "DE", currency: "EUR" },
});
You can also set defaults via environment variables: CHANNEL3_LANGUAGE, CHANNEL3_COUNTRY, CHANNEL3_CURRENCY.
When only country is set, the server infers currency (e.g. GB → GBP) and language (e.g. GB → en). When all three are unset, defaults to en / US / USD.

​
Supported markets

Channel3 is expanding international coverage based on developer demand. Pass any of the values below as country, currency, or language on search and product-detail requests.

​
Countries

CodeMarket
USUnited States
CACanada
GBUnited Kingdom
IEIreland
AUAustralia
DEGermany
ATAustria
FRFrance
BEBelgium
ITItaly
ESSpain
NLNetherlands
SESweden
FIFinland
PTPortugal
CZCzech Republic
GRGreece
RORomania
EUEurope (pan-region; use with currency: EUR when you don’t need a single country)

​
Currencies

USD, CAD, AUD, GBP, EUR, SEK, CZK, RON When you set country only, the API infers currency (for example GB → GBP). When all three locale fields are unset, defaults are en / US / USD.

​
Languages

en, de, fr, it, es, nl, sv, fi, pt, cs, el, ro
Coverage outside the U.S. is still growing. If you need a geography we don’t support yet, contact us or ask in Discord.