Фильтрация и сортировка
Фильтры передаются параметрами строки запроса. Несколько фильтров сразу действуют вместе (И).
Каталог каналов — 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 с ошибкой у имени параметра.
