Парсинг через API Telecobra: создать задачу и получить результат

Авторизация и подготовка

API принимает заголовок X-API-Key или Authorization: Bearer …. Используйте свой ключ Telecobra и собственный подключённый аккаунт. Нужен действующий доступ платформы. Bot API token и Telegram API Hash не заменяют ключ Telecobra.

Сначала определите доступный источник, нужный режим и ожидаемые поля. В примерах используются условные идентификаторы. Отправка POST с вашими данными создаёт задачу; перед запуском сверьте аккаунт и источник.

Создание задачи парсинга

POST https://telecobra.com/api/parsing
X-API-Key: YOUR_TELECOBRA_KEY
Content-Type: application/json

{
  "source_link": "https://t.me/YOUR_OWN_GROUP",
  "account_id": 123,
  "max_count": 10,
  "parse_mode": "members",
  "username_only": false,
  "exclude_bots": true
}

Замените 123 своим внутренним ID аккаунта Telecobra, а источник — сообществом, к которому у него есть доступ. Условный предел 10 выбран для небольшого примера и не является безопасной квотой Telegram.

При принятии запроса ответ имеет HTTP 201 и содержит id и status, например {"id": 456, "status": "pending"}. Это условный ответ. Создание ещё не означает завершение сбора.

Получение статуса задачи через API

GET https://telecobra.com/api/parsing/456/status
X-API-Key: YOUR_TELECOBRA_KEY

Сохраните полученный id и используйте его для последующих запросов. Ответ включает status, parsed_count, error_msg и журнал. При наличии структурированной диагностики учитывайте её вместе с текстом ошибки.

Не отправляйте новый POST только потому, что задача ещё выполняется. При потере ответа после создания сначала проверьте список GET /api/parsing и свои сохранённые данные, чтобы не создать дубль. Автоматический повтор POST без такого разбора не нужен.

Получение строк результата

GET https://telecobra.com/api/parsing/456/results?limit=100&offset=0
X-API-Key: YOUR_TELECOBRA_KEY

Результат доступен после статуса done. В ответе есть members, total_count, returned_count и next_offset. Передавайте next_offset в следующий запрос, пока он не станет null. Параметр limit допускает 1–10000; offset — неотрицательное целое.

Записи относятся к указанной задаче. Поле audience_id может быть null: получение результата не создаёт аудиторию автоматически. Для CSV/Excel используйте выгрузку задачи в интерфейсе.

Разбор отказов и интеграция

Для визуальных конструкторов используйте проверку статуса из n8n и Make. Журналы внешней системы должны хранить ID задачи и результат без действующего API-ключа.

Источники и документация

• Описание API Telecobra

Продолжить по теме

• Как подготовить интеграцию Telecobra через API →
• Парсер Telegramдля работы с аудиторией →