---
title: "Статистика подписчиков канала · 5 кредитов"
method: GET
path: "/v1/channels/{channel_id}/subscribers"
tags: ["Каналы"]
---

# Статистика подписчиков канала · 5 кредитов

`GET /v1/channels/{channel_id}/subscribers`

## Request

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

> 💳 **Стоимость:** 5 кредитов

Возвращает минимальное и максимальное количество подписчиков, абсолютный и относительный прирост, а также дневную историю подписчиков за выбранный диапазон дат. Если `date_from` и `date_to` не переданы, используется последние 30 дней.

## Path parameters

- `channel_id` string, required: Числовой идентификатор канала, передаётся строкой.

## Query parameters

- `date_from` string, date, nullable: Нижняя граница диапазона дат включительно в формате `YYYY-MM-DD`.
- `date_to` string, date, nullable: Верхняя граница диапазона дат включительно в формате `YYYY-MM-DD`.

## Response `200`

Successful Response

- ChannelSubscribersResponse
  - `subscribers_min` integer, required: Минимальное количество подписчиков за выбранный период.
  - `subscribers_max` integer, required: Максимальное количество подписчиков за выбранный период.
  - `subscribers_growth_count` integer, required: Абсолютный прирост подписчиков за выбранный период.
  - `subscribers_growth_percent` number, required: Относительный прирост подписчиков за выбранный период в процентах.
  - `subscribers_history` SrcChannelsPublicV1SchemasHistoryItem[], required: История количества подписчиков по дням за выбранный период.
    - `date` string, date, required: Дата, к которой относится значение метрики.
    - `total` integer, required: Значение метрики на указанную дату.

## Other responses

- `401`: Ошибка аутентификации: API-токен не передан, недействителен или отозван.
- `402`: Проблема с тарифом: нет активного периода подписки или недостаточно кредитов.
- `403`: Доступ запрещён.
- `404`: Запрошенный ресурс не найден.
- `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)