Массовый продукт tg_profile_batch

Профиль номера Telegram · массовая проверка

Загрузите номера: ID пользователя Telegram, имя пользователя, дни активности и URL аватара, а также возраст, пол и тон кожи, распознанные по аватару.

Дополнение для больших списков целиком — для нескольких идентификаторов проверка в реальном времени отвечает в том же запросе. Проверка в реальном времени →

Посмотреть контракт API Зарегистрироваться

Контракт API

Два шага: отправьте файл, затем проверьте задачу

Полная документация API Открыть ключи API

При отправке сразу возвращается id задачи; проверяйте задачу по этому id, и после успешного завершения ответ будет содержать ссылку для скачивания файла результата. Каждый запрос показан вместе со своим ответом.

1. Отправьте файл

id задачи возвращается сразу с preparing = true, пока файл подготавливается в фоне: некорректные строки, дубликаты и — для задач с номерами — номера без кода страны или из другой страны удаляются и не оплачиваются. Баланс резервируется за отправленные строки, а расчёт производится по завершении; разница возвращается.

Запрос cURLPOST /api/v1/bulk-tasks

curl -X POST "https://avatarlookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=tg_profile_batch \
  -F country=US \
  -F file=@numbers.txt

Ответ: задача создана200 OK

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_profile_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. Проверьте задачу

Опрашивайте по id задачи. После завершения подготовки submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, где total — количество проверяемых и оплачиваемых номеров. Успешный ответ содержит количество успешных и неудачных проверок и ссылку для скачивания файла результата; задача, отклонённая при подготовке, получает статус failed с reason_detail, и средства возвращаются полностью.

Запрос cURLGET /api/v1/bulk-tasks/{id}

curl "https://avatarlookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Ответ: задача завершена200 OK

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "tg_profile_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Как это работает

Что происходит с массовой задачей

Массовая проверка — это не увеличенная проверка в реальном времени, а схема «отправили один раз, выполняется в фоне, забрали позже». Держать страницу открытой не нужно: состояние задачи и результаты сохраняются в вашей панели.

01Загрузите файл
Файл .txt или .csv с одним номером на строку. Он передаётся потоком напрямую, ничего не записывается на диск.
02Предпроверка и резервирование
Очевидные проблемы (пустой файл, неверный формат, слишком мало строк) отклоняются при загрузке. Затем резервируется баланс, и файл подготавливается в фоне: удаляются дубликаты и некорректные строки, а также проверяется правило страны. Файл, не прошедший этот этап, завершается как неудавшаяся задача с полным возвратом средств; в противном случае проверяются только оставшиеся строки, а расчёт по задаче производится по её завершении.
03Выполнение в фоне
Задача выполняется самостоятельно — страницу можно закрыть. О сбое сообщается сразу, и средства возвращаются полностью.
04Скачайте результат
Заберите файл на странице массовой проверки. Вы платите только за записи, по которым действительно получен результат; разница возвращается.

Поля результата

Столбцы файла результата

Для скачивания предоставляется один файл CSV с полной таблицей результатов.

Столбцы файла результата

identifier · 17253100591 — Отправленный номер в виде цифр с кодом страны, без знака плюс и пробелов (например, 17253100591).
activated · true — Зарегистрирован ли номер в Telegram: true или false. Если значение не true, все остальные столбцы в этой строке остаются пустыми.
uid · 1234567890 — ID пользователя Telegram.
username · alex_kim — Имя пользователя; пусто, если у аккаунта его нет.
activedays · 9 — Сколько дней назад аккаунт был в сети в последний раз, целым числом — чем меньше, тем недавнее. Если аккаунт скрывает точное время последнего посещения, Telegram раскрывает только диапазон, и значение приблизительное: 0 (недавно), 7 (в течение недели), 30 (в течение месяца) или 1000 (давно).
avatar_url · https://telegram.waavatar.xyz/v/example.jpg — URL аватара; пусто, если у аккаунта нет аватара.
age · 31 — Возраст, оценённый по аватару; пусто, если оценить не удалось.
gender · male — Пол, оценённый по аватару: male или female; unknown, если распознать не удалось; пусто, если аватара нет.
skin_color · white — Тон кожи, оценённый по аватару, например white, asian, east_asian; unknown, если распознать не удалось; пусто, если аватара нет.

Лучше всего подходит для

Когда выбирать этот продукт

Сегментация списков

activatedactivedaysavatar_url

Группируйте номера Telegram по результату аккаунта, недавней активности и наличию аватара перед рассылкой или проверкой списка.

Пример: отдавайте приоритет активным аккаунтам с пригодным аватаром при работе с контактами.

Обогащение контактных данных

uidusernameavatar_url

Добавляйте ID Telegram, имена пользователей и ссылки на аватары к существующим контактам, чтобы команды быстрее узнавали и дедуплицировали записи.

Пример: превратите необработанный список телефонов в готовую таблицу профилей контактов.

Анализ аудитории

activedaysagegender

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

Пример: отделите недавно активные аккаунты от неактивных или неполных профилей.

Контроль качества профилей

avatar_urlagegenderskin_color

