· 3 min read

WhatsApp Bulk Number Checker Deep API

Check global phone numbers for WhatsApp accounts and retrieve detailed demographic information including gender, age, hair color, and profile picture analysis.

Check the demographics and profile attributes of global phone numbers on WhatsApp including gender, age, and profile picture analysis.

API URL

POST https://api.ekycpro.com/wa/api/deep/tasks

Main Features

The WhatsApp Bulk Number Checker Deep API offers powerful analytical capabilities:

Demographic Analysis

The API provides detailed demographic information from profile pictures, including:

  • Gender detection
  • Age estimation
  • Hair color analysis
  • Skin color detection

Profile Attributes

Comprehensive profile information including:

  • WhatsApp account status verification
  • Profile picture URL retrieval
  • Profile picture type classification
  • Account verification status

Bulk Processing

Process multiple numbers simultaneously through file upload, making it efficient for large-scale analysis.

Usage Steps

File Upload

Upload a text file containing phone numbers in E.164 format:

Request Example

curl --location 'https://api.ekycpro.com/wa/api/deep/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'user_id="USER_ID"' \
--form 'file=@"input.txt"'

Request Parameters

ParameterDescription
user_idstring, User ID
filefile, Upload file, each line should contain one phone number in E.164 format

Status Checking

Monitor the processing status of your task:

curl --location 'https://api.ekycpro.com/wa/api/deep/tasks/{TASK_ID}?user_id=USER_ID' \
--header 'X-API-Key: API-KEY'

Response Examples

Task Creation Response

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Processing Status Response

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Completed Task Response

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

WhatsApp Number Check Result Fields

FieldDescriptionExample
NumberPhone number in E.164 format+41798284651
ageEstimated age range based on profile picture25
avatarURL of WhatsApp profile picturehttps://checknumber.ai/avatar.jpg
categoryType classification of profile pictureindividual portrait, pet avatar, object, etc.
genderGender detected from profile picturemale, female
hair_colorHair color detected from profile pictureblack, brown, blonde, etc.
skin_colorEthnicity/race detected from profile picturewhite, black, etc.
whatsappWhether number has active WhatsApp accountyes, no

API Response Format

FieldDescription
created_atTimestamp when task was created
updated_atTimestamp of last task status update
task_idUnique task identifier
user_idID of user
statusTask status: pending/processing/completed/exported
totalTotal phone numbers processed
successNumbers successfully identified
failureNumbers that failed processing
result_url(Optional) Download URL for results when status is exported

Status Codes

StatusDescription
200charge, Request successful, task created or status retrieved
400free, Bad request, invalid parameters or file format
500free, Internal server error, retry later

Integration Notes

  1. Each line in the input file should contain one phone number in E.164 format.

  2. Monitor task status using the provided task_id.

  3. Download results from the result_url when status is “exported”.

  4. Handle different status codes appropriately in your application.

FAQ

1. What is the processing capacity of the API?

The API can handle large batches of numbers efficiently, with real-time status updates on processing progress.

2. What format should the input file be in?

The input file should be a text file with one phone number per line in E.164 format (e.g., +41798284651).

3. How accurate is the demographic analysis?

The demographic analysis is based on advanced AI processing of profile pictures and provides estimates for age, gender, and other attributes when available.

4. What are the API response status codes?

The API uses standard HTTP status codes to indicate success or failure:

  • 200: Successful request (charged)
  • 400: Invalid parameters or file format (free)
  • 500: Internal server error (free)
5. What is the pricing for the API?

The price is $6 USD per 10,000 numbers. This API response information includes:

  • WhatsApp account status verification
  • Gender detection
  • Age estimation
  • Profile picture type analysis
  • Ethnicity detection
  • Hair color analysis

For more information about pricing and higher volume processing, please contact us.

Back to Blog

Related Posts

View All Posts »