---
title: "Websites"
method: GET
path: "/v0/websites"
tags: ["channel3-api"]
deprecated: true
---

# Websites

`GET /v0/websites`

## Request

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

> **Deprecated.**

Resolve a website URL to its ID and best_commission_rate.

Deprecated: `GET /v1/websites/{website_id}` accepts the same domains
alongside website ids and returns the same fields, and
`GET /v1/websites/search` finds a website by retailer name.

## Query parameters

- `query` string, required
- `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

- Website
  - `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
- `404`: Website not found
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-10-28** `fbe04bdb7b70`: 1 info
  - added the optional property `anyOf[subschema #1: Website]/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`: 4 info
  - endpoint deprecated
  - added the optional property `anyOf[subschema #1: Website]/description` to the response with the `200` status
  - added the optional property `anyOf[subschema #1: Website]/logo_url` to the response with the `200` status
  - added the optional property `anyOf[subschema #1: Website]/name` to the response with the `200` status
- **2026-07-03** `1414c36b1e84`: 1 info
  - added the new optional `query` request parameter `country`

[Operation history](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/changes/v0/websites/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)