Используйте аватар и его оценённые атрибуты, чтобы выявлять записи, которые нуждаются в обогащении, проверке или осторожном обращении.

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

Краткий ответ

Что такое «Профиль номера Telegram» в массовом режиме?

Массовая проверка аватаров Telegram возвращает для каждого зарегистрированного номера ID пользователя, имя пользователя, дни активности, URL аватара и атрибуты, распознанные по аватару: возраст, пол и тон кожи. При загрузке выберите страну, к которой относятся номера.

Чёткие границы

Ограничения этого продукта

Результаты отражают момент выполнения задачи. Аватары меняются — для актуального состояния запустите задачу снова, сохранённые результаты автоматически не обновляются.
Это не проверка доступности или активности и не верификация личности.
Идентификаторам из файла ничего не отправляется.
Набор возвращаемых столбцов зависит от платформы. Они перечислены на этой странице до загрузки.
Ссылки для скачивания имеют ограниченный срок действия. Скачайте файл вскоре после завершения задачи; если ссылка истекла, проверьте задачу снова, чтобы получить новую.

Когда подходит массовая проверка

Когда массовая проверка оправдана, а когда быстрее проверка в реальном времени

	Проверка в реальном времени	Массовая проверка
Сколько идентификаторов	1 идентификатор на одиночную проверку; несколько — в множественном запросе, точные лимиты указаны в документации API	Большой список целиком в одной задаче — текущий диапазон размеров указан на странице цен
Получение результатов	Сразу: одиночный и множественный эндпоинты отвечают в том же ответе; панель возвращает результаты по одному	Скачайте файл с результатом после завершения задачи
Страна	Выбирать не нужно — проверки в реальном времени отправляются по одной, без группировки по странам	Одна страна на задачу — выбирается при загрузке и отправляется вместе с файлом
Формат результата	JSON, поля по каждой записи	Файл результата (один CSV с полной таблицей)
Типичное применение	Проверка форм, запросы операторов, контроль перед отправкой	Очистка списков, фильтрация перед кампанией, очистка сохранённых данных

Проверка в реальном времени · Посмотреть цены

FAQ по продукту

О продукте «Профиль номера Telegram»

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

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

Что происходит с недопустимыми идентификаторами в файле?

Предпроверка отбрасывает некорректные строки, поэтому они не попадают в оплачиваемое количество. Из оставшихся номеров те, которые вышестоящий сервис не смог определить, тоже не оплачиваются. Вы платите только за номера, по которым действительно получен результат.

Сколько времени занимает задача?

Зависит от количества записей и продукта. После отправки страницу можно закрыть: задача выполняется в фоне, а результат будет ждать вас на странице массовой проверки.

Вернутся ли средства, если задача не удалась?

Да. За неудавшуюся задачу средства возвращаются полностью. Если задача выполнена, но по части записей ничего не получено, эта часть возвращается автоматически. Разница между зарезервированной и фактически списанной суммой всегда возвращается.

Похожие продукты

Другие массовые продукты

Анализ аватаров WhatsApp · массовая проверкаЗагрузите целый файл номеров: URL аватара WhatsApp и что изображено на аватаре — категория, возраст, пол, тон кожи и цвет волос.

Профиль имени пользователя Telegram · массовая проверкаЗагрузите имена пользователей Telegram: ID пользователя, дни активности и URL аватара для каждого аккаунта.

Профиль номера Viber · массовая проверкаЗагрузите номера: ID участника Viber, дни активности и URL аватара, а также категория, возраст, пол и тон кожи, распознанные по аватару.

Профиль номера MAX · массовая проверкаЗагрузите номера: ID пользователя MAX, URL аватара и пол.

Анализ аватаров LINE · массовая проверкаЗагрузите номера: ID пользователя LINE и URL аватара, а также категория, возраст, пол, тон кожи и цвет волос, распознанные по аватару.

Профиль номера Zalo · массовая проверкаЗагрузите номера: ID пользователя Zalo и URL аватара, а также категория, возраст, пол и тон кожи, распознанные по аватару.

Проверка аватаров email · массовая проверкаЗагрузите адреса Gmail, Yandex или Mail.ru: доставляем ли каждый из них и его аватар.

Создайте аккаунт, чтобы отправить массовую задачу

Массовые проверки и проверки в реальном времени расходуют один баланс — ничего дополнительно включать не нужно. Зарегистрируйтесь и загрузите первый файл на странице массовой проверки.

Зарегистрироваться Посмотреть цены

Профиль номера Telegram · массовая проверка

Два шага: отправьте файл, затем проверьте задачу

1. Отправьте файл

2. Проверьте задачу

Что происходит с массовой задачей

01Загрузите файл

02Предпроверка и резервирование

03Выполнение в фоне

04Скачайте результат

Столбцы файла результата

Столбцы файла результата

Когда выбирать этот продукт

Сегментация списков

Обогащение контактных данных

Анализ аудитории

Контроль качества профилей

Что такое «Профиль номера Telegram» в массовом режиме?

Ограничения этого продукта

Когда массовая проверка оправдана, а когда быстрее проверка в реальном времени

О продукте «Профиль номера Telegram»

Другие массовые продукты

Создайте аккаунт, чтобы отправить массовую задачу