service_type email_profile
Проверьте, есть ли у почтового аккаунта аватар, и получите атрибуты портрета. Поддерживаются Gmail, Yandex и Mail.ru.
POST /api/v1/checkАнализ аватаров emailВход не требуется.
Контракт API
Отправьте один email и выберите этот продукт с помощью service_type. Для аутентификации используется ваш ключ API.
Скопируйте команду curl ниже и замените только пример ключа API на свой.
POST /api/v1/checkcurl -X POST "https://avatarlookup.com/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "email_profile", "identifier": "alex.kim@gmail.com" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "email_profile",
"identifier": "alex.kim@gmail.com",
"registered": true,
"avatar": true,
"avatar_url": "https://lh3.googleusercontent.com/a/example",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}Как использовать
Номер в формате E.164 (знак плюс, код страны, затем номер) для WhatsApp или полный email для продукта email.
registered показывает, существует ли аккаунт (для адреса email — доступен ли он), avatar — установлен ли аватар, avatar_url содержит изображение. Все три поля возвращаются при каждой успешной проверке.
avatar_url указывает на собственный CDN платформы и может перестать работать по её графику. Воспринимайте его как ссылку: скачайте или кэшируйте изображение, если его нужно сохранить.
Что проверяется
registered · boolean — Доступен ли адрес email (может ли он получать почту).avatar · boolean — Установлен ли аватар.avatar_url · string — URL аватара; пустая строка, если аватар не установлен.category · string — Что изображено: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar или object. unknown, если получить портрет не удалось.age · integer — Оценка возраста целым числом с точностью примерно до 3 лет, в диапазоне 0–80. Отсутствует, если оценить не удалось (например, когда не определён пол).gender · string — male, female или unknown.skin_color · string — Описательный тон кожи, например white, east_asian или hispanic. Считайте набор значений открытым; unknown, если не определено.hair_color · string — Описательный цвет волос, например black, brown, blond или gray white. Считайте набор значений открытым; unknown, если не определено.Лучше всего подходит для
Добавляйте состояние аватара и URL изображений к почтовым контактам, чтобы списки клиентов и переписку было проще узнавать.
Обрабатывайте адреса Gmail, Yandex и Mail.ru в одном процессе, затем записывайте данные аватаров в существующие записи клиентов.
При упорядочивании списков email различайте существование аккаунта, наличие аватара и то, получен ли полный результат, — для дополнения данных и ручной проверки.
Находите записи без аватара, без однозначного результата или с неподдерживаемым сервисом, чтобы информация о клиентах оставалась согласованной.
Краткий ответ
Анализ аватаров email возвращает сведения о том, есть ли у аккаунта аватар, и URL изображения, если он есть. Укажите service_type email_profile (параметр, выбирающий продукт) и один email, например alex.kim@gmail.com, и прочитайте атрибуты портрета на верхнем уровне того же ответа API.
Чёткие границы
FAQ по продукту
Он проверяет один идентификатор и возвращает сведения о том, есть ли у аккаунта аватар, и URL изображения, если он есть в том же синхронном ответе.
Баланс списывается только за завершённые проверки. За неудачные или неопределённые проверки средства не удерживаются.
Отправляйте идентификатор, который принимает продукт: номер в формате E.164 для WhatsApp или полный email для продукта email. Идентификатор в неверном формате отклоняется до списания средств.
Нет. Он лишь сообщает, установлен ли аватар в данный момент. Он ничего не говорит о том, используется ли аккаунт и в сети ли он, и не даёт разрешения с кем-либо связываться. Согласие и соблюдение применимых правил остаются вашей ответственностью.
Похожие продукты
Создайте аккаунт, чтобы пользоваться всеми продуктами из панели SaaS или через API: проверки в реальном времени и асинхронные массовые проверки расходуют один и тот же баланс.
