WhatsApp Avatar Recognition

Analyze the uploaded avatar images and provide a detailed analysis, the analysis of a single image and includes the following fields: Gender, Age Range, Age, Category.

Code example:

curl --location 'https://api.checknumber.ai/v1/whatsapp/avatar' \
--header 'X-API-Key: API-KEY' \
--form 'number="PHONE_NUMBER"' \

Response for the recognition result

[{
    "age": 17,
    "age_range": "teenager",
    "category": "cartoon avatar",
    "gender": "male"
}, {
    "age": 0,
    "age_range": "unidentifiable",
    "category": "landscape",
    "gender": "unidentifiable"
}]

Response for the requested image can not download

{
    "status": "400",
    "message": "no image"
}

Response for inner error

{
    "status": "500",
    "message": "no response"
}

HTTP request

POST https://api.checknumber.ai/v1/whatsapp/avatar

Request parameters

parameter	description
`images`	`array`, a list of objects containing image URLs to be analyzed. Each object should have an `image_url` key with the URL of the image as its value.
`image_url`	`string`, the URL of the image to be analyzed. Each URL should point to an accessible image resource online.

Response format

fields	description
`age_range`	Estimated age range of the person in the photo. Possible values include: “child”, “teenager”, “adult”, “middle-aged”, or “elderly”.
`age`	Estimated specific age of the person in the photo as an integer.
`gender`	Identified gender of the person in the photo. Possible values: “male”, “female”, or “unidentifiable”.
`category`	Classified type of avatar based on its content. Possible values include: “individual portrait”, “group photo”, “game avatar”, “cartoon avatar”, “landscape”, “pet avatar”, or other appropriate categories.

Status code

status	description
`200`	`charge`, recognition result
`400`	`free`, no image
`500`	`free`, no response