Каналы

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

💳 Стоимость: 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

Query parameters

searchstring nullable

Полнотекстовый поисковый запрос по названию, описанию или ссылке на канал.

Example:новости технологий
limitinteger

Количество каналов в ответе. Допустимый диапазон: от 1 до 100.

Example:10
offsetinteger

Смещение относительно начала выборки для постраничной навигации. Сумма offset + limit не может превышать 10000: глубже поиск не отдаётся.

category_idinteger nullable

Фильтр по идентификатору категории канала.

Example:12
access'public' | 'private' nullable

Фильтр по типу канала: public — открытый канал, private — канал по приглашению. Если не задано, в выдачу попадают каналы обоих типов.

Example:public
subscribers_mininteger

Минимальное количество подписчиков канала.

Example:10000
subscribers_maxinteger

Максимальное количество подписчиков канала. Значение 0 отключает верхнюю границу.

Example:500000
posts_mininteger

Минимальное количество публикаций в канале.

Example:100
posts_maxinteger

Максимальное количество публикаций в канале. Значение 0 отключает верхнюю границу.

Example:10000
order_by'subscribers' | 'posts' | 'date' | 'score'

Поле сортировки: subscribers для количества подписчиков, posts для количества публикаций, date для даты обновления канала, score для релевантности.

Example:subscribers
order'asc' | 'desc'

Направление сортировки.

Example:desc

Response

Successful Response

totalinteger required

Общее количество каналов, найденных по заданным фильтрам.

limitinteger required

Примененный размер страницы.

offsetinteger required

Примененное смещение.

Example response

{
  "total": 248,
  "channels": [
    {
      "id": "-91827364546372",
      "name": "MAX Новости",
      "description": "Официальный канал с новостями продукта и обновлениями сервиса.",
      "avatar": "https://cdn.example.com/channels/918273645/avatar.jpg",
      "url": "https://max.ru/max_news",
      "access": "public",
      "subscribers": 154200,
      "posts": 4832,
      "categories": [
        "Новости",
        "Технологии"
      ],
      "rkn_status": "listed",
      "created_at": "2026-03-20T14:30:00+07:00",
      "updated_at": "2026-03-21T09:15:00+07:00",
      "score": 14.72
    }
  ],
  "limit": 10
}

Changes

No recorded changes to this operation across all 1 revision of this API.