AvatarLookup

product image_profile

Image Profile

Upload any picture and get its portrait attributes: estimated age, gender, image type, hair colour and skin tone.

Usage cost: $0.002 per checkResponse mode: SynchronousPOST /api/v1/image/profile
View API contractSign Up

API contract

One request, immediate result

Read full API docs Open API Keys

Upload one picture as a multipart file field named file. Authentication uses your API key.

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

cURL requestPOST /api/v1/image/profile
curl -X POST "https://avatarlookup.com/api/v1/image/profile" \
  -H "X-API-Key: sk_your_api_key" \
  -F "file=@avatar.jpg"
Response200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "product": "image_profile",
    "identifier": "img:7013df96c540904a4b7ba295e9162ab2",
    "extra": {
      "category": "individual portrait",
      "gender": "male",
      "age": "39",
      "skin_color": "white",
      "hair_color": "brown"
    }
  }
}

Use the result well

Three details that make one picture worth submitting

  1. Send the picture itself

    One image per request, as a multipart file field named file. JPEG, PNG, WebP or GIF, up to 2 MB. There is no phone number or email address involved — the answer describes the picture, not an account.

  2. Read category before the rest

    category tells you what the picture is. Pictures of pets, cartoons, landscapes or objects are recognized and charged, but they carry no age and no gender — that is a result, not a failure.

  3. We do not keep the picture

    The image is passed straight to recognition and never stored. identifier is a fingerprint derived from the picture's content, so the same picture always yields the same value — use it to deduplicate on your side.

What it checks

What does Image Profile return?

Returned fields

  • identifier · string — Fingerprint of the submitted picture, derived from its content. The same picture always yields the same value.
  • 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

  • Existing avatar archives
  • Audience profiling
  • Content moderation triage
  • Data enrichment

Direct answer

What is Image profile?

Image Profile returns the picture's own attributes: image type, gender, estimated age, skin tone and hair colour. Post one picture to the image endpoint as a multipart file field named file, and read the extra object in the same API response. No identifier is involved.

Clear boundaries

What it does not return

  • It describes the picture, not a person or an account: there is no registration, reachability or identity claim in the result.
  • Age, gender, skin tone and hair colour are algorithmic estimates from a single image. Treat them as supporting signals only — never as the basis for identity verification, discriminatory filtering, or any high-stakes decision.
  • Pictures with no human subject still return a result and are still charged. Only a picture that cannot be read at all is free.

Product FAQ

Questions about Image profile

What does Image Profile return?

It returns the picture's own attributes: image type, gender, estimated age, skin tone and hair colour, in the same synchronous response.

How does billing work for Image profile?

Balance is charged for every picture that comes back with a result, including pets, cartoons and landscapes. Only a picture that cannot be read at all is not charged.

What image formats and sizes are accepted?

JPEG, PNG, WebP or GIF, up to 2 MB per picture. The type is decided from the file's own content, not its extension.

Do you store the picture?

No. The image is passed straight to recognition and never written to disk or object storage. Only the fingerprint derived from its content is kept on the check record.

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.email_avatarEmail Avatar ProfileCheck whether an email account has a public avatar and read its portrait attributes. Covers Gmail, Yandex and Mail.ru.

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