Whatsapp Scraper Profile By Number

Apify actor that fetches a WhatsApp profile by phone number and returns profile data, including the profile picture as BASE64 (without the data: prefix). Results are also saved to the run's Dataset.

For each run, the actor:

• Validates the provided phone number.
• Calls the backend API and normalizes the response.
• Downloads the profile picture (when available) and converts it to BASE64 (without data:image/...;base64,).
• Returns the final JSON and saves the results to the Dataset (and to the OUTPUT store).

Input

Minimal input (Apify UI):

• number (string, optional): WhatsApp number (digits only, 8–15). Example: 5579999393233
• numbers (array, optional): bulk list in the form input.
• numbersFile (file, optional): upload a .csv, .xlsx, or .xls file directly in Apify UI.
• numbersFileColumnName (string, optional): choose the column name containing phone numbers.
• numbersFileColumnIndex (integer, optional): choose the 1-based column index containing phone numbers.

At least one of number, numbers, or numbersFile must be provided.

Output

Two output formats are supported:

1. API format (default):

{
  "status": 200,
  "message": "OK",
  "data": {
    "phone": "5579999393233",
    "about": "Hey there! I am using WhatsApp.",
    "is_business": false,
    "picture_url": "https://.../profile.jpg",
    "base64_image": "<BASE64-WITHOUT-PREFIX>",
    "image_size": 84478,
    "download_success": true
  },
  "metadata": {
    "request_type": "profile",
    "number_searched": "5579999393233",
    "timestamp": "2025-09-26T12:45:44.389Z",
    "cost": 0.01
  }
}

2. Array format (simplified) — set OUTPUT_FORMAT=array:

[
  {
    "phone": "5579999393233",
    "picture": "<URL-OR-BASE64-WITHOUT-PREFIX>",
    "isbiz": { "isbiz": "Not a Business Account" },
    "about": "Hey there! I am using WhatsApp."
  }
]

Picture (BASE64) notes:

• The image is returned without the data:image/...;base64, prefix for easier integration.
• When picture/picture_url is present, the actor downloads the image and adds base64_image to data.
• In array format, the picture field is populated in this order: picture → picture_url → base64_image.

Dataset and OUTPUT

• Results are stored in the run Dataset using pushData (single object or array).
• The final payload is also stored in the OUTPUT key-value store for API access.
• The Apify UI uses .actor/OUTPUT_SCHEMA.json to present helpful columns (status, phone, picture, etc.).

How to use

1. On Apify (recommended):

• Open the Actor page.
• In "Input", provide number.
• (Optional) Set OUTPUT_FORMAT=array to get the simplified array.
• (Optional) Set OUTPUT_MODE=stdout to print JSON only to stdout.
• Run the Actor and view results in Dataset and/or OUTPUT.

2. Locally (development):

• Node.js >= 16.
• Install dependencies: npm install in the python folder.
• Run node src/main.js.

Costs and limits

The actor charges $0.01 per profile search via Apify Pay-Per-Event (profile-search).

• Single request: Always charged for 1 search ($0.01)
• Bulk request: Charged for each number submitted, regardless of success or failure ($0.01 × count)

Support

If you need help adapting the output format, feel free to open an issue or contact the maintainer.