❓ FAQ: всё о парсинге Telegram

Как парсить? (общий алгоритм)

Бот работает в трёх основных режимах. Выберите нужный в нижней панели:

  • Чаты — сбор участников групповых чатов.
  • Каналы — сбор аудитории каналов (через прикреплённый чат, комментарии или права администратора).
  • Поиск — поиск публичных чатов/каналов по ключевым словам.

Инструкция для любого режима:

  1. Вставьте ссылку (или ключевые слова для поиска).
  2. Выберите тип парсинга / источник данных.
  3. Нажмите «Запустить».
  4. После завершения задания перейдите во вкладку «Мои задачи» и скачайте результат.
Что такое потоки? Почему я не могу запустить новую задачу?

Потоки — это количество задач, которые могут выполняться одновременно. Представьте супермаркет: если открыто 5 касс, одновременно могут обслуживаться 5 покупателей. Если все кассы заняты, шестой покупатель не сможет начать оплату, пока не освободится хотя бы одна касса.

В нашем боте то же самое. У вашего тарифа есть определённое число потоков (например, 5). Вы можете запустить одновременно не больше задач, чем у вас потоков. Если вы уже запустили 5 задач (все потоки заняты), то при попытке запустить шестую задача не создастся — интерфейс просто не даст этого сделать, либо покажет сообщение, что все потоки заняты. Вам нужно подождать, пока одна из выполняемых задач не завершится, и только тогда запускать следующую.

Таким образом, статус «В очереди» появляется, когда задача уже была запущена и встала в ожидание освобождения потока (если сервер сам ставит в очередь). Но чаще всего вы просто не сможете нажать «Запустить», пока не освободится поток. Количество потоков определяет вашу многозадачность: чем их больше, тем больше параллельных задач вы можете выполнять.

💡 Чтобы одновременно запускать много задач, выбирайте тариф с большим количеством потоков.
Чат и канал: ключевые отличия
ХарактеристикаКанал (Channel)Чат (Group / Supergroup)
ЦельОдносторонняя рассылка (админ пишет — подписчики читают).Общение участников между собой.
Видимость участниковСписок подписчиков скрыт всегда (видят только админы).Обычно список открыт, но может быть скрыт админом.
Где искать аудиторию— Прикреплённый чат (если есть)
— Комментаторы под постами
— Через права админа (спецрежим)
— Список участников (если не скрыт)
— Авторы сообщений
Можно ли спарсить 100% подписчиков?Нет, только тех, кто активен в чате/комментариях.Да, если список открыт. Если скрыт — только по сообщениям.

Вывод: Выбирайте тип задачи в зависимости от того, какие данные хотите получить.

У меня есть база номеров — как проверить их в Telegram?

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

📌 Как это работает: Сервис проверяет номера из вашего списка и показывает, какие аккаунты активны в Telegram, а какие — нет. Это полезно для фильтрации неактивных номеров перед началом работы.
Каналы: откуда берутся пользователи?
  • Прикреплённый чат — если у канала есть связанный чат для обсуждений.
  • Комментаторы — пользователи, оставлявшие комментарии под постами.
  • Подписчики канала (через администратора) — специальный режим, требующий прав админа.
📌 Получить список всех подписчиков канала даже с правами админа невозможно — Telegram API не даёт такой возможности.
Как спарсить чужой канал?
  1. Скопируйте ссылку на канал: https://t.me/example.
  2. В боте перейдите во вкладку «Каналы».
  3. Вставьте ссылку, выберите тип парсинга:
    • Комментаторы — собирает всех, кто комментировал посты.
    • Посты канала — выгружает все посты (текст, ссылки, реакции).
    • Все комментарии — детальная выгрузка каждого комментария.
  4. Запустите задание. Результат появится в «Мои задачи».
Обратите внимание других источников парсинга с канала конкурента нет технически в API Telegram.
Что содержат результаты по каналам?

📌 Комментаторы

  • XLSX: ID, юзернейм, дата первого комментария, количество комментариев.
  • TXT: список @username (по одному в строке).

📌 Посты канала

  • XLSX: ID поста, дата публикации, автор, текст поста, ответы на него, количество реакций, прямая ссылка на пост.
  • TXT: прямые ссылки на посты.

📌 Все комментарии

  • XLSX: ID комментатора, юзернейм, дата комментария, текст, ID поста.
  • TXT: не выдаётся.
Как спарсить подписчиков своего канала?

Для этого нужен режим «Подписчики канала (требуются права админа)».

  1. Скопируйте юзернейм бота из карточки вашего задания. Поле «ЮЗЕРНЕЙМ БОТА»
  2. Добавьте бота в администраторы вашего канала. Не в подписчики!
  3. В интерфейсе бота найдите поле «КОД АКТИВАЦИИ» и скопируйте его.
  4. Опубликуйте этот код любым постом на канале (можно сразу удалить после активации).
  5. После публикации бот увидит код и начнёт сбор подписчиков.
  6. После завершения бота можно удалить из администраторов.

Что выдаёт: XLSX — ID, юзернейм, имя, фамилия, телефон, наличие Premium. TXT — только @username.

