---
title: "Search Websites"
method: GET
path: "/v1/websites/search"
tags: ["v1"]
---

# Search Websites

`GET /v1/websites/search`

## Request

- Base URL: `https://api.trychannel3.com`
- URL: `https://api.trychannel3.com/v1/websites/search`
- Auth: API key in header `x-api-key`

Search websites by retailer name or domain, optionally within categories.

Category filtering matches within each category's top 1,000 websites.

## Query parameters

- `query` string, required: Free-text query (e.g. 'Nordstrom', 'nike.com').
- `limit` integer: Maximum number of websites to return.
- `category_ids` string[], nullable: If provided, only websites selling in these categories will be matched. Accepts category slugs. Categories that do not exist, or that are not available for search, are rejected with a 422.
- `country` 'US' | 'GB' | 'EU' | 'AU' | 'CA' | 'IE' | 'DE' | 'AT' | 'FR' | 'BE' | 'IT' | 'ES' | 'NL' | 'SE' | 'FI' | 'PT' | 'CZ' | 'GR' | 'RO' | 'CH' | 'PL': ISO 3166-1 alpha-2 country code (plus the pan-region ``EU``).

## Response `200`

Successful Response

- SearchWebsitesResponse
  - `websites` Website[], required: Websites matching the query, ordered by relevance.
    - `id` string, required
    - `name` string, nullable
    - `url` string, required
    - `logo_url` string, nullable
    - `description` string, nullable
    - `best_commission_rate` number: The maximum commission rate for the website in the requested country (default 'US'), as a percentage
    - `countries` CountryCode[]: Countries where this website has offers indexed in the catalog. Pass one in the X-Channel3-Country header to get this website's products there. Empty when the website has no products indexed yet.

## Other responses

- `401`: Unauthorized - Invalid or missing authentication
- `402`: Payment required
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-10-28** `fbe04bdb7b70`: 1 info
  - added the optional property `websites/items/countries` to the response with the `200` status
- **2026-10-20** `f642382eaf91`: 1 info
  - added the enum value `PL` to the property `anyOf[subschema #1: CountryCode]/` of the `query` request parameter `country`
- **2026-10-19** `7d1e0ccffc95`: 1 info
  - added the enum value `CH` to the property `anyOf[subschema #1: CountryCode]/` of the `query` request parameter `country`
- **2026-10-16** `93329818bdf4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/changes/v1/websites/search/get.md)

---

[API](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api.md) - [All operations](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/llms.txt) - [OpenAPI document](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/revisions/f9f7b422ab5d?raw)