> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trychannel3.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Localization

> Set country, language, and currency to localize search results and product detail for your target market.

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:

<CodeGroup>
  ```typescript TypeScript theme={null}
  const results = await client.products.search({
    query: "trainers",
    country: "GB",
    language: "en",
    currency: "GBP",
  });
  ```

  ```python Python theme={null}
  results = client.products.search(
      query="trainers",
      country="GB",
      language="en",
      currency="GBP",
  )
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.trychannel3.com/v1/search \
    -H "x-api-key: $CHANNEL3_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "query": "trainers",
      "country": "GB",
      "language": "en",
      "currency": "GBP"
    }'
  ```
</CodeGroup>

## 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.

<CodeGroup>
  ```typescript TypeScript theme={null}
  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" },
  });
  ```

  ```python Python theme={null}
  from channel3_sdk import Channel3

  client = Channel3(country="GB", currency="GBP")

  client.products.search(query="raincoat")

  client.products.search(
      query="raincoat",
      config={"country": "DE", "currency": "EUR"},
  )
  ```
</CodeGroup>

You can also set defaults via environment variables: `CHANNEL3_LANGUAGE`, `CHANNEL3_COUNTRY`, `CHANNEL3_CURRENCY`.

<Note>
  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`.
</Note>

## 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

| Code | Market                                                                             |
| ---- | ---------------------------------------------------------------------------------- |
| `US` | United States                                                                      |
| `CA` | Canada                                                                             |
| `GB` | United Kingdom                                                                     |
| `IE` | Ireland                                                                            |
| `AU` | Australia                                                                          |
| `DE` | Germany                                                                            |
| `AT` | Austria                                                                            |
| `FR` | France                                                                             |
| `BE` | Belgium                                                                            |
| `IT` | Italy                                                                              |
| `ES` | Spain                                                                              |
| `NL` | Netherlands                                                                        |
| `SE` | Sweden                                                                             |
| `FI` | Finland                                                                            |
| `PT` | Portugal                                                                           |
| `CZ` | Czech Republic                                                                     |
| `GR` | Greece                                                                             |
| `RO` | Romania                                                                            |
| `EU` | Europe (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`

<Note>
  Coverage outside the U.S. is still growing. If you need a geography we don't support yet, [contact us](mailto:support@trychannel3.com) or ask in [Discord](https://discord.gg/6J6MjctXrH).
</Note>

<Cards>
  <Card title="Search" icon="magnifying-glass" href="/guides/search" arrow="true">
    Full overview of the search endpoint, filters, and pagination.
  </Card>

  <Card title="Caching" icon="database" href="/guides/caching" arrow="true">
    Cache product IDs safely while refreshing prices and availability at display time.
  </Card>
</Cards>