AvatarLookup

service_type email_avatar

Email Avatar Profile

Check whether an email account has a public avatar and read its portrait attributes. Covers Gmail, Yandex and Mail.ru.

Usage cost: $0.004 per checkResponse mode: SynchronousPOST /api/v1/check
View API contractSign Up
Email Avatar Profile
Public demo

No sign-in required. Daily demo limits apply.

Create an account for SaaS dashboard and REST API access

API contract

One request, immediate result

Read full API docs Open API Keys

Send one email address and select this product with service_type. Authentication uses your API key.

Copy the curl command below and replace only the example API key with your own.

cURL requestPOST /api/v1/check
curl -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_avatar", "identifier": "alex.kim@gmail.com" }'
Response200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "identifier": "alex.kim@gmail.com",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://lh3.googleusercontent.com/a/example",
    "provider": "gmail",
    "extra": {
      "profile_available": "true",
      "category": "individual portrait",
      "gender": "male",
      "age": "39",
      "skin_color": "white",
      "hair_color": "brown"
    }
  }
}

Use the result well

Three details that make a single check useful

  1. Send one complete identifier

    A phone number in E.164 form (a plus sign, the country code, then the number) for WhatsApp, or a full email address for the email product.

  2. Read three fields, not one

    registered says whether the account exists, avatar says whether it publishes a photo, avatar_url carries the image. All three come back on every successful lookup.

  3. Fetch the image yourself

    avatar_url points at the platform's own CDN and may expire on their schedule. Treat it as a pointer: download or cache the image if you need to keep it.

What it checks

What does Email Avatar Profile return?

Returned fields

  • registered · boolean — Whether an account exists at that provider.
  • avatar · boolean — Whether a public avatar is set.
  • avatar_url · string — URL of the public avatar; empty string when no avatar is set.
  • provider · string — Mailbox provider resolved from the domain: gmail, yandex or mailru.
  • extra.profile_available · boolean — Whether portrait attributes were produced this time. Read it together with avatar: false/false means there is no avatar to analyse, true/false means the avatar could not be recognized.
  • extra.category · string — What the picture is: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar or object.
  • extra.gender · string — male, female or unknown.
  • extra.age · number — Estimated age, accurate to about 3 years and clamped to 0-80. Empty when no gender was determined — there is no placeholder number.
  • extra.skin_color · string — Descriptive skin tone, for example white, east_asian or hispanic. Treat it as an open set.
  • extra.hair_color · string — Descriptive hair colour, for example black, brown, blond or gray white. Treat it as an open set.

Best for

Use this product when you need

  • Contact card enrichment
  • CRM avatar backfill
  • Mailing list review
  • Account data cleanup

Direct answer

What is Email avatar?

Email Avatar Profile returns whether the account has a public avatar, and the image URL when it does. Use service_type email_avatar (the parameter that selects a product) with one email address, for example alex.kim@gmail.com, and read the extra object in the same API response.

Clear boundaries

What it does not return

  • It reports what the platform publishes right now. An avatar can be added, changed or removed at any time — re-run the lookup when the decision needs a current state.
  • It is not a reachability or activity check: an avatar says nothing about whether the account is in use, online, or able to receive anything.
  • Nothing is sent to the account being looked up, and the result is not identity verification, proof of ownership, or consent to be contacted.

Product FAQ

Questions about Email avatar

What does Email Avatar Profile check?

It checks one identifier and returns whether the account has a public avatar, and the image URL when it does in the same synchronous response.

How does billing work for Email avatar?

Balance is charged only for completed checks. Failed or undetermined checks do not keep the charge.

What phone number format is required?

Submit the identifier the product accepts: a phone number in E.164 form for WhatsApp, or a full email address for the email product. Sending the wrong form is rejected before any charge.

Does an avatar result tell me the number is reachable?

No. It only reports whether the platform publishes an avatar at that moment. It says nothing about whether the account is in use or online, and it is not permission to contact anyone. Consent and applicable rules remain your responsibility.

Related products

Choose the right product

ws_avatarWhatsApp Avatar ProfileCheck whether a phone number has a public WhatsApp avatar, get the image URL, and read the portrait attributes of that avatar.image_profileImage ProfileUpload any picture and get its portrait attributes: estimated age, gender, image type, hair colour and skin tone.

Start checking now

Create an account to use every product from the SaaS dashboard or the API: realtime checks and async bulk checks draw on the same balance.

Sign Up View pricing