# Фильтрация и сортировка

Фильтры передаются параметрами строки запроса. Несколько фильтров сразу действуют вместе (И).

## Каталог каналов — `GET /v1/max/channels/`

| Параметр | Что делает |
|---|---|
| `q` | Поиск: подстрока названия или имени (от 3 символов), ссылка `max.ru/…` или `@имя` — точное совпадение |
| `category` | Код рубрики (основной или дополнительной) из справочника рубрик |
| `territory` | Код территории из справочника — вместе с дочерними узлами (Москва найдётся и по коду ЦФО) |
| `kind` | `channel` — каналы (по умолчанию), `chat` — групповые чаты |
| `subscribers_min`, `subscribers_max` | Подписчиков не меньше / не больше |
| `a_plus` | `true` — только с меткой A+, `false` — без неё |
| `verified` | `true` — только подтверждённые владельцем, `false` — неподтверждённые |
| `ids` | До 100 номеров через запятую — карточки в порядке запроса; остальные фильтры и страницы тогда не применяются |

## Сортировка каталога — `ordering`

Всегда по убыванию:

| Значение | Порядок |
|---|---|
| `-subscribers` | Больше подписчиков — выше (по умолчанию) |
| `-quality` | Выше индекс качества |
| `-citation` | Выше индекс цитируемости |
| `-last_post_at` | Свежее последний пост |

Каналы без значения (например, без индекса качества) идут в конце.

## Посты канала — `GET /v1/max/channels/{channel}/posts/`

| Параметр | Что делает |
|---|---|
| `from`, `to` | Период публикации: дни в виде `ГГГГ-ММ-ДД` по московскому времени, оба включительно |
| `is_ad` | `true` — только рекламные посты, `false` — без рекламы |

## Статистика по дням — `GET /v1/max/stats/daily/`

| Параметр | Что делает |
|---|---|
| `channels` | Обязательно: до 100 номеров каналов через запятую |
| `from`, `to` | Период включительно, по умолчанию — последние 30 дней; не длиннее 366 дней, каналов × дней — не больше 10 000 |

## Справочник территорий — `GET /v1/max/territories/`

| Параметр | Что делает |
|---|---|
| `parent` | Код узла — только его прямые потомки |
| `kind` | Только узлы уровня: `country`, `district`, `region`, `city` |

## Значения параметров

- Да / нет: `true` или `false` (также `1` / `0`, `yes` / `no`).
- Неверное значение, неизвестный код рубрики или территории — ответ 400 с ошибкой у имени параметра.