Документация

Все, что вам нужно для интеграции TG Parser V2 в ваши приложения.

Быстрый старт

Начните парсинг вашего первого канала за считанные секунды. Вам понадобится API-ключ из дашборда.

curl -X POST https://api.tgparser.cc/parse \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel": "durov", "limit": 5, "details": true}'

Примечание: установите "details": true, чтобы получить разбивку по просмотрам и реакциям (по умолчанию false).

API справочник

POST/parse

Извлечение сообщений из публичного Telegram-канала.

Параметры

Имя	Тип	Описание
channel	string	Имя пользователя канала (например, "@durov") или ссылка t.me.
limit	integer	Количество извлекаемых сообщений. Жёстко ограничено 100 на сервере вне зависимости от переданного значения. По умолчанию 100, если часы и лимит опущены.
hours	integer	Получить сообщения за последние X часов.
details	boolean	Включить расширенные метрики, такие как просмотры и реакции. По умолчанию: false.

Пример ответа

{
  "status": "success",
  "count": 1,
  "messages": [
    {
      "id": 474,
      "date": "2026-03-01T21:05:45+00:00",
      "text": "🎆 Unfortunately, I had to leave Dubai...",
      "link": "https://t.me/@durov/474",
      "channel": "@durov",
      "channel_title": "Pavel Durov",
      "has_media": true,
      "media_type": "photo",
      "views": 800738,
      "reactions": 58375,
      "reactions_details": [
        {
          "emoji": "👍",
          "count": 8261
        },
        {
          "emoji": "custom_5265077361648368841",
          "count": 28241
        }
      ]
    }
  ]
}

GET/media/{channel}/{message_id}

Скачивает фото, видео или документ, прикреплённые к сообщению, возвращённому /parse. Сначала проверьте has_media / media_type у сообщения.

Параметры

Имя	Тип	Описание
channel	string	Имя пользователя канала, то же значение, что и поле channel из /parse.
message_id	integer	id сообщения из /parse.

curl -X GET https://api.tgparser.cc/media/durov/1235 \
-H "x-api-key: YOUR_API_KEY" \
--output photo.jpg

Скачивание медиа не расходует месячную квоту запросов. Файлы больше 10 МБ отклоняются.

Ошибки

Статус	Значение
422	Отсутствует или некорректен заголовок X-API-Key (или тело запроса для /parse).
403	Невалидный или отключённый API-ключ.
404	Канал, сообщение или медиа не найдены.
413	Медиафайл превышает лимит в 10 МБ (только для /media).
429	Превышен месячный лимит запросов, либо сработал rate limit Telegram (flood wait).
500	Ошибка сервиса авторизации (Directus) или общая ошибка обработки.
503	Сервис авторизации (Directus) недоступен.

Примеры кода

import requests

url = "https://api.tgparser.cc/parse"
headers = {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "channel": "@durov",
    "hours": 24,
    "limit": 10,
    "details": true
}

response = requests.post(url, json=data, headers=headers)
print(response.json())