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

# Website

Find products sold on specific websites.

> [!NOTE]
>
> A **[brand](/guides/brand.md)** is the company or label behind a product. A **[website](/guides/website.md)** is the online store selling it.

**1. Find the ID, or bring a domain**

Search for a retailer to get its stable ID. [Website search](/api-reference/v1/search-websites.md) is free.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
import { Channel3 } from "@channel3/sdk";

const client = new Channel3();

const { websites } = await client.websites.search({ query: "Best Buy" });
const bestBuyId = websites[0].id;
console.log(bestBuyId); // e.g. "p1PB"
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
from channel3_sdk import Channel3

client = Channel3()

websites = client.websites.search(query="Best Buy").websites
best_buy_id = websites[0].id
print(best_buy_id)  # e.g. "p1PB"
```

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.trychannel3.com/v1/websites/search?query=Best%20Buy" \
  -H "x-api-key: $CHANNEL3_API_KEY"
```

If you already know the domain, like `bestbuy.com`, you can skip this step and pass the domain directly in search.

**2. Add it to search**

Pass IDs or domains to `filters.website_ids`. You can use the ID from step 1, or pass a domain like `"nike.com"` and the API will resolve it.

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
const results = await client.products.search({
  query: "running shoes",
  filters: {
    website_ids: [
        "nike.com", // Resolved automatically
        "website_id" // Matches a direct ID
    ],
  },
});
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
results = client.products.search(
    query="running shoes",
    filters={"website_ids": [
        "nike.com", # Resolved automatically
        "website_id" # Matches a direct ID
    ]}
)
```

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST https://api.trychannel3.com/v1/search \
  -H "x-api-key: $CHANNEL3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "running shoes",
    "filters": { "website_ids": ["nike.com"] }
  }'
```

> **[Search](/guides/search.md)**
>
> Full overview of the search endpoint and all available filters.

> **[Websites API](/api-reference/channel3-api/websites.md)**
>
> Full API reference for the websites endpoint.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.