---
title: "Поиск по каналам · 3 кредита"
method: GET
path: "/v1/channels"
tags: ["Каналы"]
---

# Поиск по каналам · 3 кредита

`GET /v1/channels`

## Request

- Base URL: `https://maxstat.ru/api`
- URL: `https://maxstat.ru/api/v1/channels`
- Auth: API key in header `X-API-Token`

> 💳 **Стоимость:** 3 кредита

Возвращает пагинированный список каналов из публичного индекса. Поддерживается полнотекстовый поиск по названию, описанию и ссылке канала, фильтрация по категории, диапазонам подписчиков и количества публикаций, а также сортировка по релевантности, дате, числу подписчиков или публикаций.

## Query parameters

- `search` string, nullable: Полнотекстовый поисковый запрос по названию, описанию или ссылке на канал.
- `limit` integer: Количество каналов в ответе. Допустимый диапазон: от 1 до 100.
- `offset` integer: Смещение относительно начала выборки для постраничной навигации. Сумма `offset + limit` не может превышать 10000: глубже поиск не отдаётся.
- `category_id` integer, nullable: Фильтр по идентификатору категории канала.
- `access` 'public' | 'private', nullable: Фильтр по типу канала: `public` — открытый канал, `private` — канал по приглашению. Если не задано, в выдачу попадают каналы обоих типов.
- `subscribers_min` integer: Минимальное количество подписчиков канала.
- `subscribers_max` integer: Максимальное количество подписчиков канала. Значение `0` отключает верхнюю границу.
- `posts_min` integer: Минимальное количество публикаций в канале.
- `posts_max` integer: Максимальное количество публикаций в канале. Значение `0` отключает верхнюю границу.
- `order_by` 'subscribers' | 'posts' | 'date' | 'score': Поле сортировки: `subscribers` для количества подписчиков, `posts` для количества публикаций, `date` для даты обновления канала, `score` для релевантности.
- `order` 'asc' | 'desc': Направление сортировки.

## Response `200`

Successful Response

- ChannelsResponse
  - `total` integer, required: Общее количество каналов, найденных по заданным фильтрам.
  - `channels` ChannelSearchResult[], required: Список каналов в текущей странице выдачи.
    - `id` string, required: Внутренний идентификатор канала.
    - `name` string, required: Название канала.
    - `description` string, required: Текстовое описание канала.
    - `avatar` string, required: Прямая ссылка на аватар канала.
    - `url` string, required: Публичная ссылка на канал.
    - `access` 'public' | 'private', required: Тип канала: `public` — открытый канал, `private` — канал по приглашению.
    - `subscribers` integer, required: Текущее количество подписчиков канала.
    - `posts` integer, required: Текущее количество публикаций в канале.
    - `categories` string[]: Список категорий, к которым отнесен канал.
    - `rkn_status` string, nullable: Статус регистрации канала в реестре РКН.
    - `created_at` string, date-time, required: Дата и время создания канала.
    - `updated_at` string, date-time, required: Дата и время последнего обновления данных о канале.
    - `score` number, nullable: Оценка релевантности. Заполняется при сортировке по `score`.
  - `limit` integer, required: Примененный размер страницы.
  - `offset` integer, required: Примененное смещение.

## Other responses

- `401`: Ошибка аутентификации: API-токен не передан, недействителен или отозван.
- `402`: Проблема с тарифом: нет активного периода подписки или недостаточно кредитов.
- `403`: Доступ запрещён.
- `422`: Ошибка валидации параметров запроса. Подробности — в поле details.
- `429`: Превышен лимит запросов. Повторите запрос позже.
- `500`: Внутренняя ошибка сервиса. Сообщите request_id в поддержку.
- `503`: Сервис временно перегружен. Повторите запрос через несколько секунд (см. заголовок Retry-After).

---

[API](https://skmtc.dev/maxstat/apis/maxstat-public-api.md) · [All operations](https://skmtc.dev/maxstat/apis/maxstat-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maxstat/apis/maxstat-public-api/revisions/4eff97f9a0b2?raw)