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, required): WhatsApp number (digits only, 8–15). Example: 5511999999999

Output

Two output formats are supported:

1. API format (default):

{
  "status": 200,
  "message": "OK",
  "data": {
    "phone": "5511999999999",
    "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": "5511999999999",
    "timestamp": "2025-09-26T12:45:44.389Z",
    "cost": 0.01
  }
}

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

[
  {
    "phone": "5511999999999",
    "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 logs a nominal $0.01 per request (using a minimum compute-unit usage) for auditing. Adjust according to your actual billing model.

Support

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