Получить участников группы

GET/v1/groups/{identifier}/members1₽–15₽, затем бесплатно 1 час

Возвращает до 1 000 участников на странице. Некоторые записи могут отсутствовать в ответе, поэтому pagination.page_size показывает фактическое число возвращённых элементов. Наличие следующей страницы указывает pagination.has_next_page.

Авторизация

Требуется заголовок Api-Key.

Параметры

Имя	Где	Тип	Обязателен	Описание
identifier	path	string	да	Положительный числовой ID группы либо username.
page	query	integer	нет	Номер страницы, начиная с 1. По умолчанию 1.

Примеры

cURL

curl -i -H "Api-Key: $API_KEY" \
  "https://api.telesint.dev/v1/groups/example_group/members?page=1"

Python

import os, requests

response = requests.get(
    "https://api.telesint.dev/v1/groups/example_group/members",
    params={"page": 1},
    headers={"Api-Key": os.environ["API_KEY"]},
    timeout=30,
)
response.raise_for_status()

charged = int(response.headers["Telesint-Billing-Charged"])
balance = int(response.headers["Telesint-Billing-Balance"])
result = response.json()

JavaScript

const response = await fetch(
  'https://api.telesint.dev/v1/groups/example_group/members?page=1',
  { headers: { 'Api-Key': process.env.API_KEY } },
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);

const charged = Number(response.headers.get('Telesint-Billing-Charged'));
const balance = Number(response.headers.get('Telesint-Billing-Balance'));
const result = await response.json();

Ответ — 200 OK

{
  "data": [
    {
      "data": {
        "id": 12345,
        "name": "Иван Иванов",
        "username": "ivan"
      },
      "update": "2026-07-20T12:34:56Z",
      "create": "2024-03-10T09:00:00Z",
      "admin": {
        "id": 12345,
        "role": "admin",
        "is_creator": true,
        "update": "2026-07-18T08:00:00Z"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 1,
    "has_next_page": true
  }
}

Поля участника

Поле	Тип	Описание
data.id	integer	Telegram ID пользователя.
data.name	string	Отображаемое имя.
data.username	string | null	Текущий username, если известен.
update	string (date-time) | null	Дата обновления информации об участии пользователя в группе.
create	string (date-time) | null	Дата, когда пользователь был впервые замечен в группе.
admin	object | null	Данные администратора группы: id, role, is_creator, update.

Биллинг

Стоимость доступа к выгрузке зависит от её объёма:

Доступно участников	Цена
1–10	1₽
11–49	5₽
50+	15₽

Первый успешный платный запрос открывает этому API-аккаунту все страницы той же группы на один час. В течение часа запросы и по ID, и по username возвращают Telesint-Billing-Charged: 0; повторные запросы не продлевают часовой интервал.

Успешные ответы содержат:

• Telesint-Billing-Charged — сколько рублей списано за этот запрос;
• Telesint-Billing-Balance — актуальный баланс после выполнения запроса;
• Cache-Control: private, no-store.

Ошибки

• 400 — некорректный identifier или недостаточный баланс. При нехватке баланса возвращаются billing-заголовки с нулевым списанием и текущим балансом.
• 404 — группа не найдена, страницы нет или на странице нет доступных записей.
• 422 — page меньше 1 или имеет неверный тип.
• 503 — сервис временно недоступен. Если присутствует Retry-After, повторите запрос через указанное время.