API для работы с Telegram-данными

Те же инструменты, что в кабинете Акулы Маркетинга, — по HTTP: парсинг чатов и каналов, данные юзернеймов и похожие каналы.

Как получить API-ключ

Ключи выдаём вручную, чтобы настроить лимиты под вашу задачу. Зарегистрируйтесь на akula.marketing через Telegram. Напишите в поддержку @KoteamSupport: какие методы нужны и примерный объём запросов. Получите ключ. Он передаётся в каждом запросе параметром key.

Авторизация

Добавьте параметр key=ВАШ_КЛЮЧ к каждому запросу. Без ключа или с неактивным ключом API вернёт 401. Ответы — JSON. Не публикуйте ключ в клиентском коде.

Информация о юзернеймах

Проверяет до 100 юзернеймов за запрос: существует ли, пользователь это или канал/чат, название, описание, аватар, число участников. С include_resolve=true добавляет Telegram ID, имя, премиум, статус онлайна.

Фото профиля

Возвращает фотографии профиля пользователя, канала или чата по юзернейму.

Похожие каналы

Список каналов, которые Telegram рекомендует как похожие на заданный. Подходит для поиска площадок под рекламу и расширения базы чатов.

Парсинг чата или канала

Создаёт задачу парсинга: участники чата (type=gp) или авторы сообщений (type=gm). Задача выполняется асинхронно; результат придёт на webhook, статус и ссылки на выгрузку можно получить по ID задачи.

Пакетный парсинг

Запускает парсинг авторов сообщений сразу по списку чатов одной задачей. Результат приходит на webhook из профиля.

Нужен результат без кода?

Часть методов опубликована как готовые акторы на Apify: запуск из браузера, расписание, интеграции с Make и Zapier.

Сколько стоит API?

Стоимость зависит от методов и объёма запросов. Напишите в поддержку @KoteamSupport — подберём тариф под задачу.

Почему ключ выдаёт поддержка, а не кабинет?

Мы настраиваем лимиты и webhook под каждого клиента. Так быстрее запустить интеграцию без ошибок.

Как получить результат парсинга?

Укажите webhookUrl при создании задачи — результат придёт туда. Или запрашивайте статус по ID задачи: в ответе будут ссылки на выгрузку.

Чем API отличается от акторов на Apify?

API — прямой доступ для своих систем и скриптов. Акторы на Apify — готовые запуски без кода с оплатой через Apify.

Парсер Telegram · Мониторинг чатов · Похожие каналы · Лидогенерация · Telegram outreach · Нейрорассылка · Генератор постов для Telegram