WhatsApp Profile Avatar API - Age & Gender

From Clearpath, creators of the WhatsApp Number Validator, WhatsApp Chat Export and WhatsApp Live Messages.

Why choose this actor?

Check WhatsApp presence and get available profile photos together. Receive hasWhatsapp, hasAvatar and avatarUrl alongside the normalized phone number and check time. Photo availability varies by account; a WhatsApp account does not always return an avatar.

Process up to 10,000 unique numbers per run. Paste a list or upload CSV/Excel. The actor detects common phone columns, normalizes numbers and removes duplicates. Real runs require at least 500 unique numbers; larger lists are trimmed to the first 10,000 after duplicate removal.

Keep the output connected to your original list. Results include the original input, normalized number, country code and format check. Export JSON, CSV or Excel, or use onlyWhatsappUsers to keep WhatsApp matches in the output. That filter does not reduce the number of billable checks.

Preview the output first

{
  "testMode": true
}

Open actor input with Test Mode enabled to view sample records without looking up real numbers. This demonstrates the output format, not the results for your list.

For a real run, disable testMode and provide 500–10,000 unique numbers through phoneNumbers or a CSV/XLSX upload. Use defaultCountryCode for numbers without a leading country code. See current pricing for per-number charges.

Clearpath · WhatsApp Suite
Profiles You are here	Validator Number checks	Chat Export History & media	Live Messages Webhook delivery	Status Export Status media

Copy to your AI assistant

Copy this block into ChatGPT, Codex, Cursor, or any LLM to start using this actor.

clearpath/whatsapp-profile-avatar-age-gender-api on Apify. Call: ApifyClient("TOKEN").actor("clearpath/whatsapp-profile-avatar-age-gender-api").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: testMode (boolean sample output), phoneNumbers (array of phone numbers) or csvFile (CSV/XLSX upload URL or key), defaultCountryCode (prepend country code for numbers without +), onlyWhatsappUsers (boolean filter). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~whatsapp-profile-avatar-age-gender-api/builds/default (Bearer TOKEN) → inputSchema (JSON string, parse it), actorDefinition.storages.dataset.views.overview.transformation.fields (output field list), readme. Real runs require testMode=false and at least 500 unique normalized numbers; inputs above 10,000 unique numbers are trimmed to the first 10,000 after dedupe. Get token: https://console.apify.com/account/integrations

Quick Start

Preview sample output without charges:

{
  "testMode": true,
  "phoneNumbers": ["+14155552671"]
}

Analyze a direct list:

{
  "testMode": false,
  "phoneNumbers": [
    "+14155552671",
    "+442071234567"
  ],
  "onlyWhatsappUsers": false
}

Upload CSV/XLSX and apply a default country code:

{
  "testMode": false,
  "csvFile": "uploaded-file.csv",
  "defaultCountryCode": "1",
  "onlyWhatsappUsers": true
}

Input

For real runs, at least one of phoneNumbers or csvFile is required.

The actor is fully hosted on Apify. You provide phone numbers or an uploaded file; no extra credentials are required.

Parameter	Type	Description
testMode	boolean	Returns sample output without analyzing real numbers or charging credits.
phoneNumbers	array	Phone numbers with country code. Real runs require at least 500 unique numbers and process the first 10,000 after dedupe.
csvFile	string	Uploaded CSV or Excel file with phone numbers.
defaultCountryCode	string	Country code to prepend to numbers without a + prefix.
onlyWhatsappUsers	boolean	Output only numbers where hasWhatsapp is true.

Output

{
  "phoneNumber": "+14155552671",
  "originalInput": "+1 415 555 2671",
  "countryCode": "US",
  "isValidFormat": true,
  "hasWhatsapp": true,
  "hasAvatar": true,
  "avatarUrl": "https://placehold.co/128x128.jpg",
  "avatarAnalysisStatus": "analyzed",
  "estimatedAge": 34,
  "inferredGender": "female",
  "profileImageCategory": "individual_portrait",
  "hairColor": "black",
  "skinTone": "fair",
  "checkedAt": "2026-06-09T08:00:00Z"
}

Output Fields

Field	Description
phoneNumber	Normalized E.164 phone number.
originalInput	Original value supplied by the user.
countryCode	Detected country code.
isValidFormat	Whether the number has a 7-15 digit format.
hasWhatsapp	Whether the number has WhatsApp.
hasAvatar	Whether an analyzable avatar URL was returned.
avatarUrl	WhatsApp avatar image URL when available.
avatarAnalysisStatus	analyzed, no_avatar, not_on_whatsapp, or unknown.
estimatedAge	Inferred age from the profile image.
inferredGender	male, female, unknown, or null.
profileImageCategory	Inferred image category such as individual_portrait, group_photo, cartoon_avatar, or object.
hairColor	Inferred hair color from the profile image.
skinTone	Inferred skin color or tone from the profile image.
checkedAt	ISO timestamp of analysis.

Pricing

The actor uses pay-per-event pricing with one profile_analyzed event per analyzed number.

Current planned rates per 1,000 analyzed numbers:

Plan	Price per 1,000
No subscription / Bronze	$9.00 / $7.50
Silver	$6.00
Gold and above	$4.50

Duplicates are removed before analysis, so you pay for unique numbers analyzed.

Notes

• Rows without an analyzable profile image are mapped to avatarAnalysisStatus = no_avatar.
• Unknown result values are normalized to unknown or null.
• Uploaded CSV/XLSX files can use common phone columns such as phone, mobile, telephone, or whatsapp.
• onlyWhatsappUsers filters output rows, but billing still applies to every analyzed number.

Related Actors

More from Clearpath (Email tools):

• Email Account Checker - Check emails for real account registration on Gmail, Outlook, Yahoo, iCloud, Mail.ru.
• Email Address Validator - Bulk email deliverability validation (syntax, MX, SMTP, catch-all, disposable).
• Email Finder & Verifier - Find and verify B2B email addresses by name and domain.