💡 Сбор занимает около 30 минут.
Чаты: какие данные можно получить?
  • Список участников — если он открыт (по умолчанию открыт, админ может скрыть).
  • Авторы сообщений — бот анализирует историю сообщений и собирает всех, кто писал.
Как спарсить групповой чат?
  1. Скопируйте публичную ссылку: https://t.me/chatname или https://t.me/joinchat/....
  2. В боте перейдите во вкладку «Чаты».
  3. Выберите тип парсинга (см. ниже).
  4. Укажите лимит сообщений (до 25000).
  5. Запустите задание.
Что дают разные режимы парсинга чатов?

✅ Активные участники (были онлайн до 72 часов)

  • XLSX: ID, юзернейм, время последнего онлайна, статус сейчас. TXT: @username.

✅ Все участники

  • XLSX: ID, юзернейм, время, статус. TXT: @username.

✅ Полная информация об участниках

  • XLSX: ID, юзернейм, полное имя, пол, «О себе», личный канал, гео бизнеса, уровень Telegram, статус, Premium, ограничения, номер телефона, стоимость сообщения, emoji-статус, подарки, full_json. TXT: @username.

✅ История сообщений

  • XLSX: ID, юзернейм, время, статус, текст сообщения. TXT: @username.

✅ Поиск по ключевым словам

  • XLSX: ID, юзернейм, имя, фамилия, ключевое слово, текст сообщения, дата сообщения (могут быть дубли юзеров). TXT: @username (без дублей).
В чате скрыт список участников — как быть?

Если администратор включил «Скрыть список участников», стандартный сбор по списку невозможен. Бот автоматически переключается на альтернативный метод:

  • Анализирует историю сообщений и собирает всех, кто писал в чате.
  • В результате вы получите активную аудиторию (тех, кто пишет), но не «молчунов».
Как фильтровать аудиторию?

Фильтрация применяется к уже собранному списку пользователей (из файла или из выполненной задачи).

1. Источник данных:

  • Загрузить файл — текстовый файл с @username (каждый с новой строки).
  • Выбрать из задач — используйте результат любой завершённой задачи.

2. Тип фильтрации:

  • По ключу в био — оставляет только тех, у кого в описании профиля есть заданное слово (если указать "null" — выгрузит всех с заполненным био).
  • По полу — оставляет мужчин или женщин (определяется по имени в профиле).

Результат — новый файл с отфильтрованным списком.

Где скачать результат задачи?

Перейдите во вкладку «Мои задачи». У завершённых задач появятся зелёные кнопки «Скачать XLSX» и/или «Скачать TXT». Нажмите на нужный формат.

Почему задача висит в очереди?

Статус «В очереди» — нормально. Бот регулирует нагрузку на серверы Telegram, чтобы избежать блокировок. Задания выполняются по очереди, как только освобождаются ресурсы. Просто подождите.

Что означают статусы ошибок?
  • join_failed — заявка не принята
  • members_error — ошибка получения участников
  • message_history_error — ошибка истории сообщений
  • captcha_bot — в чате капча-бот
  • invalid_chat_type — неверный тип (ссылка на канал в разделе чатов)
  • comment_close — комментарии закрыты
  • access_check_failed — доступ запрещён
  • waiting_activation — ожидание активации кода (для режима админа)
  • activation_timeout — бот не был добавлен в указанный срок
  • Invite_hash_expired — пригласительная ссылка устарела

Большинство ошибок можно исправить, проверив ссылку или права доступа, и перезапустить задачу.

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

В разделе «Мои задачи» напротив каждой задачи есть кнопки:

  • Повторить — доступна для задач со статусами ошибок. Создаётся новое задание с теми же параметрами.
  • Остановить — (в интерфейсе может быть не показана, но предусмотрена API) останавливает выполнение задачи в статусе «В процессе».
Какие есть тарифы и что такое «потоки»?

Тарифы отличаются сроком действия и количеством одновременных задач (потоков).

  • Сутки (290 ₽) — до 3 потоков.
  • Месяц (990 ₽) — до 5 потоков.
  • Полгода (3290 ₽) — до 10 потоков.
  • Год (5990 ₽) — до 25 потоков.

Поток — это количество задач, которые могут выполняться параллельно. Например, при 5 потоках можно запустить 5 задач одновременно.

Оплатить можно через CryptoPay, СБП, ЮKassa, Mir Pay.

Как купить подписку?
  1. Перейдите во вкладку «Тарифы и оплата».
  2. Выберите тариф, нажмите «Купить».
  3. Выберите способ оплаты и следуйте инструкциям.
  4. После успешной оплаты подписка активируется автоматически.
Как работает реферальная программа?

Вы получаете от 5% с каждой оплаты приглашённого пользователя. Ваша реферальная ссылка доступна в Панели управления. Копируйте и делитесь ей. Для популярных каналов мы можем рассмотреть индивидуальный %

Зачем привязывать email?

Email используется для восстановления доступа, получения уведомлений о статусе задач и важных новостях сервиса. Привязать можно в разделе «Настройки».

Куда обратиться за помощью?
Тёмная
Ссылка скопирована