Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Telegram: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Публикации каналаchannel_posts | Получите сообщения из публичного канала Telegram. | $0.56 за 1 000 запросов | Норма |
Профилиprofile | Получите статистику публичного канала Telegram: число подписчиков, фото, видео и ссылок, описание, аватар и статус верификации. | $0.56 за 1 000 запросов | Норма |
Поискsearch | Ищите сообщения в публичных каналах Telegram по ключевому слову. | $0.56 за 1 000 запросов | Норма |
Группаgroup | Получите карточку группы или канала Telegram: название, описание, число участников и пользователей онлайн, дату создания и флаги scam, fake или верификации. | $0.56 за 1 000 запросов | Норма |
Участникиmembers | Получите список видимых участников публичной группы Telegram: имя пользователя, имя, тип аккаунта, флаги Premium, scam и fake и время последнего посещения. | $0.56 за 1 000 запросов | Норма |
Сведения о постеpost_detail | Получите одно сообщение из публичного канала Telegram по ссылке, например https://t.me/durov/520: текст, просмотры, время публикации, тип медиа и ссылку на него, подпись автора, источник пересылки, ссылку на ответ, превью ссылки и реакции с количеством. | $0.81 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Telegram?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
channel_postsПубликации канала Получите сообщения из публичного канала Telegram. У каждого поста есть текст, просмотры, медиа, реакции и источник пересылки. Закрытые ссылки-приглашения не поддерживаются. Пакет может не охватывать всю историю канала. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · channel_username · channel_title · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions |
profileПрофили Получите статистику публичного канала Telegram: число подписчиков, фото, видео и ссылок, описание, аватар и статус верификации. Принимается имя, @имя, t.me/name или t.me/s/name. Закрытые чаты, номера телефонов и имена участников недоступны. | username | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform |
searchПоиск Ищите сообщения в публичных каналах Telegram по ключевому слову. У каждого результата есть название канала, тип, число подписчиков, просмотры, реакции и медиа. Сужайте период через | keyword | since, until | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform |
groupГруппа Получите карточку группы или канала Telegram: название, описание, число участников и пользователей онлайн, дату создания и флаги scam, fake или верификации. Закрытые ссылки-приглашения не поддерживаются, а вызов никогда не вступает в группу и не открывает контент с ограниченным доступом. | username | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · type · username · url · title · name · description · member_count · online_count · created_at · is_verified · is_scam · is_fake · is_forum · is_restricted · admin_bots · platform |
membersУчастники Получите список видимых участников публичной группы Telegram: имя пользователя, имя, тип аккаунта, флаги Premium, scam и fake и время последнего посещения. Список может быть неполным, а номер телефона указывается, только если участник сделал его публичным. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=100, maxLimit=5000. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · phone · platform |
post_detailСведения о посте Получите одно сообщение из публичного канала Telegram по ссылке, например https://t.me/durov/520: текст, просмотры, время публикации, тип медиа и ссылку на него, подпись автора, источник пересылки, ссылку на ответ, превью ссылки и реакции с количеством. | url | — | Режим выдачи: Sync | — | $0.81 за 1 000 запросов | id · url · channel_username · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions |
Что означают параметры действия channel_posts в API Telegram?
Получите сообщения из публичного канала Telegram. У каждого поста есть текст, просмотры, медиа, реакции и источник пересылки. Закрытые ссылки-приглашения не поддерживаются. Пакет может не охватывать всю историю канала.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичный канал или группа в формате name, @name, t.me/name или t.me/s/name. Используется в channel_posts и profile для публичных каналов, в group для метаданных публичной сущности и в members для получения видимых участников группы. Приватные ссылки-приглашения не поддерживаются, полный список участников не гарантируется.Официальные материалы Telegram: каналы, публичные имена пользователей и счётчики просмотров — Официальная документация Telegram разделяет публичные каналы и приватные каналы с доступом только по приглашению. В ней отмечается, что каналы предназначены для односторонней рассылки сообщений, а счётчики просмотров учитывают пересланные копии и показывают приблизительные значения. Это объясняет объект канала и параметр view_count, но не доказывает, что этот эндпоинт может читать полную историю канала или приватный контент. · ПровереноОфициальные материалы Telegram: доступ к контенту по-прежнему регулируется условиями лицензии — Ограниченные официальные исключения для сторонних клиентов, ботов и Mini Apps распространяются только на данные, строго необходимые для работы, и по-прежнему подчиняются условиям использования, авторскому праву и правилам конфиденциальности. Само наличие эндпоинта API не даёт права на парсинг, перепродажу или произвольное повторное использование данных платформы. · Проверено
Что означают параметры действия profile в API Telegram?
Получите статистику публичного канала Telegram: число подписчиков, фото, видео и ссылок, описание, аватар и статус верификации. Принимается имя, @имя, t.me/name или t.me/s/name. Закрытые чаты, номера телефонов и имена участников недоступны.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичный канал или группа в формате name, @name, t.me/name или t.me/s/name. Используется в channel_posts и profile для публичных каналов, в group для метаданных публичной сущности и в members для получения видимых участников группы. Приватные ссылки-приглашения не поддерживаются, полный список участников не гарантируется.Официальные материалы Telegram: каналы, публичные имена пользователей и счётчики просмотров — Официальная документация Telegram разделяет публичные каналы и приватные каналы с доступом только по приглашению. В ней отмечается, что каналы предназначены для односторонней рассылки сообщений, а счётчики просмотров учитывают пересланные копии и показывают приблизительные значения. Это объясняет объект канала и параметр view_count, но не доказывает, что этот эндпоинт может читать полную историю канала или приватный контент. · Проверено
Что означают параметры действия search в API Telegram?
Ищите сообщения в публичных каналах Telegram по ключевому слову. У каждого результата есть название канала, тип, число подписчиков, просмотры, реакции и медиа. Сужайте период через since и until. Закрытые чаты не ищутся, а результаты не отражают весь Telegram.
keywordОбязательный- Поисковый запрос по сообщениям в публичных каналах для действия search. Списки контактов и приватные чаты не просматриваются.Официальные материалы Telegram: лицензирование контента и ограничения на использование для ИИ — Официальные условия Telegram ограничивают доступ к контенту за пределами обычного предусмотренного использования платформы и запрещают парсинг или агрегацию данных платформы для обучения, валидации, улучшения, бенчмаркинга и развёртывания моделей ИИ. Исключения требуют явного и постоянного согласия соответствующих пользователей для каждой единицы контента и каждого контекста, поскольку публичная доступность не даёт общей лицензии на использование. · Проверено
sinceНеобязательный- Нижняя граница даты сообщений для действия search. Не фильтрует по дате создания группы; в channel_posts фильтра по дате нет.
untilНеобязательный- Верхняя граница даты сообщений (beforeDate) для действия search. Используется вместе с since, чтобы сузить выборку публичных сообщений; полный охват сообщений в заданном диапазоне не гарантируется.
Что означают параметры действия group в API Telegram?
Получите карточку группы или канала Telegram: название, описание, число участников и пользователей онлайн, дату создания и флаги scam, fake или верификации. Закрытые ссылки-приглашения не поддерживаются, а вызов никогда не вступает в группу и не открывает контент с ограниченным доступом.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичный канал или группа в формате name, @name, t.me/name или t.me/s/name. Используется в channel_posts и profile для публичных каналов, в group для метаданных публичной сущности и в members для получения видимых участников группы. Приватные ссылки-приглашения не поддерживаются, полный список участников не гарантируется.Официальные материалы Telegram: группы, имена пользователей и настройки приватности «Последняя активность» — Официальная документация Telegram описывает публичные имена пользователей и ссылки t.me и отмечает, что время последней активности можно скрыть или показывать только приблизительно. Поэтому по полям last_seen_at участников нельзя восстановить точную историю активности, а публичное имя пользователя не означает доступа к публичному номеру телефона. · Проверено
Что означают параметры действия members в API Telegram?
Получите список видимых участников публичной группы Telegram: имя пользователя, имя, тип аккаунта, флаги Premium, scam и fake и время последнего посещения. Список может быть неполным, а номер телефона указывается, только если участник сделал его публичным.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Публичный канал или группа в формате name, @name, t.me/name или t.me/s/name. Используется в channel_posts и profile для публичных каналов, в group для метаданных публичной сущности и в members для получения видимых участников группы. Приватные ссылки-приглашения не поддерживаются, полный список участников не гарантируется.Официальные материалы Telegram: группы, имена пользователей и настройки приватности «Последняя активность» — Официальная документация Telegram описывает публичные имена пользователей и ссылки t.me и отмечает, что время последней активности можно скрыть или показывать только приблизительно. Поэтому по полям last_seen_at участников нельзя восстановить точную историю активности, а публичное имя пользователя не означает доступа к публичному номеру телефона. · ПровереноОфициальные материалы Telegram: доступ к контенту по-прежнему регулируется условиями лицензии — Ограниченные официальные исключения для сторонних клиентов, ботов и Mini Apps распространяются только на данные, строго необходимые для работы, и по-прежнему подчиняются условиям использования, авторскому праву и правилам конфиденциальности. Само наличие эндпоинта API не даёт права на парсинг, перепродажу или произвольное повторное использование данных платформы. · Проверено
Что означают параметры действия post_detail в API Telegram?
Получите одно сообщение из публичного канала Telegram по ссылке, например https://t.me/durov/520: текст, просмотры, время публикации, тип медиа и ссылку на него, подпись автора, источник пересылки, ссылку на ответ, превью ссылки и реакции с количеством.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка на одно сообщение публичного канала для
post_detail: https://t.me/<channel>/<message ID>. Ссылки t.me/s/ тоже подходят.
Как использовать API Telegram
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"telegram","action":"channel_posts","params":{"username":"<username>"}}'
Вопросы об API Telegram
Какие данные можно получить через API Telegram?
Укажите в platform значение telegram. В текущем каталоге: публикации канала, профили, поиск, группа, участники и more. Эти названия действий соответствуют разным объектам или представлениям Telegram; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса channel_posts к платформе Telegram?
Публичный канал или группа в формате name, @name, t.me/name или t.me/s/name. Используется в channel_posts и profile для публичных каналов, в group для метаданных публичной сущности и в members для получения видимых участников группы. Приватные ссылки-приглашения не поддерживаются, полный список участников не гарантируется. Передайте это значение в поле username объекта params.
Какие поля может вернуть channel_posts на платформе Telegram?
Объявленная схема включает channel_username, channel_title, text и view_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Telegram возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.