Методология проверки
Как AvatarLookup проверяет аватар аккаунта
AvatarLookup отвечает на один вопрос за проверку: есть ли у этого аккаунта пригодный аватар. На этой странице описаны два продукта реального времени, значение каждого поля, форматы идентификаторов и границы достоверности результата.
Проверено 18 сентября 2026 г.
Что происходит во время проверки аватара?
Вы отправляете один идентификатор — номер для WhatsApp или email для продукта email, — и в том же HTTP-ответе возвращаются три поля: registered, avatar и avatar_url. Без опроса и без обратных вызовов. Результат описывает состояние, полученное в тот момент, и ничего более.
Выполните одну проверку
Этот раздел посвящён продуктам реального времени: панель и синхронные эндпоинты REST используют один сервис проверки и одинаковое значение ответа. Целые списки проходят через асинхронную массовую проверку, описанную в конце этой страницы.
- 1
Выберите источник
service_type=ws_profile принимает номер. service_type=email_profile принимает email и охватывает Gmail, Yandex и Mail.ru в одном продукте.
- 2
Отправьте один идентификатор
Один на запрос или до 100 в одном синхронном множественном запросе. Весь пакет использует один service_type.
- 3
Прочитайте три поля
registered, avatar и avatar_url. Если нужно актуальное состояние, запустите новую проверку — аватары меняются.
Какой формат идентификатора отправлять
Каждый продукт принимает ровно одну форму идентификатора. Идентификатор в неверной форме отклоняется до списания средств.
- WhatsApp: один номер в формате E.164 — знак плюс, код страны, затем номер абонента без пробелов и разделителей.
- Email: один полный адрес. Принимаются только домены Gmail, Yandex и Mail.ru; любой другой домен отклоняется до списания, потому что его не охватывает ни один вышестоящий сервис.
- Национальные форматы номеров с ведущими нулями, пробелами, дефисами или скобками не принимаются. Отклонённый формат — это не результат «нет аватара».
Что означают три поля?
Они отвечают на три разных вопроса, и их нельзя сводить к одному. У несуществующего аккаунта не может быть аватара, но у существующего аккаунта его тоже может не быть — это разные результаты, и оплачиваются они одинаково.
- registered — есть ли у идентификатора аккаунт на этой платформе.
- avatar — установлен ли у этого аккаунта аватар. False — это результат, а не сбой.
- avatar_url — адрес изображения, если avatar равно true, в противном случае пустая строка. Он указывает на собственный CDN платформы и может перестать работать по её графику, поэтому воспринимайте его как ссылку, а не как архив.
Используйте результат в пределах его назначения
Проверка отражает состояние на момент запроса. Это не верификация личности и не разрешение с кем-либо связываться.
- Аватар не подтверждает, кому принадлежит аккаунт, используется ли он и читает ли его кто-нибудь.
- Аватары добавляются, меняются и удаляются в любое время. Результат, сохранённый в прошлом месяце, — это запись о том моменте, а не о сегодняшнем дне.
- Проверяемому аккаунту ничего не отправляется.
Целые списки: асинхронный вариант
Множественный эндпоинт реального времени подходит для большинства списков. Для более крупных отправьте весь файл как одну асинхронную массовую задачу — это также единственный способ охватить платформы без продукта реального времени (Telegram, Viber, LINE, MAX, Zalo).
- Загрузите .txt или .csv с одним идентификатором на строку — на странице массовой проверки или через API.
- Для продуктов по номерам телефонов при загрузке нужно выбрать страну; для продуктов по именам пользователей и email — не нужно.
- При отправке баланс резервируется под допустимые строки, списание производится только за идентификаторы, по которым получен результат, а разница возвращается.
- Задача выполняется в фоне; после завершения скачайте CSV с результатом. За неудавшуюся задачу средства возвращаются полностью.