Pricing

Rating

Developer

Actor stats

Categories

Share

WhatsApp Profile Avatar, Age & Gender API

Check WhatsApp phone numbers in bulk and enrich profiles with avatar-based signals.

The actor processes 100 to 10,000 unique numbers per real run. Larger inputs are deduped, then trimmed to the first 10,000 unique normalized numbers. It returns WhatsApp presence, avatar URL, avatar analysis status, estimated age, inferred gender, image category, hair color, and skin tone.

Age, gender, hair color, and skin tone are inferred from profile images. Treat them as enrichment signals, not verified demographic facts.

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 100 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.

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

Pricing

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

Current planned rates per 1,000 analyzed numbers:

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.